最新更新時(shí)間：2019.09.09 版本說(shuō)明
普通服務(wù)商/電商平臺(tái)（不包括支付機(jī)構(gòu)、銀行），可使用本接口，查詢其進(jìn)件且已簽約特約商戶/二級(jí)商戶的結(jié)算賬戶信息（敏感信息掩碼）。 該接口可用于核實(shí)是否成功修改結(jié)算賬戶信息、及查詢系統(tǒng)匯款驗(yàn)證結(jié)果。
適用對(duì)象：普通服務(wù)商
請(qǐng)求URL：https://api.mch.weixin.qq.com/v3/apply4sub/sub_merchants/{sub_mchid}/settlement
請(qǐng)求方式：GET
接口規(guī)則：http://www.tg885.com/wiki/doc/apiv3/wechatpay/wechatpay-1.shtml
path指該參數(shù)為路徑參數(shù)
query 指該參數(shù)需在請(qǐng)求URL傳參
body 指該參數(shù)需在請(qǐng)求JSON傳參
| 參數(shù)名 | 變量 | 類型[長(zhǎng)度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 特約商戶號(hào) | sub_mchid | string[8,10] | 是 | path 請(qǐng)輸入本服務(wù)商進(jìn)件、已簽約的特約商戶號(hào)。 |
https://api.mch.weixin.qq.com/v3/apply4sub/sub_merchants/1900006491/settlement
| 參數(shù)名 | 變量 | 類型[長(zhǎng)度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 賬戶類型 | account_type | string[1,32] | 是 | 返回特約商戶的結(jié)算賬戶類型。 枚舉值：
|
| 開(kāi)戶銀行 | account_bank | string[1,128] | 是 | 返回特約商戶的結(jié)算賬戶-開(kāi)戶銀行全稱。 示例值：工商銀行 |
| 開(kāi)戶銀行全稱（含支行） | bank_name | string[1,128] | 是 | 返回特約商戶的結(jié)算賬戶-開(kāi)戶銀行全稱（含支行）。 示例值：施秉縣農(nóng)村信用合作聯(lián)社城關(guān)信用社 |
| 開(kāi)戶銀行聯(lián)行號(hào) | bank_branch_id | string[1,128] | 是 | 返回特約商戶的結(jié)算賬戶-聯(lián)行號(hào)。 示例值：402713354941 |
| 銀行賬號(hào) | account_number | string[1,128] | 是 | 返回特約商戶的結(jié)算賬戶-銀行賬號(hào)，掩碼顯示。 示例值：62*************78 |
| 匯款驗(yàn)證結(jié)果 | verify_result | string[1,32] | 是 | 返回特約商戶的結(jié)算賬戶-匯款驗(yàn)證結(jié)果。
|
{
"account_type": "ACCOUNT_TYPE_BUSINESS",
"account_bank": "工商銀行",
"bank_name": "施秉縣農(nóng)村信用合作聯(lián)社城關(guān)信用社",
"bank_branch_id": "402713354941",
"account_number": "***************8678",
"verify_result": "VERIFY_SUCCESS"
}
| 錯(cuò)誤碼 | 描述 | 解決方案 |
|---|---|---|
| SYSTEMERROR | 系統(tǒng)錯(cuò)誤 | 系統(tǒng)異常，請(qǐng)使用相同參數(shù)稍后重新調(diào)用 |
| PARAM_ERROR | 參數(shù)錯(cuò)誤 | 請(qǐng)使用正確的參數(shù)重新調(diào)用 |
| INVALID_REQUEST | 無(wú)效請(qǐng)求 | 請(qǐng)查看返回的錯(cuò)誤信息，根據(jù)錯(cuò)誤信息進(jìn)行操作 |
| NOAUTH | 商戶權(quán)限異常 | 請(qǐng)確認(rèn)是否已經(jīng)開(kāi)通相關(guān)權(quán)限 |