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