最新更新時間：2021.06.18 版本說明
服務商/電商平臺（不包括支付機構(gòu)、銀行），可使用本接口，查詢其進件且已簽約特約商戶/二級商戶的結(jié)算賬戶信息（敏感信息掩碼）。 該接口可用于核實是否成功修改結(jié)算賬戶信息、及查詢系統(tǒng)匯款驗證結(jié)果。
適用對象：服務商 電商平臺
請求URL：https://api.mch.weixin.qq.com/v3/apply4sub/sub_merchants/{sub_mchid}/settlement
請求方式：GET
path指該參數(shù)為路徑參數(shù)
query 指該參數(shù)需在請求URL傳參
body 指該參數(shù)需在請求JSON傳參
| 參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 特約商戶/二級商戶號 | sub_mchid | string[8,10] | 是 | path 請輸入本服務商進件、已簽約的特約商戶/二級商戶號。 |
https://api.mch.weixin.qq.com/v3/apply4sub/sub_merchants/1900006491/settlement
| 參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 賬戶類型 | account_type | string[1,32] | 是 | 返回特約商戶的結(jié)算賬戶類型。 枚舉值：
|
| 開戶銀行 | account_bank | string[1,128] | 是 | 返回特約商戶的結(jié)算賬戶-開戶銀行全稱。 示例值：工商銀行 |
| 開戶銀行全稱（含支行） | bank_name | string[1,128] | 否 | 返回特約商戶的結(jié)算賬戶-開戶銀行全稱（含支行）。 示例值：施秉縣農(nóng)村信用合作聯(lián)社城關(guān)信用社 |
| 開戶銀行聯(lián)行號 | bank_branch_id | string[1,128] | 否 | 返回特約商戶的結(jié)算賬戶-聯(lián)行號。 示例值：402713354941 |
| 銀行賬號 | account_number | string[1,128] | 是 | 返回特約商戶的結(jié)算賬戶-銀行賬號，掩碼顯示。 示例值：62*************78 |
| 匯款驗證結(jié)果 | verify_result | string[1,32] | 是 | 返回特約商戶的結(jié)算賬戶-匯款驗證結(jié)果。 VERIFYING：系統(tǒng)匯款驗證中，商戶可發(fā)起提現(xiàn)嘗試。 VERIFY_SUCCESS：系統(tǒng)成功匯款，該賬戶可正常發(fā)起提現(xiàn)。 VERIFY_FAIL：系統(tǒng)匯款失敗，該賬戶無法發(fā)起提現(xiàn)，請檢查修改。 注：該字段，入駐后若沒有修改過銀行卡，除非匯款失敗，否則是不返回的 示例值：VERIFY_SUCCESS |
| 匯款驗證失敗原因 | verify_fail_reason | string[1, 1024] | 否 | 如果匯款驗證成功為空，匯款驗證失敗為具體原因。 示例值：用戶姓名/證件/手機不匹配，請核對后重試 |
{
"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"
}
| 錯誤碼 | 描述 | 解決方案 |
|---|---|---|
| SYSTEMERROR | 系統(tǒng)錯誤 | 系統(tǒng)異常，請使用相同參數(shù)稍后重新調(diào)用 |
| PARAM_ERROR | 參數(shù)錯誤 | 請使用正確的參數(shù)重新調(diào)用 |
| INVALID_REQUEST | 無效請求 | 請查看返回的錯誤信息，根據(jù)錯誤信息進行操作 |
| NOAUTH | 商戶權(quán)限異常 | 請確認是否已經(jīng)開通相關(guān)權(quán)限 |