最新更新時間：2022.06.30 版本說明
服務商/電商平臺（不包括支付機構(gòu)、銀行），可使用本接口，修改其進件且已簽約特約商戶/二級商戶的結(jié)算銀行賬戶。
1、API發(fā)起修改結(jié)算賬戶信息，校驗通過后，會即時生效新資料；
2、修改生效后，系統(tǒng)會自動匯款0.01元至新結(jié)算賬戶，驗證是否可正常使用。可通過 查詢結(jié)算賬戶API 查詢驗證結(jié)果
① 匯款驗證中，商戶可發(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
path指該參數(shù)為路徑參數(shù)
query 指該參數(shù)需在請求URL傳參
body 指該參數(shù)需在請求JSON傳參
| 參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 特約商戶/二級商戶號 | sub_mchid | string[8,10] | 是 | path請?zhí)顚懕痉丈特撠熯M件的特約商戶/二級商戶號。 |
| 賬戶類型 | account_type | string[1,32] | 是 | body 根據(jù)特約商戶/二級商戶號的主體類型，可選擇的賬戶類型如下：
|
| 開戶名稱 | account_name | string[1,1024] | 條件選填 | body1、不需要修改開戶名稱時，可以不填寫或填寫當前綁定的結(jié)算銀行卡戶名； 2、支持將開戶名稱修改為當前商戶對應的主體名稱（對公銀行賬戶）或經(jīng)營者名稱（個人銀行賬戶），支持修改開戶名稱中括號的全半角； 3、該字段需進行加密處理，加密方法詳見敏感信息加密說明。(提醒：必須在HTTP頭中上送Wechatpay-Serial) VyOMa+SncfM4lLha65dsxZ/xYW1zqBVVp6/W5mNkolESJU9fqgMt0lxjtuiWdhR+qUjnC2dTfuJuCOZs/Qi6kmicogGFjDC9ZxzFpdjR7AidWDuCIId5WRnRN8lGUcVyxctZZ4WcxxL2ADq57h7dZoFxNgyRYR4Y6q37LpYDccmYO5SiCkUP3rMX1CrTwKJysVhHij62HiU/P/yScImgdKrc+/MBWb1O6TT2RgwU3U6IwSZRWx4QH4EmYBLAQTdcEyUz2wuDmPA4nMSeXJVyzKl/WB+QYBh4Yj+BLT0HkA2IbTRyGX1U2wvv3N/w59Xq0pWYSXMHlmxhle2Cqj/7Cw== |
| 開戶銀行 | account_bank | string[1,128] | 是 | body 請?zhí)顚戦_戶銀行名稱 對私銀行調(diào)用：查詢支持個人業(yè)務的銀行列表API 對公銀行調(diào)用：查詢支持對公業(yè)務的銀行列表API。 示例值：工商銀行 |
| 開戶銀行省市編碼 | bank_address_code | string[1,128] | 是 | body 需至少精確到市，詳細參見省市區(qū)編號對照表。 示例值：110000 |
| 開戶銀行全稱（含支行） | bank_name | string[1,128] | 條件選填 | body 1、根據(jù)開戶銀行查詢接口中的“是否需要填寫支行”判斷是否需要填寫。如為其他銀行，開戶銀行全稱（含支行）和開戶銀行聯(lián)行號二選一。 2、詳細需調(diào)用查詢支行列表API查看查詢結(jié)果。 示例值：中國工商銀行股份有限公司北京市分行營業(yè)部 |
| 開戶銀行聯(lián)行號 | bank_branch_id | string[1,128] | 條件選填 | body 1、根據(jù)開戶銀行查詢接口中的“是否需要填寫支行”判斷是否需要填寫。如為其他銀行，開戶銀行全稱（含支行）和開戶銀行聯(lián)行號二選一。 2、詳細需調(diào)用查詢支行列表API查看查詢結(jié)果。 示例值：402713354941 |
| 銀行賬號 | account_number | string[1,1024] | 是 | 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": "施秉縣農(nóng)村信用合作聯(lián)社城關(guān)信用社",
"bank_branch_id": "402713354941",
"account_number": "VyOMa+SncfM4lLha65dsxZ/xYW1zqBVVp6/W5mNkolESJU9fqgMt0lxjtuiWdhR+qUjnC2dTfuJuCOZs/Qi6kmicogGFjDC9ZxzFpdjR7AidWDuCIId5WRnRN8lGUcVyxctZZ4WcxxL2ADq57h7dZoFxNgyRYR4Y6q37LpYDccmYO5SiCkUP3rMX1CrTwKJysVhHij62HiU/P/yScImgdKrc+/MBWb1O6TT2RgwU3U6IwSZRWx4QH4EmYBLAQTdcEyUz2wuDmPA4nMSeXJVyzKl/WB+QYBh4Yj+BLT0HkA2IbTRyGX1U2wvv3N/w59Xq0pWYSXMHlmxhle2Cqj/7Cw=="
}
| 狀態(tài)碼 | 含義 | 描述 |
|---|---|---|
| 204 | No Content | 請求處理成功，無數(shù)據(jù)（Http狀態(tài)碼為204）。 |
?無數(shù)據(jù)（Http狀態(tài)碼為204）
| 錯誤碼 | 描述 | 解決方案 |
|---|---|---|
| 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)限 |