最新更新时间：2022.01.04 版本说明
服务商/电商平台（不包括支付机构、银行），可使用本接口，修改其进件且已签约特约商户/二级商户的结算银行账户。
1、本接口无需传银行开户名称参数。
① 若账户类型为“经营者个人银行卡”，则系统自动拉取特约商户的经营者姓名为开户名称。
② 若账户类型为“对公银行账户”，则系统自动拉取特约商户的公司名称为开户名称。
2、API发起修改结算账户信息，校验通过后，会即时生效新资料；
3、修改生效后，系统会自动汇款0.01元至新结算账户，验证是否可正常使用。可通过 查询结算账户API 查询验证结果
① 汇款验证中，商户可发起提现尝试。
② 系统成功汇款，该账户可正常发起提现。
③ 系统汇款失败，该账户无法发起提现，请检查修改。
适用对象：服务商 电商平台
请求URL：https://api.mch.weixin.qq.com/v3/apply4sub/sub_merchants/{sub_mchid}/modify-settlement
请求方式：POST
path指该参数为路径参数
query 指该参数需在请求URL传参
body 指该参数需在请求JSON传参
| 参数名 | 变量 | 类型[长度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 特约商户/二级商户号 | sub_mchid | string[8,10] | 是 | path请填写本服务商负责进件的特约商户/二级商户号。 |
| 账户类型 | account_type | string[1,32] | 是 | body 根据特约商户/二级商户号的主体类型，可选择的账户类型如下：
|
| 开户银行 | account_bank | string[1,128] | 是 | body 请填写开户银行名称 对私银行调用：查询支持个人业务的银行列表API 对公银行调用：查询支持对公业务的银行列表API。 示例值：工商银行 |
| 开户银行省市编码 | bank_address_code | string[1,128] | 是 | body 需至少精确到市，详细参见省市区编号对照表。 示例值：110000 |
| 开户银行全称（含支行） | bank_name | string[1,128] | 条件选填 | body 1、根据开户银行查询接口中的“是否需要填写支行”判断是否需要填写。如为其他银行，开户银行全称（含支行）和开户银行联行号二选一。 2、详细需调用查询支行列表API查看查询结果。 示例值：中国工商银行股份有限公司北京市分行营业部 |
| 开户银行联行号 | bank_branch_id | string[1,128] | 条件选填 | body 1、根据开户银行查询接口中的“是否需要填写支行”判断是否需要填写。如为其他银行，开户银行全称（含支行）和开户银行联行号二选一。 2、详细需调用查询支行列表API查看查询结果。 示例值：402713354941 |
| 银行账号 | account_number | string[1,1024] | 是 | body 1、数字，长度遵循系统支持的开户银行对照表中对公/对私卡号长度要求 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": "施秉县农村信用合作联社城关信用社",
"bank_branch_id": "402713354941",
"account_number": "d+xT+MQCvrLHUVDWv/8MR/dB7TkXM2YYZlokmXzFsWs35NXUot7C0NcxIrUF5FnxqCJHkNgKtxa6RxEYyba1+VBRLnqKG2fSy/Y5qDN08Ej9zHCwJjq52Wg1VG8MRugli9YMI1fI83KGBxhuXyemgS/hqFKsfYGiOkJqjTUpgY5VqjtL2N4l4z11T0ECB/aSyVXUysOFGLVfSrUxMPZy6jWWYGvT1+4P633f+R+ki1gT4WF/2KxZOYmli385ZgVhcR30mr4/G3HBcxi13zp7FnEeOsLlvBmI1PHN4C7Rsu3WL8sPndjXTd75kPkyjqnoMRrEEaYQE8ZRGYoeorwC+w=="
}
| 错误码 | 描述 | 解决方案 |
|---|---|---|
| SYSTEMERROR | 系统错误 | 系统异常，请使用相同参数稍后重新调用 |
| PARAM_ERROR | 参数错误 | 请使用正确的参数重新调用 |
| INVALID_REQUEST | 无效请求 | 请查看返回的错误信息，根据错误信息进行操作 |
| NOAUTH | 商户权限异常 | 请确认是否已经开通相关权限 |