服務(wù)商/電商平臺(tái)（不包括支付機(jī)構(gòu)、銀行），可使用本接口，修改其進(jìn)件且已簽約特約商戶/二級(jí)商戶的結(jié)算銀行賬戶。
注意：
1、2023年3月31日（含當(dāng)日）起，傳入“修改模式”的請(qǐng)求參數(shù)時(shí)，可啟用微信支付受理模式。2023年4月17日（含當(dāng)日）之后，無(wú)論是否傳入該參數(shù)，均按照受理模式執(zhí)行。
i. 非受理模式下：提交結(jié)算賬戶修改申請(qǐng)后，應(yīng)答代碼為“204”即代表銀行結(jié)算賬戶更新成功；
ii. 受理模式下：提交結(jié)算銀行賬戶修改申請(qǐng)后，應(yīng)答代碼為“200”且系統(tǒng)返回申請(qǐng)單號(hào)，需通過(guò)"查詢結(jié)算賬戶修改申請(qǐng)狀態(tài)API (opens new window)"查詢申請(qǐng)單處理結(jié)果。申請(qǐng)單狀態(tài)存在如下情況：
① 審核中：修改的銀行結(jié)算賬戶還在審核中、賬戶尚未生效，需繼續(xù)等待審核結(jié)果，在此期間無(wú)法再次提交修改申請(qǐng)；審核過(guò)程中，系統(tǒng)可能會(huì)向結(jié)算銀行賬戶付款0.01元進(jìn)行驗(yàn)證。
② 審核駁回：申請(qǐng)已駁回，請(qǐng)檢查駁回原因、并重新發(fā)起修改。
③ 審核成功：銀行結(jié)算賬戶更新成功。
2、如需查詢當(dāng)前生效中的銀行結(jié)算賬戶，請(qǐng)使用“查詢結(jié)算賬戶API (opens new window)”。
3、特約商戶/二級(jí)商戶每天僅能提交5次修改申請(qǐng)，如需繼續(xù)申請(qǐng)，請(qǐng)等到次日0點(diǎn)后重新發(fā)起。
4、修改結(jié)算銀行卡接口調(diào)用頻率限制：20/min。
# 接口說(shuō)明
# 請(qǐng)求參數(shù)
- Authorization 必填 string請(qǐng)參考 簽名認(rèn)證 生成認(rèn)證信息
- Accept 必填 string請(qǐng)?jiān)O(shè)置為
application/json - Content-Type 必填 string請(qǐng)?jiān)O(shè)置為
application/json - Wechatpay-Serial 必填 string【微信支付平臺(tái)證書序列號(hào)】 請(qǐng)求參數(shù)中的敏感字段，需要使用微信支付平臺(tái)證書公鑰加密。請(qǐng)?jiān)O(shè)置為該證書的證書序列號(hào)。詳見敏感信息加解密
- sub_mchid 必填 string(10)【特約商戶/二級(jí)商戶號(hào)】 請(qǐng)?zhí)顚懕痉?wù)商負(fù)責(zé)進(jìn)件的特約商戶/二級(jí)商戶號(hào)。
- modify_mode 選填 string【修改模式】 修改模式。2023年4月17日前，該參數(shù)為選填；2023年4月17日（含當(dāng)日）之后，無(wú)論是否傳入該參數(shù)，均按照受理模式執(zhí)行。
可選取值：MODIFY_MODE_ASYNC: 受理模式
- account_type 必填 string【賬戶類型】 根據(jù)特約商戶號(hào)/二級(jí)商戶號(hào)的主體類型，可選擇的賬戶類型如下：
1、小微主體：經(jīng)營(yíng)者個(gè)人銀行卡
2、個(gè)體工商戶主體：經(jīng)營(yíng)者個(gè)人銀行卡/ 對(duì)公銀行賬戶
3、企業(yè)主體：對(duì)公銀行賬戶
4、黨政、機(jī)關(guān)及事業(yè)單位主體：對(duì)公銀行賬戶
5、其他組織主體：對(duì)公銀行賬戶
可選取值：ACCOUNT_TYPE_BUSINESS: 對(duì)公銀行賬戶ACCOUNT_TYPE_PRIVATE: 經(jīng)營(yíng)者個(gè)人銀行卡
- account_bank 必填 string(128)【開戶銀行】 請(qǐng)?zhí)顚戦_戶銀行名稱。
對(duì)私銀行調(diào)用：查詢支持個(gè)人業(yè)務(wù)的銀行列表API
對(duì)公銀行調(diào)用：查詢支持對(duì)公業(yè)務(wù)的銀行列表API - bank_name 選填 string(128)【開戶銀行全稱（含支行）】 1、根據(jù)開戶銀行查詢接口中的“是否需要填寫支行”判斷是否需要填寫。如為其他銀行，開戶銀行全稱（含支行）和開戶銀行聯(lián)行號(hào)二選一。
2、詳細(xì)需調(diào)用查詢支行列表API查看查詢結(jié)果。 - bank_branch_id 選填 string(128)【開戶銀行聯(lián)行號(hào)】 1、根據(jù)開戶銀行查詢接口中的“是否需要填寫支行”判斷是否需要填寫。如為其他銀行，開戶銀行全稱（含支行）和開戶銀行聯(lián)行號(hào)二選一。
2、詳細(xì)需調(diào)用查詢支行列表API查看查詢結(jié)果。 - account_number 必填 string(1024)【銀行賬號(hào)】 1、數(shù)字，長(zhǎng)度遵循系統(tǒng)支持的開戶銀行對(duì)照表中對(duì)公/對(duì)私卡號(hào)長(zhǎng)度要求
2、該字段需進(jìn)行加密處理，加密方法詳見敏感信息加密說(shuō)明。(提醒：必須在HTTP頭中上送Wechatpay-Serial) - account_name 選填 string【開戶名稱】 1、不需要修改開戶名稱時(shí)，可以不填寫或填寫當(dāng)前綁定的結(jié)算銀行卡戶名；
2、支持將開戶名稱修改為當(dāng)前商戶對(duì)應(yīng)的主體名稱（對(duì)公銀行賬戶）或經(jīng)營(yíng)者名稱（個(gè)人銀行賬戶），支持修改開戶名稱中括號(hào)的全半角；
3、該字段需進(jìn)行加密處理，加密方法詳見敏感信息加密說(shuō)明。(提醒：必須在HTTP頭中上送Wechatpay-Serial)
請(qǐng)求示例
# 應(yīng)答參數(shù)
- application_no 必填 string(64)【修改結(jié)算賬戶申請(qǐng)單號(hào)】 提交二級(jí)商戶修改結(jié)算賬戶申請(qǐng)后，由微信支付返回的單號(hào)，作為查詢申請(qǐng)狀態(tài)的唯一標(biāo)識(shí)。
應(yīng)答示例
# 錯(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)參閱 簽名常見問(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)限操作 |
| 400 | INVALID_REQUEST | 無(wú)效請(qǐng)求 | 請(qǐng)根據(jù)接口返回的詳細(xì)信息進(jìn)行檢查 |
| 400 | INVALID_REQUEST | 你的開戶名稱與主體名稱不一致，請(qǐng)修改后重試 | 請(qǐng)修改為同名結(jié)算賬戶后重試。如商戶主體類型為企業(yè)/政府機(jī)關(guān)/事業(yè)單位/社會(huì)組織且需使用非同名結(jié)算賬戶時(shí)，可前往非同名銀行結(jié)算賬戶修改頁(yè)面 (opens new window)提交信息。如為托管子商戶，需通過(guò)服務(wù)商聯(lián)系對(duì)應(yīng)的微信支付行業(yè)運(yùn)營(yíng)協(xié)助處理。 |
| 429 | FREQENCY_LIMIT | 頻率超限 | 請(qǐng)求量不要超過(guò)接口調(diào)用頻率限制 |
