修改联系信息
更新时间：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 | 无效请求 | 业务逻辑处理失败 | 根据错误提示操作 |
