服務(wù)商/電商平臺(不包括支付機構(gòu)、銀行),可使用本接口,修改其進件且已簽約特約商戶/二級商戶的結(jié)算銀行賬戶。
注意:
1、2023年3月31日(含當(dāng)日)起,傳入“修改模式”的請求參數(shù)時,可啟用微信支付受理模式。2023年4月17日(含當(dāng)日)之后,無論是否傳入該參數(shù),均按照受理模式執(zhí)行。
i. 非受理模式下:提交結(jié)算賬戶修改申請后,應(yīng)答代碼為“204”即代表銀行結(jié)算賬戶更新成功;
ii. 受理模式下:提交結(jié)算銀行賬戶修改申請后,應(yīng)答代碼為“200”且系統(tǒng)返回申請單號,需通過"查詢結(jié)算賬戶修改申請狀態(tài)API (opens new window)"查詢申請單處理結(jié)果。申請單狀態(tài)存在如下情況:
① 審核中:修改的銀行結(jié)算賬戶還在審核中、賬戶尚未生效,需繼續(xù)等待審核結(jié)果,在此期間無法再次提交修改申請;審核過程中,系統(tǒng)可能會向結(jié)算銀行賬戶付款0.01元進行驗證。
② 審核駁回:申請已駁回,請檢查駁回原因、并重新發(fā)起修改。
③ 審核成功:銀行結(jié)算賬戶更新成功。
2、如需查詢當(dāng)前生效中的銀行結(jié)算賬戶,請使用“查詢結(jié)算賬戶API (opens new window)”。
3、特約商戶/二級商戶每天僅能提交5次修改申請,如需繼續(xù)申請,請等到次日0點后重新發(fā)起。
4、修改結(jié)算銀行卡接口調(diào)用頻率限制:20/min。
# 接口說明
支持商戶:
【普通服務(wù)商】【平臺商戶】
請求方式:
【POST】/v3/apply4sub/sub_merchants/{sub_mchid}/modify-settlement
請求域名:
【主域名】
https://api.mch.weixin.qq.com
使用該域名將訪問就近的接入點【備域名】
https://api2.mch.weixin.qq.com
使用該域名將訪問異地的接入點 ,指引點擊查看
# 請求參數(shù)
Header HTTP頭參數(shù)
- sub_mchid 必填 string(10)【特約商戶/二級商戶號】 請?zhí)顚懕痉?wù)商負責(zé)進件的特約商戶/二級商戶號。
Path 路徑參數(shù)
- modify_mode 選填 string【修改模式】 修改模式。2023年4月17日前,該參數(shù)為選填;2023年4月17日(含當(dāng)日)之后,無論是否傳入該參數(shù),均按照受理模式執(zhí)行。
可選取值:MODIFY_MODE_ASYNC
: 受理模式
- account_type 必填 string【賬戶類型】 根據(jù)特約商戶號/二級商戶號的主體類型,可選擇的賬戶類型如下:
1、小微主體:經(jīng)營者個人銀行卡
2、個體工商戶主體:經(jīng)營者個人銀行卡/ 對公銀行賬戶
3、企業(yè)主體:對公銀行賬戶
4、黨政、機關(guān)及事業(yè)單位主體:對公銀行賬戶
5、其他組織主體:對公銀行賬戶
可選取值:ACCOUNT_TYPE_BUSINESS
: 對公銀行賬戶ACCOUNT_TYPE_PRIVATE
: 經(jīng)營者個人銀行卡
- account_bank 必填 string(128)
- bank_name 選填 string(128)【開戶銀行全稱(含支行)】 1、根據(jù)開戶銀行查詢接口中的“是否需要填寫支行”判斷是否需要填寫。如為其他銀行,開戶銀行全稱(含支行)和開戶銀行聯(lián)行號二選一。
2、詳細需調(diào)用查詢支行列表API查看查詢結(jié)果。 - bank_branch_id 選填 string(128)【開戶銀行聯(lián)行號】 1、根據(jù)開戶銀行查詢接口中的“是否需要填寫支行”判斷是否需要填寫。如為其他銀行,開戶銀行全稱(含支行)和開戶銀行聯(lián)行號二選一。
2、詳細需調(diào)用查詢支行列表API查看查詢結(jié)果。 - account_number 必填 string(1024)
- account_name 選填 string【開戶名稱】 1、不需要修改開戶名稱時,可以不填寫或填寫當(dāng)前綁定的結(jié)算銀行卡戶名;
2、支持將開戶名稱修改為當(dāng)前商戶對應(yīng)的主體名稱(對公銀行賬戶)或經(jīng)營者名稱(個人銀行賬戶),支持修改開戶名稱中括號的全半角;
3、該字段需進行加密處理,加密方法詳見敏感信息加密說明。(提醒:必須在HTTP頭中上送Wechatpay-Serial)
Body 包體參數(shù)
請求示例
POST
# 應(yīng)答參數(shù)
- application_no 必填 string(64)【修改結(jié)算賬戶申請單號】 提交二級商戶修改結(jié)算賬戶申請后,由微信支付返回的單號,作為查詢申請狀態(tài)的唯一標(biāo)識。
200OK
應(yīng)答示例
200 OK
# 錯誤碼
# 公共錯誤碼
狀態(tài)碼 | 錯誤碼 | 描述 | 解決方案 |
---|---|---|---|
400 | PARAM_ERROR | 參數(shù)錯誤 | 請根據(jù)錯誤提示正確傳入?yún)?shù) |
400 | INVALID_REQUEST | HTTP 請求不符合微信支付 APIv3 接口規(guī)則 | 請參閱 接口規(guī)則 |
401 | SIGN_ERROR | 驗證不通過 | 請參閱 簽名常見問題 |
500 | SYSTEM_ERROR | 系統(tǒng)異常,請稍后重試 | 請稍后重試 |
# 業(yè)務(wù)錯誤碼
狀態(tài)碼 | 錯誤碼 | 描述 | 解決方案 |
---|---|---|---|
403 | NO_AUTH | 商戶權(quán)限異常 | 該商戶不是本服務(wù)商進件的子商戶,無權(quán)限操作 |
400 | INVALID_REQUEST | 無效請求 | 請根據(jù)接口返回的詳細信息進行檢查 |
400 | INVALID_REQUEST | 你的開戶名稱與主體名稱不一致,請修改后重試 | 請修改為同名結(jié)算賬戶后重試。如商戶主體類型為企業(yè)/政府機關(guān)/事業(yè)單位/社會組織且需使用非同名結(jié)算賬戶時,可前往非同名銀行結(jié)算賬戶修改頁面 (opens new window)提交信息。如為托管子商戶,需通過服務(wù)商聯(lián)系對應(yīng)的微信支付行業(yè)運營協(xié)助處理。 |
429 | FREQENCY_LIMIT | 頻率超限 | 請求量不要超過接口調(diào)用頻率限制 |