修改结算银行卡

更新时间：2025.04.07

场景介绍

通过此接口可以修改小微商户的入驻资料，例如银行卡号、入驻人姓名等。

接口链接

https://api.mch.weixin.qq.com/applyment/micro/modifyarchives

是否需要证书

请求需要双向证书。详见证书使用

请求参数

字段名	变量名	必填	类型	示例值	描述
接口版本号	version	是	String(32)	1.0	默认值1.0
商户号	mch_id	是	String(32)	1230000109	服务商的商户号
随机字符串	nonce_str	是	String(32)	ibuaiVcKdpRxkhJA	参考签名规则
签名类型	sign_type	是	String(128)	HMAC-SHA256	签名类型，仅支持HMAC-SHA256。该字段需参与签名sign的计算。
签名	sign	是	String(64)	D675A1E471DBF7C0B1AC5883B5BDA9EF	签名，详见签名生成算法
小微商户号	sub_mch_id	是	String(32)	1230000109	小微商户的商户号
银行卡号	account_number	否	String(50)		商户结算银行卡号,该字段属于敏感字段，需要进行加密处理，加密方法详见敏感信息加密说明
开户银行全称（含支行）	bank_name	否	String(256)	深圳农村商业银行xxx支行	1）17家直连银行无需填写，其他银行请务必填写 2）需填写银行全称，如"深圳农村商业银行XXX支行" 详细参见开户银行全称（含支行）对照表
开户银行	account_bank	否	String(50)	中国银行	详细参见开户银行对照表
开户银行省市编码	bank_address_code	是	String(6)	110000	至少精确到市,详细参见微信支付提供省市对照表
平台证书序列号	cert_sn	是	String(64)	5430056GFRJK54YTFF653GDFH09HFGHF	用于对敏感信息进行加密的平台证书序列号，获取方法详见平台证书及序列号获取接口（接口返回参数“serial_no”即为平台证书序列号）

请求示例

1<xml>
2   <version><![CDATA[1.0]]></version>
3   <mch_id><![CDATA[1900006501]]></mch_id>
4   <nonce_str><![CDATA[578891d2f06e2bb730a3c5a93f916515]]></nonce_str>
5   <sign_type><![CDATA[HMAC-SHA256]]></sign_type>
6   <sign><![CDATA[9874FC913356B685DACF641B20E93ECA06B6D5AB9013CD40274BE73F71A267C6]]></sign>
7   <sub_mch_id><![CDATA[1501859791]]></sub_mch_id>
8   <account_bank><![CDATA[招商银行]]></account_bank>
9   <account_number><![CDATA[1111857554101111]]></account_number>
10</xml>

返回结果

字段名	变量名	必填	类型	示例值	描述
返回状态码	return_code	是	String(16)	FAIL	SUCCESS/FAIL
返回信息	return_msg	否	String(128)	签名失败	只支持POST方法 xml格式错误协议转换时发生系统错误未检测到必填参数XXX 请求参数签名错误返回结果时签名失败

以下字段在return_code为SUCCESS的时候有返回

随机字符串	nonce_str	是	String(32)	ibuaiVcKdpRxkhJA	随机字符串
签名	sign	是	String(32)	D675A1E471DBF7C0B1AC5883B5BDA9EF	签名，详见签名生成算法
业务结果	result_code	是	String(32)	SUCCESS	SUCCESS/FAIL
错误代码	err_code	否	String(32)	PARAM_ERROR	参考业务错误码列表
错误代码描述	err_code_des	否	String(128)	商户号信息有误，请检查修改后重试	参考业务错误码列表

以下字段在result_code为SUCCESS的时候有返回

商户号	mch_id	是	String(32)	1230000109	服务商的商户号
小微商户号	sub_mch_id	是	String(32)	1230000109	小微商户的商户号

返回示例

1<xml>
2   <return_code><![CDATA[SUCCESS]]></return_code>
3   <return_msg><![CDATA[OK]]></return_msg>
4   <nonce_str><![CDATA[3Ilu41xvNWLNmgjw]]></nonce_str>
5   <sign><![CDATA[5E024CB99587352F6141DDC0BE13FD1A3F349AD1E5874244EE9717C3B295557E]]></sign>
6   <result_code><![CDATA[FAIL]]></result_code>
7   <err_code><![CDATA[INVALID_REQUEST]]></err_code>
8   <err_code_des><![CDATA[银行卡存在，但与姓名证件号其中一项或全部不匹配]]></err_code_des>
9</xml>

错误代码列表

错误代码	名称	描述	解决方案
SYSTEMERROR	系统错误	内部系统之间调用发生错误	稍后再试
PARAM_ERROR	参数错误	参数填写有误，请检查后重试	人工检查过滤
NOAUTH	无权限	商户号无相应的操作权限	开通权限后再试
INVALID_REQUEST	无效请求	业务逻辑处理失败	根据错误提示操作

文档是否有帮助

更多支持

开发文档(商户)开发文档(V2版)开发者社区微信开放平台微信公众平台腾讯客服