查询渠道结算银行账户更名申请

更新时间:2026.03.25
||
提示:本功能目前处于灰度测试阶段、暂未开放使用,待全量开放后将通过文档门户公告同步,感谢您的理解。

查询渠道结算银行账户更名申请。
接口限频:单商户200/分钟

接口说明

支持商户:【普通商户】

请求方式:【GET】/v3/aggracct-bc/wb-channel/bank-channel-account/rename/{application_id}

请求域名:【主域名】https://api.mch.weixin.qq.com 使用该域名将访问就近的接入点

     【备域名】https://api2.mch.weixin.qq.com 使用该域名将访问异地的接入点 ,指引点击查看

请求参数

Header  HTTP头参数

 Authorization  必填 string

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


 Accept  必填 string

请设置为application/json


 Wechatpay-Serial  必填 string

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


path  路径参数

 application_id  必填   string(64)

【微信支付更名受理返回的申请单号】 调用API接口「受理渠道结算银行账户更名申请」时返回的申请单号


query  查询参数

 mchid  必填   string(64)

【目标商户号】 需要修改渠道结算银行账户信息的微信支付商户号


 bal_account_no  必填   string(1024)

【台账ID】 【加密】台账ID,对应微众支用账号。需要使用微信支付公钥加密(推荐),请参考获取微信支付公钥ID说明以及微信支付公钥加密敏感信息指引;也可以使用微信支付平台证书公钥加密,参考获取平台证书序列号平台证书加密敏感信息指引

请求示例

curl
Java
Go

GET

1curl -X GET \
2  https://api.mch.weixin.qq.com/v3/aggracct-bc/wb-channel/bank-channel-account/rename/11117742499090086455469010028373?mchid=3401098624&bal_account_no=Cf80Dpbwo2cexDDB2k5W%2FDZyefMg8nCvBgty1OCebYcgxVuAgfNDLP92kc4i60odlVBmyc1%2BNo9dafz57Ydp9S9K3wAvOvumVgxQXRVGvKGP8aoB5t9UINUe378Eq2mtV2lsN5RIfLmQJOOFnw1XP28KWXTRJfndRb5aQNZ%2BLZCMZzr7%2FZeNijCpxiru0sVdqD5B7hGB724QMbY5R6amZ6%2Fgs%2FxA9sHxBB%2BAx5tOAH0r3w72dqyBOJrQutoO73C2zGc%2BiQiRETLIhuz%2FdEUvDmpsQcAFeC02qVFn51373ATCmWnABRfXzMKX32JY%2BmKgSp%2FNQcTWlAcN8nAl%2FpAOKg%3D%3D \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" \
5  -H "Wechatpay-Serial: 5157F09EFDC096DE15EBE81A47057A7232F1B8E1"  
6

应答参数

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

1{
2  "change_scene" : "SUBJECT_INFO_RENAME",
3  "application_id" : "11117739950510011525404734679776",
4  "out_request_no" : "2603234MF14213212593871964733440",
5  "mchid" : "3401098624",
6  "bal_account_no" : "TKaG8Vew4GN7Hn8ShYH7jhYEZM+k1JXIxra3ZwErVLY4lbVBMyHaPOky5A/YCikv9vJBeKdeYjOB3KAovc1GBRYBgpR/P2SRZ3Ebp/f6SGVcIA/mvh0gqUdTa1AlXcA7wUihhSBaqjqA1D8JbO64RUbuq4e4MWoBvwrP9ca8V7XOUflNJ9NHoiHQCa7RoL58JyaiAjoEkmtQoA/yEvzRUx8LAyHQvssL8+UZ/YNJGFeAehNgdjrWgUOx9sdaBIRF+oiCR/dIGgbQjZJ8L/EV58G0iQ+0s16/vCrHw5KwZ/RJi7VYSf95SVkh+oilwMOMKg3+2bFQXdF0imWk+W7BQA==",
7  "new_account_name" : "FMbf1tn2F0NRYCJp1BW76oVoMuzBL00kPke7DFipk5hl8sGqCNoO08ZXfjqCPs4P8Vq83BXfSWygAtVG8O5k3adgMor3G9BbF+hIugbYKYtnDC10iJdfmGOZvLGVOnrZIoMFSXw5Swwby5NVyLvME59T0dU6mo1R/St0mYypVPLwV+SG9pGo2LBC7vKzs3yWevgd5TBsaQqNP6nUNGZMURMAzGp2DYttI+q7ORuSku4HMh8WLDSnGLYvCpN+tLGS3s7hB8AB8sAm/sS5bnUM9jtbDUJ+pmj/VxTLv6WDMJu8yVoqxdCq4srEUrgvHLgmAmcE3v5LmwNg/Ew3HGglcw==",
8  "application_state" : "SUCCESS",
9  "finish_time" : "2026-03-23T15:41:34+08:00",
10  "fail_code" : "AUDIT_REJECT",
11  "fail_msg" : "身份证有效期核验不通过,请检查有效期填写是否正确"
12}
13

 

错误码

以下是本接口返回的错误码列表。详细错误码规则,请参考微信支付接口规则-错误码和错误提示

状态码

错误码

描述

解决方案

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是否匹配

404

NOT_FOUND

请求的申请单不存在

请检查请求参数是否正确

429

FREQUENCY_LIMITED

频率超限

请降低请求接口频率

 

反馈
目录
置顶