服务商/电商平台（不包括支付机构、银行），可使用本接口，修改其进件且已签约特约商户/二级商户的结算银行账户。

注意：

1、2023年3月31日（含当日）起，传入“修改模式”的请求参数时，可启用微信支付受理模式。2023年4月17日（含当日）之后，无论是否传入该参数，均按照受理模式执行。

i. 非受理模式下：提交结算账户修改申请后，应答代码为“204”即代表银行结算账户更新成功；

ii. 受理模式下：提交结算银行账户修改申请后，应答代码为“200”且系统返回申请单号，需通过"查询结算账户修改申请状态API (opens new window)"查询申请单处理结果。申请单状态存在如下情况：

① 审核中：修改的银行结算账户还在审核中、账户尚未生效，需继续等待审核结果，在此期间无法再次提交修改申请；审核过程中，系统可能会向结算银行账户付款0.01元进行验证。

② 已驳回：申请已驳回，请检查驳回原因、并重新发起修改。

③ 完成：银行结算账户更新成功。

2、如需查询当前生效中的银行结算账户，请使用“查询结算账户API (opens new window)”。

3、特约商户/二级商户每天仅能提交5次修改申请，如需继续申请，请等到次日0点后重新发起。

4、修改结算银行卡接口调用频率限制：20/min。

接口说明

支持商户：

【普通服务商】【电商平台】

请求方式：

【POST】/v3/apply4sub/sub_merchants/{sub_mchid}/modify-settlement

请求域名：

【主域名】

https://api.mch.weixin.qq.com

使用该域名将访问就近的接入点

【备域名】

https://api2.mch.weixin.qq.com

使用该域名将访问异地的接入点 ，指引点击查看

请求参数

Header HTTP头参数
Authorization 必填 string
请参考 签名认证 生成认证信息
Accept 必填 string
请设置为 application/json
Content-Type 必填 string
请设置为 application/json
Wechatpay-Serial 必填 string
【微信支付平台证书序列号】 请求参数中的敏感字段，需要使用微信支付平台证书公钥加密。请设置为该证书的证书序列号。详见敏感信息加解密

Path 路径参数
sub_mchid 必填 string(10)
【特约商户/二级商户号】 请填写本服务商负责进件的特约商户/二级商户号。

Body 包体参数
modify_mode 选填 string
【修改模式】 修改模式。2023年4月17日前，该参数为选填；2023年4月17日（含当日）之后，无论是否传入该参数，均按照受理模式执行。
可选取值：

• MODIFY_MODE_ASYNC: 受理模式
account_type 必填 string
【账户类型】 根据特约商户号/二级商户号的主体类型，可选择的账户类型如下：
1、小微主体：经营者个人银行卡
2、个体工商户主体：经营者个人银行卡/ 对公银行账户
3、企业主体：对公银行账户
4、党政、机关及事业单位主体：对公银行账户
5、其他组织主体：对公银行账户
可选取值：

• ACCOUNT_TYPE_BUSINESS: 对公银行账户
• ACCOUNT_TYPE_PRIVATE: 经营者个人银行卡
account_bank 必填 string(128)
【开户银行】 请填写开户银行名称。
对私银行调用：查询支持个人业务的银行列表API
对公银行调用：查询支持对公业务的银行列表API
bank_address_code 必填 string(128)
【开户银行省市编码】 需至少精确到市，详细参见省市区编号对照表。
bank_name 选填 string(128)
【开户银行全称（含支行）】 1、根据开户银行查询接口中的“是否需要填写支行”判断是否需要填写。如为其他银行，开户银行全称（含支行）和开户银行联行号二选一。
2、详细需调用查询支行列表API查看查询结果。
bank_branch_id 选填 string(128)
【开户银行联行号】 1、根据开户银行查询接口中的“是否需要填写支行”判断是否需要填写。如为其他银行，开户银行全称（含支行）和开户银行联行号二选一。
2、详细需调用查询支行列表API查看查询结果。
account_number 必填 string(1024)
【银行账号】 1、数字，长度遵循系统支持的开户银行对照表中对公/对私卡号长度要求
2、该字段需进行加密处理，加密方法详见敏感信息加密说明。(提醒：必须在HTTP头中上送Wechatpay-Serial)
account_name 选填 string
【开户名称】 1、不需要修改开户名称时，可以不填写或填写当前绑定的结算银行卡户名；
2、支持将开户名称修改为当前商户对应的主体名称（对公银行账户）或经营者名称（个人银行账户），支持修改开户名称中括号的全半角；
3、该字段需进行加密处理，加密方法详见敏感信息加密说明。(提醒：必须在HTTP头中上送Wechatpay-Serial)

请求示例

POST

应答参数

200OK
application_no 必填 string(64)
【修改结算账户申请单号】 提交二级商户修改结算账户申请后，由微信支付返回的单号，作为查询申请状态的唯一标识。

应答示例

200 OK

错误码

公共错误码

状态码	错误码	描述	解决方案
400	PARAM_ERROR	参数错误	请根据错误提示正确传入参数
400	INVALID_REQUEST	HTTP 请求不符合微信支付 APIv3 接口规则	请参阅 接口规则
401	SIGN_ERROR	验证不通过	请参阅 签名常见问题
500	SYSTEM_ERROR	系统异常，请稍后重试	请稍后重试

业务错误码

状态码	错误码	描述	解决方案
403	NO_AUTH	商户权限异常	该商户不是本服务商进件的子商户，无权限操作
400	INVALID_REQUEST	无效请求	请根据接口返回的详细信息进行检查
429	FREQENCY_LIMIT	频率超限	请求量不要超过接口调用频率限制