提交申请单

更新时间：2025.03.31

服务商使用该接口提交商家主体资料变更申请，帮助商家修改主体资料。

接口说明

支持商户：【普通服务商】　【平台商户】

请求方式：【POST】/v3/mchalterapply/mchsubjectalterapplyment

请求域名：【主域名】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. 请填写本服务商负责进件的特约商户/二级商户号。

微信支付分配的特约商户的唯一标识。

out_request_no 　必填 string(64)

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

organization_type 　必填 string

【主体类型】主体类型需与营业执照/登记证书上一致，可参考选择主体指引

可选取值

SUBJECT_TYPE_ENTERPRISE: 企业，营业执照上的主体类型一般为有限公司、有限责任公司
SUBJECT_TYPE_INSTITUTIONS_CLONED: 事业单位，包括国内各类事业单位，如：医疗、教育、学校等单位
SUBJECT_TYPE_INDIVIDUAL: 个体工商户，营业执照上的主体类型一般为个体户、个体工商户、个体经营
SUBJECT_TYPE_OTHERS: 社会组织，包括社会团体、民办非企业、基金会、基层群众性自治组织、农村集体经济组织等组织
SUBJECT_TYPE_GOVERNMENT: 政府机关，包括各级、各类政府机关，如机关党委、税务、民政、人社、工商、商务、市监等
SUBJECT_TYPE_MICRO: 小微商户或个人卖家，无营业执照、免办理工商注册登记的实体商户

finance_institution 　必填 boolean

【是否金融机构】必填，请根据申请主体的实际情况填写，可参考选择金融机构指引：
1、若商户主体是金融机构，则填写：true。
2、若商户主体不是金融机构，则填写：false

business_license_info 　选填 object

【营业执照信息】主体类型为企业/个体户时，营业执照信息必填。

属性

license_number 　必填 string(32)

【营业执照注册号】 1、主体为“个体工商户”时，请填写营业执照上的注册号/统一社会信用代码，格式需满足以下任一条件：
-15位数字
-18位阿拉伯数字或大写英文字母（不得包含英文字母I/O/Z/S/V），并且以9开头
2、主体为“企业”时，请填写营业执照上的注册号/统一社会信用代码，格式如下：
18位阿拉伯数字或大写英文字母（不得包含英文字母I/O/Z/S/V），并且以9开头

license_copy 　必填 string(256)

【营业执照照片】请填写通过《图片上传API》预先上传图片生成好的MediaID。

merchant_name 　必填 string(128)

【商户名称】 1、长度为2-128个字符
2、前后不能有空格、制表符、换行符
3、不能仅含数字、特殊字符
4、仅能填写数字、英文字母、汉字及特殊字符
5、仅支持utf-8格式
6、个体户证件为以下情况时，按照个体户XXX命名（XXX是营业执照经营人姓名）：营业执照登记名称为空、仅含数字、仅含特殊字符、“无”、“无字号”
7、个体户不能使用“企业”“公司”或“农民专业合作社”结尾

legal_person 　必填 string(100)

【法人姓名】请填写营业执照的经营者/法定代表人姓名：
1、长度为2-100个字符
2、前后不能有空格、制表符、换行符
3、不能仅含特殊字符
4、仅能填写数字、英文字母、汉字及特殊字符

company_address 　选填 string(512)

【注册地址】建议填写营业执照的注册地址，若该字段未填写，系统将会查询国家工商信息填入。需注意若工商信息查询不到，则会被审核驳回。
1、长度为4-512个字符
2、前后不能有空格、制表符、换行符
3、不能仅含数字、特殊字符
4、仅能填写数字、英文字母、汉字及特殊字符
5、仅支持utf-8格式

license_period_begin 　选填 string(128)

【有效期开始时间】建议填写营业执照的有效期限开始时间，若该字段未填写，系统将会查询国家工商信息填入。需注意若工商信息查询不到，则会被审核驳回。
1、日期格式应满足合法的yyyy-MM-DD格式
2、开始时间不能小于1900-01-01
3、开始时间不能大于等于当前日期

license_period_end 　选填 string(128)

【有效期结束时间】建议填写营业执照的有效期限结束时间，若该字段未填写，系统将会查询国家工商信息填入。需注意若工商信息查询不到，则会被审核驳回。
1、日期格式应满足合法的yyyy-MM-DD格式或长期
2、结束时间需大于开始时间

certificate_info 　选填 object

【登记证书信息】主体为政府机关/事业单位/社会组织时必填，登记证书信息必填。

属性

finance_institution_info 　选填 object

【金融机构许可证】当主体是金融机构时，必填

属性

finance_type 　必填 string

【金融机构类型】请根据申请主体的实际情况填写，可参考选择金融机构指引

可选取值

FINANCE_TYPE_BANK_AGENT: 银行业，适用于商业银行、政策性银行、农村合作银行、村镇银行、开发性金融机构等；
FINANCE_TYPE_PAYMENT_AGENT: 支付机构，适用于非银行类支付机构；
FINANCE_TYPE_INSURANCE: 保险业，适用于保险、保险中介、保险代理、保险经纪等保险类业务；
FINANCE_TYPE_TRADE_AND_SETTLE: 交易及结算类金融机构，适用于交易所、登记结算类机构、银行卡清算机构、资金清算中心等；
FINANCE_TYPE_OTHER: 其他金融机构，适用于财务公司、信托公司、金融资产管理公司、金融租赁公司、汽车金融公司、贷款公司、货币经纪公司、消费金融公司、证券业、金融控股公司、股票、期货、货币兑换、小额贷款公司、金融资产管理、担保公司、商业保理公司、典当行、融资租赁公司、财经咨询等其他金融业务。

finance_license_pics 　必填 array[string]

【金融机构许可证图片】 1、根据所属金融机构类型的许可证要求提供，详情查看金融机构指引。
2、请提供为“申请商家主体”所属的许可证，可授权使用总公司/分公司的特殊资质。
3、最多可上传5张照片，请填写通过《图片上传API》预先上传图片生成好的MediaID。

legal_person_info 　必填 object

【法人身份信息】法人身份信息

属性

id_holder_type 　必填 string

【证件持有人类型】

1. 主体类型为政府机关/事业单位时：
（1）若上传的是法人证件，则上传：经营者/法人
（2）若因特殊情况，无法提供法人证件时，可上传：经办人。（经办人：经商户授权办理微信支付业务的人员，授权范围包括但不限于签约，入驻过程需完成账户验证）。

2.主体类型为企业/个体户/社会组织/小微时，只能上传：经营者/法人证件持有人类型

可选取值

LEGAL: 经营者/法人，证件持有人类型-法人
SUPER: 经办人，证件持有人类型-经办人

id_doc_type 　选填 string

【证件类型】 1、当证件持有人类型为经营者/法人时，需要填写。其他情况，无需上传。
2、主体为“小微/个人卖家”，可选择：身份证。
3、主体为“个体户/企业/事业单位/社会组织”：可选择任一证件类型，主体为“政府机关”仅支持中国大陆居民-身份证类型。

可选取值

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: 台湾居民证

authorize_letter_copy 　选填 string(256)

【法定代表人说明函】 1、当证件持有人类型为经办人时，必须上传。其他情况，无需上传。
2、若因特殊情况，无法提供法定代表人证件时，请参照示例图打印法定代表人说明函，全部信息需打印，不支持手写商户信息，并加盖公章。
3、可上传1张图片，请填写通过《图片上传API》预先上传图片生成好的MediaID。

card_front 　选填 string(256)

【证件正面照片】 1、当证件持有人类型为法人时，请上传法人证件的正面照片。其他情况，无需上传。
2、若法人证件类型为身份证，请上传人像面照片。
3、请填写通过《图片上传API》预先上传图片生成好的MediaID

card_back 　选填 string(256)

【证件反面照片】 1、当证件持有人类型为法人时，请上传法人证件的反面照片。其他情况，无需上传。
2、若法人证件类型为身份证，请上传国徽面照片。
3、若证件类型为护照，无需上传反面照片。
4、请填写通过《图片上传API》预先上传图片生成好的MediaID。

card_name 　选填 string(100)

【证件姓名】1、当证件持有人类型为法人时，请填写法人证件上的证件号码。其他情况，无需填写。
2、长度为2-100个字符
3、前后不能有空格、制表符、换行符
4、不能仅含数字、特殊字符
5、仅能填写数字、英文字母、汉字及特殊字符
6、该字段需进行加密处理，加密方法详见敏感信息加密说明。

card_number 　选填 string(512)

【证件号码】 1、可传身份证、来往内地通行证、来往大陆通行证、护照等证件号码，号码规范如下：
身份证（限中国大陆居民)：17位数字+1位数字|X
护照（限境外人士）：4-15位数字|字母|连字符
中国香港居民--来往内地通行证：H/h开头+8或10位数字/字母
中国澳门居民--来往内地通行证：M/m开头+8或10位数字/字母
中国台湾居民--来往大陆通行证：8位数字或10位数字
外国人居留证：15位数字|字母
港澳居住证/台湾居住证：17位数字+1位数字|X
2、该字段需进行加密处理，加密方法详见敏感信息加密说明。

card_address 　选填 string(512)

【证件居住地址】 1、当证件持有人类型为法人且主体类型为企业时，需要填写。
2、请按照身份证住址填写，如广东省深圳市南山区xx路xx号xx室
3、长度为4-512个字符
4、前后不能有空格、制表符、换行符
5、不能仅含数字、特殊字符
6、仅能填写数字、英文字母、汉字及特殊字符
7、仅支持utf-8格式
8、该字段需进行加密处理，加密方法详见敏感信息加密说明。

card_period_begin 　选填 string(128)

【证件有效期开始时间】 1、当证件持有人类型为法人时，需要填写。
2、日期格式应满足合法的yyyy-MM-DD格式
3、开始时间不能小于1900-01-01
4、开始时间不能大于等于当前日期

card_period_end 　选填 string(128)

【证件有效期结束时间】 1、当证件持有人类型为法人时，需要填写。
2、日期格式应满足合法的yyyy-MM-DD格式或长期
3、结束时间需大于开始时间

as_ubo 　选填 boolean

【经营者/法人是否为受益人】主体类型为企业时，需要填写：
1、若经营者/法人是最终受益人，则填写：true。
2、若经营者/法人不是最终受益人，则填写：false。

ubo_info_list 　选填 array[UboInfo]

【最终受益人信息列表】仅企业需要填写。
若经营者/法人不是最终受益所有人，则需提填写受益所有人信息，最多上传4个。
若经营者/法人是最终受益所有人之一，可在此填写其他受益所有人信息，最多上传3个。
根据国家相关法律法规，需要提供公司受益所有人信息，受益所有人需符合至少以下条件之一：
1、直接或者间接拥有超过25%公司股权或者表决权的自然人。
2、通过人事、财务等其他方式对公司进行控制的自然人。
3、公司的高级管理人员，包括公司的经理、副经理、财务负责人、上市公司董事会秘书和公司章程规定的其他人员。

属性

id_doc_type 　必填 string

【证件类型】请填写受益人的证件类型。

可选取值

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: 台湾居民证

card_front 　必填 string(256)

card_back 　选填 string(256)

card_name 　必填 string(100)

【证件姓名】 1、长度为2-100个字符
2、前后不能有空格、制表符、换行符
3、不能仅含数字、特殊字符
4、仅能填写数字、英文字母、汉字及特殊字符
5、该字段需进行加密处理，加密方法详见敏感信息加密说明。

card_number 　必填 string(512)

【证件号码】 1、当证件持有人类型为法人时，请填写法人证件上的姓名。其他情况，无需上传。
身份证（限中国大陆居民)：17位数字+1位数字|X，并通过校验码判断
护照（限境外人士）：4-15位数字|字母|连字符
中国香港居民--来往内地通行证：H/h开头+8或10位数字/字母
中国澳门居民--来往内地通行证：M/m开头+8或10位数字/字母
中国台湾居民--来往大陆通行证：8位数字或10位数字
外国人居留证：15位数字|字母
港澳居住证/台湾居住证：17位数字+1位数字|X
2、该字段需进行加密处理，加密方法详见敏感信息加密说明。

card_address 　必填 string(512)

【证件居住地址】 1、请按照身份证住址填写，如广东省深圳市南山区xx路xx号xx室
2、长度为4-512个字符
3、前后不能有空格、制表符、换行符
4、不能仅含数字、特殊字符
5、仅能填写数字、英文字母、汉字及特殊字符
6、仅支持utf-8格式
7、该字段需进行加密处理，加密方法详见敏感信息加密说明

card_period_begin 　必填 string(128)

【证件有效期开始时间】 1、日期格式应满足合法的yyyy-MM-DD格式
2、开始时间不能小于1900-01-01
3、开始时间不能大于等于当前日期

card_period_end 　必填 string(128)

【证件有效期结束时间】 1、日期格式应满足合法的yyyy-MM-DD格式或长期
2、结束时间需大于开始时间

addition 　选填 object

【补充材料列表】根据实际审核情况，额外要求商家提供指定的补充资料。

属性

请求示例

POST

1curl -X POST \
2  https://api.mch.weixin.qq.com/v3/mchalterapply/mchsubjectalterapplyment \
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  "business_license_info": {
9    "company_address": "广东省深圳市南山区xx路xx号",
10    "legal_person": "李四",
11    "license_copy": "0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV-4BBgVwtNkCHO_XXqK5dE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo",
12    "license_number": "914201123033363296",
13    "license_period_begin": "2019-06-06",
14    "license_period_end": "2026-06-06",
15    "merchant_name": "李四网络有限公司"
16  },
17  "certificate_info": {
18    "cert_copy": "0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV-4BBgVwtNkCHO_XXqK5dE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo",
19    "cert_number": "111111111111",
20    "cert_period_begin": "2019-06-06",
21    "cert_period_end": "2026-06-06",
22    "cert_type": "CERTIFICATE_TYPE_2388",
23    "company_address": "广东省深圳市南山区xx路xx号",
24    "legal_person": "李四",
25    "merchant_name": "xx公益团体"
26  },
27  "finance_institution": true,
28  "finance_institution_info": {
29    "finance_license_pics": [
30    "0P3ng6KTIW4-Q_l2FjmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo",
31    "0P3ng6KTIW4-Q_l2FjmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo"
32    ],
33    "finance_type": "FINANCE_TYPE_BANK_AGENT"
34  },
35  "legal_person_info": {
36    "as_ubo": true,
37    "authorize_letter_copy": "47ZC6GC-vnrbEny_Ie_An5-tCpqxucuxi-vByf3Gjm7KEIUv0OF4wFNIO4kqg05InE4d2I6_H7I4",
38    "card_address": "pVd1HJ6zyvPedzGaV+X3qtmrq9bb9tPROvwia4ibL+F6mfjbzQIzfb3HHLEjZ4YiR/cJiCrZxnAqi+pjeKIEdkwzXRAI7FUhrfPK3SNjaBTEu9GmsugMIA9r3x887Q+ODuC8HH2nzAn7NGpE/e3yiHgWhk0ps5k5DP/2qIdGdONoDzZelrxCl/NWWNUyB93K9F+jC1JX2IMttdY+aQ6zBlw0xnOiNW6Hzy7UtC+xriudjD5APomty7/mYNxLMpRSvWKIjOv/69bDnuC4EL5Kz4jBHLiCyOb+tI0m2qhZ9evAM+Jv1z0NVa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg==",
39    "card_back": "0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV-4BBgVwtNkCHO_XXqK5dE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo",
40    "card_front": "0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV-4BBgVwtNkCHO_XXqK5dE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo",
41    "card_name": "MZnwEx6zotwIz6ctW2/iQL5z94odwP9sKiF74RPCPztcJOScaXsaGs82HJNU3K+46ndk7pMrENiPDw==",
42    "card_number": "MZnwEx6zotwIz6ctW2/iQL5z94odwP9sKiF74RPCPztcJOScaXsaGs82HJNU3K+46ndk7pMrENiPDw==",
43    "card_period_begin": "2019-06-06",
44    "card_period_end": "2026-06-06",
45    "id_doc_type": "IDENTIFICATION_TYPE_IDCARD",
46    "id_holder_type": "LEGAL"
47  },
48  "merchant_code": "2492185251",
49  "organization_type": "SUBJECT_TYPE_ENTERPRISE",
50  "out_request_no": "1900013511_10000",
51  "ubo_info_list": [
52    {
53      "card_address": "pVd1HJ6zyvPedzGaV+X3qtmrq9bb9tPROvwia4ibL+F6mfjbzQIzfb3HHLEjZ4YiR/cJiCrZxnAqi+pjeKIEdkwzXRAI7FUhrfPK3SNjaBTEu9GmsugMIA9r3x887Q+ODuC8HH2nzAn7NGpE/e3yiHgWhk0ps5k5DP/2qIdGdONoDzZelrxCl/NWWNUyB93K9F+jC1JX2IMttdY+aQ6zBlw0xnOiNW6Hzy7UtC+xriudjD5APomty7/mYNxLMpRSvWKIjOv/69bDnuC4EL5Kz4jBHLiCyOb+tI0m2qhZ9evAM+Jv1z0NVa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg==",
54      "card_back": "0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV-4BBgVwtNkCHO_XXqK5dE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo",
55      "card_front": "0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV-4BBgVwtNkCHO_XXqK5dE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo",
56      "card_name": "MZnwEx6zotwIz6ctW2/iQL5z94odwP9sKiF74RPCPztcJOScaXsaGs82HJNU3K+46ndk7pMrENiPDw==",
57      "card_number": "MZnwEx6zotwIz6ctW2/iQL5z94odwP9sKiF74RPCPztcJOScaXsaGs82HJNU3K+46ndk7pMrENiPDw==",
58      "card_period_begin": "2019-06-06",
59      "card_period_end": "2026-06-06",
60      "id_doc_type": "IDENTIFICATION_TYPE_IDCARD"
61    }
62  ]
63}'
64

应答参数

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	系统异常，请稍后重试	请稍后重试

文档是否有帮助

更多支持

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