最新更新時間：2019.09.09 版本說明
普通服務商/電商平臺（不包括支付機構、銀行），可使用本接口，修改其進件且已簽約特約商戶/二級商戶的結算銀行賬戶。
1、本接口無需傳銀行開戶名稱參數(shù)。
① 若賬戶類型為“經營者個人銀行卡”，則系統(tǒng)自動拉取特約商戶的經營者姓名為開戶名稱。
② 若賬戶類型為“對公銀行賬戶”，則系統(tǒng)自動拉取特約商戶的公司名稱為開戶名稱。
2、API發(fā)起修改結算賬戶信息，校驗通過后，會即時生效新資料；
3、修改生效后，系統(tǒng)會自動匯款0.01元至新結算賬戶，驗證是否可正常使用。可通過 查詢結算賬戶API 查詢驗證結果
① 匯款驗證中，商戶可發(fā)起提現(xiàn)嘗試。
② 系統(tǒng)成功匯款，該賬戶可正常發(fā)起提現(xiàn)。
③ 系統(tǒng)匯款失敗，該賬戶無法發(fā)起提現(xiàn)，請檢查修改。
適用對象：普通服務商
請求URL：https://api.mch.weixin.qq.com/v3/apply4sub/sub_merchants/{sub_mchid}/modify-settlement
請求方式：POST
接口規(guī)則：http://www.tg885.com/wiki/doc/apiv3/wechatpay/wechatpay-1.shtml
path指該參數(shù)為路徑參數(shù)
query 指該參數(shù)需在請求URL傳參
body 指該參數(shù)需在請求JSON傳參
| 參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 特約商戶號 | sub_mchid | string[8,10] | 是 | path請?zhí)顚懕痉丈特撠熯M件的特約商戶號。 |
| 賬戶類型 | account_type | string[1,32] | 是 | body 根據特約商戶號的主體類型，可選擇的賬戶類型如下：
|
| 開戶銀行 | account_bank | string[1,128] | 是 | body 請?zhí)顚戦_戶銀行名稱，詳細參見《開戶銀行對照表》。 示例值：工商銀行 |
| 開戶銀行省市編碼 | bank_address_code | string[1,128] | 是 | body 需至少精確到市，詳細參見《省市區(qū)編號對照表》。 示例值：110000 |
| 開戶銀行全稱（含支行） | bank_name | string[1,128] | 否 | body
|
| 開戶銀行聯(lián)行號 | bank_branch_id | string[1,128] | 否 | body
|
| 銀行賬號 | account_number | string[1,128] | 是 | body 1、數(shù)字，長度遵循系統(tǒng)支持的對公/對私卡號長度要求 2、該字段需進行加密處理，加密方法詳見《敏感信息加密說明》。(提醒：必須在HTTP頭中上送Wechatpay-Serial) 示例值：d+xT+MQCvrLHUVDWv/8MR/dB7TkXM2YYZlokmXzFsWs35NXUot7C0NcxIrUF5FnxqCJHkNgKtxa6RxEYyba1+VBRLnqKG2fSy/Y5qDN08Ej9zHCwJjq52Wg1VG8MRugli9YMI1fI83KGBxhuXyemgS/hqFKsfYGiOkJqjTUpgY5VqjtL2N4l4z11T0ECB/aSyVXUysOFGLVfSrUxMPZy6jWWYGvT1+4P633f+R+ki1gT4WF/2KxZOYmli385ZgVhcR30mr4/G3HBcxi13zp7FnEeOsLlvBmI1PHN4C7Rsu3WL8sPndjXTd75kPkyjqnoMRrEEaYQE8ZRGYoeorwC+w== |
{
"account_type": "ACCOUNT_TYPE_BUSINESS",
"account_bank": "工商銀行",
"bank_address_code": "110000",
"bank_name": "施秉縣農村信用合作聯(lián)社城關信用社",
"bank_branch_id": "402713354941",
"account_number": "d+xT+MQCvrLHUVDWv/8MR/dB7TkXM2YYZlokmXzFsWs35NXUot7C0NcxIrUF5FnxqCJHkNgKtxa6RxEYyba1+VBRLnqKG2fSy/Y5qDN08Ej9zHCwJjq52Wg1VG8MRugli9YMI1fI83KGBxhuXyemgS/hqFKsfYGiOkJqE8ZRGYoeorwC+w=="
}
| 狀態(tài)碼 | 含義 | 描述 |
|---|---|---|
| 204 | No Content | 請求處理成功，無數(shù)據（Http狀態(tài)碼為204）。 |
?無數(shù)據（Http狀態(tài)碼為204）
| 錯誤碼 | 描述 | 解決方案 |
|---|---|---|
| SYSTEMERROR | 系統(tǒng)錯誤 | 系統(tǒng)異常，請使用相同參數(shù)稍后重新調用 |
| PARAM_ERROR | 參數(shù)錯誤 | 請使用正確的參數(shù)重新調用 |
| INVALID_REQUEST | 無效請求 | 請查看返回的錯誤信息，根據錯誤信息進行操作 |
| NOAUTH | 商戶權限異常 | 請確認是否已經開通相關權限 |