提交申请单

更新时间:2025.07.17
||

服务商使用该接口提交商家超级管理员变更申请,帮助商家修改超级管理员资料。

接口说明

支持商户:【普通服务商】

请求方式:【POST】/v3/mchalterapply/mchcontactalterapplyment

请求域名:【主域名】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  包体参数

 merchant_code  必填   string(32)

【商户号】 1、请填写本服务商负责进件的二级商户号。
2、微信支付分配的特约商户的唯一标识。


 out_request_no  必填   string(124)

【业务申请编号】 1、服务商自定义的唯一编号。
2、每个编号对应一个申请单。
3、若申请单被驳回,可填写相同的“业务申请编号”,即可覆盖修改原申请单信息 。
4、一个商户,同一时间只能存在一笔流程中的申请单,若申请单被驳回,请使用原单进行重试。


 contact_info  必填   object

【超级管理员信息】 请填写店铺最新的超级管理员信息。

属性

 contact_name  必填   string(512)

【超级管理员姓名】 1、填写实际超级管理员的姓名
2、长度为2-100个字符
3、前后不能有空格、制表符、换行符
4、不能仅含数字、特殊字符
5、仅能填写数字、英文字母、汉字及特殊字符
6、该字段需进行加密处理,加密方法详见<a href="https://pay.weixin.qq.com/wiki/doc/apiv3_partner/wechatpay/wechatpay4_3.shtml">敏感信息加密说明</a>。(提醒:必须在HTTP头中上送Wechatpay-Serial)


 contact_id_doc_type  必填   string

【超级管理员证件类型】 1、请上传超级管理员证件类型。
IDENTIFICATION_TYPE_IDCARD:中国大陆居民-身份证
IDENTIFICATION_TYPE_OVERSEA_PASSPORT:其他国家或地区居民-护照
IDENTIFICATION_TYPE_HONGKONG_PASSPORT:中国香港居民--来往内地通行证
IDENTIFICATION_TYPE_MACAO_PASSPORT:中国澳门居民--来往内地通行证
IDENTIFICATION_TYPE_TAIWAN_PASSPORT:中国台湾居民--来往大陆通行证
IDENTIFICATION_TYPE_FOREIGN_RESIDENT:外国人居留证
IDENTIFICATION_TYPE_HONGKONG_MACAO_RESIDENT:港澳居民证
IDENTIFICATION_TYPE_TAIWAN_RESIDENT:台湾居民证

2、如主体类型是政府机关,仅支持传入IDENTIFICATION_TYPE_IDCARD:中国大陆居民-身份证

可选取值

  • IDENTIFICATION_TYPE_IDCARD:  中国大陆居民-身份证

  • IDENTIFICATION_TYPE_OVERSEA_PASSPORT:  其他国家或地区居民-护照

  • IDENTIFICATION_TYPE_HONGKONG_PASSPORT:  中国香港居民-来往内地通行证

  • IDENTIFICATION_TYPE_MACAO_PASSPORT:  中国澳门居民-来往内地通行证

  • IDENTIFICATION_TYPE_TAIWAN_PASSPORT:  中国台湾居民-来往大陆通行证

  • IDENTIFICATION_TYPE_FOREIGN_RESIDENT:  外国人居留证

  • IDENTIFICATION_TYPE_HONGKONG_MACAO_RESIDENT:  港澳居民证

  • IDENTIFICATION_TYPE_TAIWAN_RESIDENT:  台湾居民证


 contact_id_card_number  必填   string

【超级管理员证件号码】 1、身份证(限中国大陆居民):17位数字+1位数字|X
护照(限境外人士):4-15位 数字|字母|连字符
中国香港居民--来往内地通行证:
(1)H+8个数字
(2)H+8个数字+2个字母或数字
(3)HA+7个数字
中国澳门居民--来往内地通行证:
(1)M+8个数字
(2)M+8个数字+2个字母或数字
(3)MA+7个数字
中国台湾居民--来往大陆通行证:8位数字或10位数字
外国人居留证:15位 数字|字母
港澳居住证/台湾居住证:17位数字+1位数字|X
2、该字段需进行加密处理,加密方法详见<a href="https://pay.weixin.qq.com/wiki/doc/apiv3_partner/wechatpay/wechatpay4_3.shtml">敏感信息加密说明</a>。(提醒:必须在HTTP头中上送Wechatpay-Serial)


 contact_id_doc_copy  必填   string

【超级管理员证件正面照片】 1、若证件类型为身份证,请上传人像面照片。
2、正面拍摄、清晰、四角完整、无反光或遮挡;不得翻拍、截图、镜像、PS。
3、请上传彩色照片or彩色扫描件,复印件需加盖公章鲜章,可添加“微信支付”相关水印(如微信支付认证),见【<a href="https://kf.qq.com/faq/230615MjMBRf230615NNn2yY.html">指引文档</a>】
4、可上传1张图片,请填写通过<a href="https://pay.weixin.qq.com/wiki/doc/apiv3_partner/apis/chapter2_1_1.shtml">图片上传API</a>预先上传图片生成好的MediaID。


 contact_id_doc_copy_back  选填   string

【超级管理员证件反面照片】 1、若证件类型为护照,无需上传反面照片。
2、正面拍摄、清晰、四角完整、无反光或遮挡;不得翻拍、截图、镜像、PS。
3、请上传彩色照片or彩色扫描件,复印件需加盖公章鲜章,可添加“微信支付”相关水印(如微信支付认证),见【<a href="https://kf.qq.com/faq/230615MjMBRf230615NNn2yY.html">指引文档</a>】
4、可上传1张图片,请填写通过<a href="https://pay.weixin.qq.com/wiki/doc/apiv3_partner/apis/chapter2_1_1.shtml">图片上传API</a>预先上传图片生成好的MediaID。


 contact_id_doc_period_begin  必填   string

【超级管理员证件有效期开始时间】 1、请按照示例值填写,日期格式应满足合法的YYYY-MM-DD格式
2、开始时间不能小于1900-01-01,开始时间不能大于等于当前日期。


 contact_id_doc_period_end  必填   string

【超级管理员证件有效期结束时间】 1、请上传证件有效期结束时间。
2、请按照示例值填写,日期格式应满足合法的YYYY-MM-DD格式,若证件有效期为长期,请填写:长期。
3、结束时间大于开始时间。


 mobile_phone  必填   string

【超级管理员手机】 1、前后不能有空格、制表符、换行符
2、需满足以下任一条件
(1)11位数字的手机号码
(2)5-20位数字、连字符“-”、加号“+”
3、该字段需进行加密处理,加密方法详见<a href="https://pay.weixin.qq.com/wiki/doc/apiv3_partner/wechatpay/wechatpay4_3.shtml">敏感信息加密说明</a>。(提醒:必须在HTTP头中上送Wechatpay-Serial)

请求示例

curl
Java
Go

POST

1curl -X POST \
2  https://api.mch.weixin.qq.com/v3/mchalterapply/mchcontactalterapplyment \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" \
5  -H "Wechatpay-Serial: 5157F09EFDC096DE15EBE81A47057A7232F1B8E1"  \
6  -H "Content-Type: application/json" \
7  -d '{
8    "merchant_code" : "2492185251",
9    "out_request_no" : "1900013511_10000",
10    "contact_info" : {
11      "contact_name" : "pVd1HJ6zyvPedzGaV+X3IdGdbDnuC4Eelw/wDa4SzfeespQO/0kjiwfqdfg==",
12      "contact_id_doc_type" : "IDENTIFICATION_TYPE_IDCARD",
13      "contact_id_card_number" : "pVd1HJ6zyvPedzGaV+X3qtmrq9bb9tPROvwia4ibL+F6mfjbzQIzfb3HHDnuC4EL5Kz4jBHLiCyOb+tI0m2qhZ9evAM+Jv1z0NVa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg==",
14      "contact_id_doc_copy" : "jTpGmxUX3FBWVQ5NJTZvvDujqhThn4ReFxikqJ5YW6zFQ",
15      "contact_id_doc_copy_back" : "jTpGmxUX3FBWVQ5NJTZvvDujqhThn4ReFxikqJ5YW6zFQ",
16      "contact_id_doc_period_begin" : "2019-06-06",
17      "contact_id_doc_period_end" : "2026-06-06",
18      "mobile_phone" : "pVd1HJ6zyvPedzGaV+X3qtmrq9bb9tPROvwia4ibL+F6mfjbzQIzfb3HHLEjZ4YiNWWNeespQO/0kjiwfqdfg=="
19    }
20  }'
21

应答参数

200 OK

 apply_id  选填   string(64)

【申请单号】 微信支付分配的申请单号

应答示例

200 OK

1{
2  "apply_id" : "20220617143306000013906025001"
3}
4

 

错误码

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

状态码

错误码

描述

解决方案

400

PARAM_ERROR

参数错误

请根据错误提示正确传入参数

400

INVALID_REQUEST

HTTP 请求不符合微信支付 APIv3 接口规则

请参阅 接口规则

401

SIGN_ERROR

验证不通过

请参阅 签名常见问题

500

SYSTEM_ERROR

系统异常,请稍后重试

请稍后重试

 

反馈
目录
置顶