受理渠道结算银行账户更名申请
更新时间:2026.03.25针对微众台账发起渠道结算银行账户更名申请。
接口限频:单商户200/分钟
接口说明
支持商户:【普通商户】
请求方式:【POST】/v3/aggracct-bc/wb-channel/bank-channel-account/rename
请求域名:【主域名】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
【微信支付公钥ID】或【微信支付平台证书序列号】 请求参数中的敏感字段,需要使用微信支付公钥加密(推荐),请参考获取微信支付公钥ID说明以及微信支付公钥加密敏感信息指引;也可以使用微信支付平台证书公钥加密,参考获取平台证书序列号、平台证书加密敏感信息指引
body 包体参数
out_request_no 必填 string(64)
【渠道结算银行账户更名外部系统单号】 渠道结算银行账户更名外部系统单号。微众内部全局唯一。微信支付仅做透传,不做幂等
mchid 必填 string(64)
【目标商户号】 需要修改渠道结算银行账户信息的微信支付商户号
bal_account_no 必填 string(1024)
【台账ID】 【加密】台账ID,对应微众支用账号。需要使用微信支付公钥加密(推荐),请参考获取微信支付公钥ID说明以及微信支付公钥加密敏感信息指引;也可以使用微信支付平台证书公钥加密,参考获取平台证书序列号、平台证书加密敏感信息指引
change_scene 必填 string
【变更类型】 变更类型,当前仅支持SUBJECT_INFO_RENAME,后面可能会扩展
可选取值
SUBJECT_INFO_RENAME: 主体资料更名
req_scene 选填 string
【请求场景】 不填默认按SJT_CONVENIENT_SETTLEMENT_SERVICE_MERCHANT处理
可选取值
SJT_CONVENIENT_SETTLEMENT_SERVICE_MERCHANT: 经营账户-结算便利服务商户SJT_MICRO_MERCHANT: 经营账户-微商户WX_SHOP_CONVENIENT_SETTLEMENT_SERVICE_MERCHANT: 微信小店-结算便利服务商户
请求示例
POST
应答参数
200 OK
change_scene 必填 string
【变更类型】 变更类型
可选取值
SUBJECT_INFO_RENAME: 主体资料更名
application_id 必填 string(64)
【微信支付更名受理返回的申请单号】 微信支付更名受理返回的申请单号
out_request_no 必填 string(64)
【渠道结算银行账户更名外部系统单号】 渠道结算银行账户更名外部系统单号。微众内部全局唯一。微信支付仅做透传,不做幂等。
mchid 必填 string(64)
【目标商户号】 需要修改渠道结算银行账户信息的微信支付商户号
bal_account_no 必填 string(1024)
【台账ID】 【加密】台账ID,对应微众支用账号。解密请参考如何使用API证书解密敏感字段。
new_account_name 必填 string(1024)
【目标账户名】 【加密】本次渠道结算银行账户更名申请的目标账户名。解密请参考如何使用API证书解密敏感字段。
application_state 必填 string
【申请单状态】 申请单状态
可选取值
PROCESSING: 处理中SUCCESS: 成功FAIL: 最终失败
finish_time 选填 string
【完成时间】 完成时间,仅申请单状态为成功/失败时返回。遵循rfc3339标准格式,格式为YYYY-MM-DDTHH:mm:ss+TIMEZONE,YYYY-MM-DD表示年月日,T出现在字符串中,表示time元素的开头,HH:mm:ss表示时分秒,TIMEZONE表示时区(+08:00表示东八区时间,领先UTC 8小时,即北京时间)。例如:2015-05-20T13:29:35+08:00表示,北京时间2015年5月20日 13点29分35秒。
fail_code 选填 string
【失败错误码】 失败错误码,仅申请单状态为失败时返回
可选取值
AUDIT_REJECT: 审核驳回
fail_msg 选填 string(2048)
【失败原因】 失败原因,仅申请单状态为失败时返回。最大长度2048个UTF8字符
应答示例
200 OK
错误码
以下是本接口返回的错误码列表。详细错误码规则,请参考微信支付接口规则-错误码和错误提示
状态码 | 错误码 | 描述 | 解决方案 |
|---|---|---|---|
400 | PARAM_ERROR | 参数错误 | 请根据错误提示正确传入参数 |
400 | INVALID_REQUEST | HTTP 请求不符合微信支付 APIv3 接口规则 | 请参阅 接口规则 |
401 | SIGN_ERROR | 验证不通过 | 请参阅 签名常见问题 |
500 | SYSTEM_ERROR | 系统异常,请稍后重试 | 请稍后重试 |
403 | NO_AUTH | 权限异常 | 请检查 a. 发起商户是否微众技术号商户;b. 参数mchid是否微众渠道聚合商户;c. 参数mchid和bal_account_no是否匹配 |
400 | ALREADY_EXISTS | 商户已有在途中的单据 | 通过查询接口确认在途单据状态为已成功/已失败后,重试 |
403 | NOT_ENOUGH | 单日改卡次数达到上限(更名失败也累计次数,上限5次) | T+1日发起重试 |
400 | INVALID_REQUEST | 主体名称长度超限 | 请检查当前主体资料主体名长度合法 |
403 | USER_ERROR | 聚合风控拦截修改结算银行账户 | 请检查商户当前的风控状态 |
429 | FREQUENCY_LIMITED | 频率超限 | 请降低请求接口频率 |
409 | ABORTED | 未完成开户改卡,无法发起修改,需稍后重试 | 稍后重试 |
404 | NOT_FOUND | 无历史更名申请,且当前银行账户户名已和主体名一致,无需更名 | 请检查当前商户银行账户户名和主体名是否不一致,再重试 |
