修改联系信息

更新时间：2025.04.07

接口规则

请求Url	https://api.mch.weixin.qq.com/applyment/micro/modifycontactinfo
是否需要证书	是，详见证书使用

请求参数

名称	变量名	必填	类型	示例值	描述
接口版本号	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	小微商户的商户号
手机号	mobile_phone	否	String(11)	13734543456	1、前后不能有空格、制表符、换行符 2、需满足以下任一条件 11位数字的手机号码 5-20位数字、连字符“-”、加号“+” 3、用于接收微信支付的重要管理信息及日常操作验证码小微商户手机号，该字段属于敏感信息，需要进行加密处理，加密方法详见敏感信息加密说明
邮箱	email	否	String(50)	zhangsan@227.com	小微商户邮箱，该字段属于敏感信息，需要进行加密处理，加密方法详见敏感信息加密说明
商户简称	merchant_name	否	String(20)	张三的小店	在支付完成页向买家展示，需与微信经营类目相关： 1、请输入1-64个字符 2、前后不能有空格、制表符、换行符 3、不能仅含特殊字符 4、仅能填写数字、英文字母、汉字及特殊字符 5、仅支持utf-8格式
加密的平台证书序列号	cert_sn	是	String(64)	50062CE505775F070CAB06E697F1BBD1AD4F4D87	用于对敏感信息进行加密的平台证书序列号，获取方法详见平台证书及序列号获取接口（接口返回参数ተ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[592EF3CC5620AECB1871A27A6813DA79B19E4552C58061C09742B0D335EAAE8E]]></sign>
7   <sub_mch_id><![CDATA[1501859791]]></sub_mch_id>
8   <merchant_name><![CDATA[小微修改联系人测试]]></merchant_name>
9   <mobile_phone><![CDATA[bkEvTYonL8G4r1/9ygZWSXppSFjBjTpKSFQje04Bcp9RoDoOPLO1DgyChBCiaCOHwDPCkuV5etQvbT+B3iLVMS7QAgRH1Ovuu5hS8K8FbRTJgfUalCOyuiAIGSOtFpbtUAFyWCxVoShlDQSqXT11CwUFEKD4x7l1U46AzRUCz/4Pfc1mle7Px86MeZNdx42O8pvsb43AsISqnrcq7idz2zQGotc/Y378H/nptrAEphd5KsWdZMv2/sXtNwjFvqR0mfAJygu389sM/7TdH0Ji81/GPn0FnBxk2G7U+usfvRa68gE72S2C075eQ3pmK7ONahT5APSWbmeeg0w624Icgg==]]></mobile_phone>
10   <cert_sn><![CDATA[50062CE505775F070CAB06E697F1BBD1AD4F4D87]]></cert_sn>
11   <email><![CDATA[SYO4atvj/i18zakEhzf2g3V4Cl+dmmnqOxcC22yw/wOQFAL7NZC3RV9dTJxReYfLQsE9tla3PSaseg3zF+n31YkuHSUWYctZi8532p0c+VkaiTpFDmtSD2At3qJdwQJYtD5FGWY7JLaAaYf567SQrqqdzxiJCXuEW2sD6QE4cib1AKhb6mq1YYX87c1t9SUGOjDmNI9txCxFmYOzjkUVZ3f26QqDEZ+uz7UPB24d7UTql5nsoMS2AOMsk8ZegDYuY0Re5eATmlFhVn6y6a9WKe0pZnEWHPYRwIOGTUaUPnSPPq8Xy8V9+0DXxiCeDV+WSjQlWBpGxG5WKu6M4GosDw==]]></email>
12</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)	商户号信息有误，请检查修改后重试	参考业务错误码列表

当return_code 和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[z5SLBxca4rw1Quiv]]></nonce_str>
5   <sign><![CDATA[7C474FF5CD991BE660EF02C6404F5708C12E0580A4F1A46BC6FC99E563D46B09]]></sign>
6   <result_code><![CDATA[SUCCESS]]></result_code>
7   <mch_id><![CDATA[1900006501]]></mch_id>
8   <sub_mch_id><![CDATA[1501859791]]></sub_mch_id>
9</xml>

错误码列表

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

文档是否有帮助

更多支持

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