修改结算账号

Header HTTP头参数

Authorization 　必填　string

请参考签名认证生成认证信息

Accept 　必填　string

请设置为application/json

Content-Type 　必填　string

请设置为application/json

Wechatpay-Serial 　必填　string

请求参数中的敏感字段，需要使用微信支付公钥加密（推荐），请参考获取微信支付公钥ID说明以及微信支付公钥加密敏感信息指引，也可以使用微信支付平台证书公钥加密，参考获取平台证书序列号、平台证书加密敏感信息指引

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_name 　选填 string(128)

【开户银行全称（含支行）】 1、根据开户银行查询接口中的“是否需要填写支行”判断是否需要填写。如为其他银行，开户银行全称（含支行）和开户银行联行号二选一。
2、详细需调用查询支行列表API查看查询结果。

bank_branch_id 　选填 string(128)

【开户银行联行号】 1、根据开户银行查询接口中的“是否需要填写支行”判断是否需要填写。如为其他银行，开户银行全称（含支行）和开户银行联行号二选一。
2、详细需调用查询支行列表API查看查询结果。

account_number 　必填 string(1024)

【银行账号】 1、数字，长度遵循系统支持的开户银行对照表中对公/对私卡号长度要求
2、该字段需要使用微信支付公钥加密（推荐），请参考获取微信支付公钥ID说明以及微信支付公钥加密敏感信息指引，也可以使用微信支付平台证书公钥加密，参考获取平台证书序列号、平台证书加密敏感信息指引

account_name 　选填 string

【开户名称】 1、不需要修改开户名称时，可以不填写或填写当前绑定的结算银行卡户名；
2、支持将开户名称修改为当前商户对应的主体名称（对公银行账户）或经营者名称（个人银行账户），支持修改开户名称中括号的全半角；
3、该字段需要使用微信支付公钥加密（推荐），请参考获取微信支付公钥ID说明以及微信支付公钥加密敏感信息指引，也可以使用微信支付平台证书公钥加密，参考获取平台证书序列号、平台证书加密敏感信息指引

请求示例

POST

1curl -X POST \
2  https://api.mch.weixin.qq.com/v3/apply4sub/sub_merchants/1900006491/modify-settlement \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" \
5  -H "Wechatpay-Serial: 5157F09EFDC096DE15EBE81A47057A7232F1B8E1"  \
6  -H "Content-Type: application/json" \
7  -d '{
8    "modify_mode" : "MODIFY_MODE_ASYNC",
9    "account_type" : "ACCOUNT_TYPE_BUSINESS",
10    "account_bank" : "工商银行",
11    "bank_name" : "中国工商银行股份有限公司北京市分行营业部",
12    "bank_branch_id" : "402713354941",
13    "account_number" : "d+xT+MQCvrLHUVDWv/8MR/dB7TkXM2YYZlokmXzFsWs35NXUot7C0NcxIrUF5FnxqCJHkNgKtxa6RxEYyba1+VBRLnqKG2fSy/Y5qDN08Ej9zHCwJjq52Wg1VG8MRugli9YMI1fI83KGBxhuXyemgS/hqFKsfYGiOkJqjTUpgY5VqjtL2N4l4z11T0ECB/aSyVXUysOFGLVfSrUxMPZy6jWWYGvT1+4P633f+R+ki1gT4WF/2KxZOYmli385ZgVhcR30mr4/G3HBcxi13zp7FnEeOsLlvBmI1PHN4C7Rsu3WL8sPndjXTd75kPkyjqnoMRrEEaYQE8ZRGYoeorwC+w==",
14    "account_name" : "VyOMa+SncfM4lLha65dsxZ/xYW1zqBVVp6/W5mNkolESJU9fqgMt0lxjtuiWdhR+qUjnC2dTfuJuCOZs/Qi6kmicogGFjDC9ZxzFpdjR7AidWDuCIId5WRnRN8lGUcVyxctZZ4WcxxL2ADq57h7dZoFxNgyRYR4Y6q37LpYDccmYO5SiCkUP3rMX1CrTwKJysVhHij62HiU/P/yScImgdKrc+/MBWb1O6TT2RgwU3U6IwSZRWx4QH4EmYBLAQTdcEyUz2wuDmPA4nMSeXJVyzKl/WB+QYBh4Yj+BLT0HkA2IbTRyGX1U2wvv3N/w59Xq0pWYSXMHlmxhle2Cqj/7Cw=="
15  }'
16

200 OK

application_no 　必填 string(64)

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

应答示例

200 OK

1{
2  "application_no" : "102329389XXXX"
3}
4