# Submit payment qualifications
Submission of credentials using the new version is required after 2022-06-30:
The difference between new and old versions:
- New version applyment_version needs to be set to 1
- Settle_acct_info Settlement account information required
- ID_card_info.address Identity card Address required
- If the super management is the agent, the super management needs to supplement the body documents, under the super_administrator_info structure contact_id_doc_type,contact_id_doc_copy,contact_id_doc_copy_back,contact_id_doc_period_begin,contact_id_doc_period_end,business_authorization_letter Required
# Dxplaination of Interface Call Request
http请求方式：POST
https://api.weixin.qq.com/product/register/submit_merchantinfo?access_token=xxxxxxxxx
# Dxplaination of request parameters
| parameter | type | Is it compulsory? | Introductions |
|---|---|---|---|
| appid | string | yes | |
| subject_type | string | yes | 主体类型 "4"：个体工商户，营业执照上的主体类型一般为个体户、个体工商户、个体经营。 "2"：企业，营业执照上的主体类型一般为有限公司、有限责任公司。 |
| busi_license | object | yes | Business license / registration certificate information |
| organization_code_info | object | no | Organization code certification information |
| id_card_info | object | yes | ID |
| super_administrator_info | object | yes | Superintendent Information Please fill in the store's superintendent information.Super managers need to sign up after opening an account, and can receive daily important management information and capital operations, please identify them as the merchant's legal representative or responsible person. |
| merchant_shortname | string | yes | Merchants referred to as UTF-8 format, Chinese accounts for 3 bytes, that is, up to 16 characters length. will be displayed to the buyer on the payment completion page, which needs to match the actual goods sold by the merchant.Example value: Tencent |
| special_qualification | object | no | 特殊资质 1、根据商户经营业务要求提供相关资质，详情查看《行业对应特殊资质》。 2、请提供为“申请商家主体”所属的特殊资质，可授权使用总公司/分公司的特殊资 质； 3、最多可上传5张照片，请填写通过图片上传接口预先上传图片生成好的MediaID 。 |
| supplementary_material | object | no | Supplementary materials |
| supplementary_desc | string | no | Additional description |
| settle_acct_info | object | yes | Settlement Account Information |
| applyment_version | number | no | Payment Authorization Version Number, default 0, 2022-06-30 All must be filled in at a later date |
# busi_license
| parameter | type | Is it compulsory? | Introductions |
|---|---|---|---|
| license_type | number | yes | Type of business licence 1: Three licenses combined 2: Ordinary business licence |
| pic_file | object | yes | Business license picture |
| registration_num | string | yes | 请填写营业执照上的注册号/统一社会信用代码， 须为15位数字或18位数字大写字母。 示例值：123456789012345678 特殊规则：长度最小15个字节 |
| merchant_name | string | yes | 1、请填写营业执照/登记证书的商家名称，2~110个字符，支持括号 2、个体工商户/党政、机关及事业单位，不能以“公司”结尾。 3、个体工商户，若营业执照上商户名称为空或为“无”，请填写"个体户+经营者姓名"， 如“个体户张三” 。示例值：腾讯科技有限公司 |
| legal_representative | string | yes | Please fill in the name of the registered operator / legal representative. Example value: Zhang 3 |
| registered_addrs | string | no | Registered address |
| start_date | string | yes | Date of registration, format: 2014-01-01 |
| end_date | string | yes | 结束有效期，格式：2014-01-01 1、若证件有效期为长期，请填写：长期。 2、结束时间需大于开始时间。 3、有效期必须大于60天，即结束时间距当前时间需超过60天。 |
# pic_file
| parameter | type | Is it compulsory? | Introductions |
|---|---|---|---|
| media_id | string | yes | Media_id, where incoming content is obtained via the upload image interface |
| pay_media_id | string | yes | Pay for media_id, where incoming content is obtained via the upload image interface |
# organization_code_info
| parameter | type | Is it compulsory? | Introductions |
|---|---|---|---|
| pic_file | object | yes | Graphic of organizational code certification |
| organization_code | string | yes | 1. Please complete the organizational code on the organizational codes card. 2. You can fill in 9 or 10 digits\ letters\ hyphen.Example value: 12345679-A |
| start_date | string | yes | Date of registration, format: 2014-01-01 |
| end_date | string | yes | 结束有效期，格式：2014-01-01 1、若证件有效期为长期，请填写：长期。 2、结束时间需大于开始时间。 3、有效期必须大于60天，即结束时间距当前时间需超过60天。 |
# id_card_info
| parameter | type | Is it compulsory? | Introductions |
|---|---|---|---|
| portrait_pic_file | object | yes | Portrait photo, same format as pic_file |
| nation_pic_file | object | yes | Photo of the national emblem in the same format as pic_file |
| id_card_name | string | yes | Please fill in the name of the operator / legal representative for the corresponding identity card, 2 to 30 Chinese characters, English characters, and symbols. |
| id_card_number | string | yes | Please fill in the number of the operator / legal representative's corresponding identity card |
| start_date | string | yes | Date of registration, format: 2014-01-01 |
| end_date | string | yes | 结束有效期，格式：2014-01-01 1、若证件有效期为长期，请填写：长期。 2、结束时间需大于开始时间。 3、有效期必须大于60天，即结束时间距当前时间需超过60天。 |
| address | string | yes | Identity card where you live |
# super_administrator_info
| parameter | type | Is it compulsory? | Introductions |
|---|---|---|---|
| type | string | yes | 个体工商户/企业/党政、机关及事业单位/其他组织，可选择：65-法人/经营者、66- 负责人。 （负责人：经商户授权办理微信支付业务的人员，授权范围包括但不限于签约，入驻过程需完成账户验证）。 示例值：65 |
| name | string | yes | (1) If the type of administrator is "legal person," then the name must be consistent with the name of the legal person's identity card. 2. If the administrator type is "agent," the name of the actual agent can be filled in. |
| id_card_number | number | yes | 1、若管理员类型为法人，则该身份证号码需与法人身份证号码一致。若管理员类型为经办人， 则可填写实际经办人的身份证号码。 2、可传身份证、来往内地通行证、来往大陆通行证、护照等证件号码。 3、超级管理员签约时，校验微信号绑定的银行卡实名信息，是否与该证件号码一致。 |
| phone | number | yes | Please fill in the manager's mobile number, 11 digits, used to receive WeChat payment important management information and daily operation verification code. |
| string | yes | 1, for receiving WeChat payment account opening mail and daily business notification. 2, need to take @, follow the mailbox format verification. | |
| contact_id_doc_type | string | no | Certificate type, type = 66 when required, currently only support identity card, fill in "IDENTIFICATION_TYPE_MAINLAND_IDCARD" |
| contact_id_doc_copy | object | no | Photo on the front of the ID, required at type = 66 |
| contact_id_doc_copy_back | object | no | Photo on the reverse side of the document, required when type = 66 |
| contact_id_doc_period_begin | string | no | Document start time, required at type = 66 |
| contact_id_doc_period_end | string | no | Certificate end time, required at type = 66 |
| business_authorization_letter | object | no | Business authorization letter picture, type = 66 required |
# special_qualification
| parameter | type | Is it compulsory? | Introductions |
|---|---|---|---|
| pic_file_list | Array|yes | An array of images medieid, each in the same format as pic_file |
# supplementary_material
| parameter | type | Is it compulsory? | Introductions |
|---|---|---|---|
| pic_file_list | Array|yes | An array of images medieid, each in the same format as pic_file |
# settle_acct_info
| parameter | type | Is it compulsory? | Introductions |
|---|---|---|---|
| acct_type | string | yes | Type of account: 74 pairs of public accounts; 75 private accounts |
| bank | string | yes | Open Bank Open Bank Comparison Table |
| name | string | yes | The name of the account, which is consistent with the identity card for private use and the "merchant name" on the business license for public use |
| province_city_code | string | yes | Provincial and municipal code, at least accurate to the city, see Provincial and municipal code comparison table |
| full_name | string | no | Full Name of Open Bank (including Branches) Comparison Table |
| bank_account_no | string | yes | Bank account |
# Example of request parameters
{
"appid": "xxx",
"subject_type": "营业执照/登记证书信息",
"busi_license":
{
"license_type": 1,
"pic_file":
{
"media_id": "xlvjalsdhgas",
"pay_media_id": "asdgasvdadfa"
},
"registration_num": "证件注册号",
"merchant_name": "商户名称",
"legal_representative": "法定代表人",
"registered_addrs": "注册地址",
"start_date": "注册日期",
"end_date": "有效期至"
},
"organization_code_info":
{
"pic_file":
{
"media_id": "xlvjalsdhgas",
"pay_media_id": "asdgasvdadfa"
},
"organization_code": "组织机构代码",
"start_date": "注册日期",
"end_date": "有效期至"
},
"id_card_info":
{
"portrait_pic_file"：
{
"media_id": "xlvjalsdhgas",
"pay_media_id": "asdgasvdadfa"
},
"nation_pic_file"：
{
"media_id": "xlvjalsdhgas",
"pay_media_id": "asdgasvdadfa"
},
"id_card_name": "张三",
"id_card_number": "121321412",
"start_date": "注册日期",
"end_date": "有效期至"
},
"super_administrator_info":
{
"type": "类型",
"name": "姓名",
"id_card_number": "身份证件号码",
"phone": "手机号",
"mail": "邮箱"
},
"merchant_shortname": "商户简称",
"special_qualification":
{
"pic_file_list":
[
{
"media_id": "xlvjalsdhgas",
"pay_media_id": "asdgasvdadfa"
}
]
},
"supplementary_material":
{
"pic_file_list":
[
{
"media_id": "xlvjalsdhgas",
"pay_media_id": "asdgasvdadfa"
}
]
},
"supplementary_desc": "补充描述"
}
# Dxplaination of callback parameters
| parameter | type | Introductions |
|---|---|---|
| errcode | number | Error code |
| errmsg | string | Error message |
# Examples of back-up
{
"errcode": 0,
"errmsg":"ok"
}
# Return code
| Return code | Error Type |
|---|---|
| -1 | System exceptions |
| -2 | Token too long |
| 400 | The parameter is wrong. Please use the correct parameter to re-invoke |
| 429 | Please reduce the frequency of the call |
| 10005 | Real name verification failed, identity card, name and WeChat number real name do not match |