服務商/電商平臺（不包括支付機構、銀行），可使用本接口，查詢其進件且已簽約特約商戶/二級商戶當前的結(jié)算賬戶信息（敏感信息掩碼）和驗證結(jié)果。
# 接口說明
支持商戶：
【普通服務商】【平臺商戶】
請求方式：
【GET】/v3/apply4sub/sub_merchants/{sub_mchid}/settlement
請求域名：
【主域名】
https://api.mch.weixin.qq.com
使用該域名將訪問就近的接入點【備域名】
https://api2.mch.weixin.qq.com
使用該域名將訪問異地的接入點 ，指引點擊查看
# 請求參數(shù)
- Authorization 必填 string請參考 簽名認證 生成認證信息
- Accept 必填 string請設置為
application/json
Header HTTP頭參數(shù)
- sub_mchid 必填 string(10)【特約商戶/二級商戶號】 請輸入本服務商進件、已簽約的特約商戶/二級商戶號。
Path 路徑參數(shù)
請求示例
GET
# 應答參數(shù)
- account_type 必填 string【賬戶類型】 返回特約商戶的結(jié)算賬戶類型。
可選取值：ACCOUNT_TYPE_BUSINESS: 對公銀行賬戶ACCOUNT_TYPE_PRIVATE: 經(jīng)營者個人銀行卡
- account_bank 必填 string(128)【開戶銀行】 返回特約商戶的結(jié)算賬戶-開戶銀行全稱。
- bank_name 選填 string(128)【開戶銀行全稱（含支行）】 返回特約商戶的結(jié)算賬戶-開戶銀行全稱（含支行）。
- bank_branch_id 選填 string(128)【開戶銀行聯(lián)行號】 返回特約商戶的結(jié)算賬戶-聯(lián)行號。
- account_number 必填 string(128)【銀行賬號】 返回特約商戶的結(jié)算賬戶-銀行賬號，掩碼顯示。
- verify_result 必填 string【驗證結(jié)果】 返回特約商戶的結(jié)算賬戶-驗證結(jié)果。
可選取值：VERIFY_SUCCESS: 驗證成功，該賬戶可正常發(fā)起提現(xiàn)。VERIFY_FAIL: 驗證失敗，該賬戶無法發(fā)起提現(xiàn)，請檢查修改。VERIFYING: 驗證中，商戶可發(fā)起提現(xiàn)嘗試。
- verify_fail_reason 選填 string(1024)【驗證失敗原因】 如果驗證成功則為空，驗證失敗則為具體原因。
200OK
應答示例
200 OK
# 錯誤碼
# 公共錯誤碼
| 狀態(tài)碼 | 錯誤碼 | 描述 | 解決方案 |
|---|---|---|---|
| 400 | PARAM_ERROR | 參數(shù)錯誤 | 請根據(jù)錯誤提示正確傳入?yún)?shù) |
| 400 | INVALID_REQUEST | HTTP 請求不符合微信支付 APIv3 接口規(guī)則 | 請參閱 接口規(guī)則 |
| 401 | SIGN_ERROR | 驗證不通過 | 請參閱 簽名常見問題 |
| 500 | SYSTEM_ERROR | 系統(tǒng)異常，請稍后重試 | 請稍后重試 |
# 業(yè)務錯誤碼
| 狀態(tài)碼 | 錯誤碼 | 描述 | 解決方案 |
|---|---|---|---|
| 403 | NO_AUTH | 商戶權限異常 | 該商戶不是本服務商進件的子商戶，無權限操作 |
