提交申请单

更新时间:2024.11.28

电商平台,可使用该接口,帮助其二级商户进件成为微信支付商户。

流程指引请看二级商户进件流程

注意

  1. 商户上送敏感信息时需要使用微信支付公钥加密(推荐),请参考获取微信支付公钥ID说明以及微信支付公钥加密敏感信息指引,也可以使用微信支付平台证书公钥加密,参考获取平台证书序列号平台证书加密敏感信息指引

  2. 微信支付平台证书公钥需调用接口获取,详见获取文档

  3. 调用接口获取的微信支付平台证书,证书需要解密后才能使用,详见解密说明文档

  4. 本接口不支持进件境外个人小微商户

接口说明

支持商户:【平台商户】

请求方式:【POST】/v3/ecommerce/applyments/

请求域名:【主域名】https://api.mch.weixin.qq.com 使用该域名将访问就近的接入点

     【备域名】https://api2.mch.weixin.qq.com 使用该域名将访问异地的接入点 ,指引点击查看

接口频率: 15QPS(商户号维度)

是否支持幂等:

请求参数

Header HTTP头参数

Authorization  必填 string

请参考签名认证生成认证信息


Accept  必填 string

请设置为application/json


Content-Type  必填 string

请设置为application/json


Wechatpay-Serial  必填 string

请求参数中的敏感字段,需要使用微信支付公钥加密(推荐),请参考获取微信支付公钥ID说明以及微信支付公钥加密敏感信息指引,也可以使用微信支付平台证书公钥加密,参考获取平台证书序列号平台证书加密敏感信息指引


body 包体参数

out_request_no  必填 string(124)

【业务申请编号 】 1、服务商自定义的商户唯一编号。
2、每个编号对应一个申请单,每个申请单审核通过后会生成一个微信支付商户号。
3、若申请单被驳回,可填写相同的“业务申请编号”,即可覆盖修改原申请单信息 。


organization_type  必填 string(4)

【主体类型】
非小微的主体类型需与营业执照/登记证书上一致,可参考选择主体指引,枚举值如下。
2401:小微商户,指无营业执照的个人商家。
2500:个人卖家,指无营业执照,已持续从事电子商务经营活动满6个月,且期间经营收入累计超过20万元的个人商家。(若选择该主体,请在“补充说明”填写相关描述)。
4:个体工商户,营业执照上的主体类型一般为个体户、个体工商户、个体经营。
2:企业,营业执照上的主体类型一般为有限公司、有限责任公司。
3:事业单位,包括国内各类事业单位,如:医疗、教育、学校等单位。
2502:政府机关,包括各级、各类政府机关,如机关党委、税务、民政、人社、工商、商务、市监等。
1708:社会组织,包括社会团体、民办非企业、基金会、基层群众性自治组织、农村集体经济组织等组织。


finance_institution  选填 boolean

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

若未传入将默认填写:false。


business_license_info  选填 object

【营业执照信息】

1、主体为“小微/个人卖家”时,不填。
2、主体为“个体工商户/企业”时,请上传营业执照。
3、主体为“政府机关/事业单位/社会组织”时,请上传登记证书。

属性

finance_institution_info  选填 object

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

属性

id_holder_type  选填 string

【证件持有人类型】 1. 主体类型为政府机关/事业单位时选传:
(1)若上传的是法人证件,则不需要上传该字段。
(2)若因政策保密等原因,无法提供法人证件时,可上传经办人。 (经办人:经商户授权办理微信支付业务的人员,授权范围包括但不限于签约,入驻过程需完成账户验证)。
2. 主体类型为企业/个体户/社会组织时,默认为经营者/法人,不需要上传该字段。

可选取值

  • LEGAL: 法人

  • SUPER: 经办人


id_doc_type  选填 string

【经营者/法人证件类型】

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

可选取值

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

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

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

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

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

  • IDENTIFICATION_TYPE_FOREIGN_RESIDENT: 外国人居留证

  • IDENTIFICATION_TYPE_HONGKONG_MACAO_RESIDENT: 港澳居民证

  • IDENTIFICATION_TYPE_TAIWAN_RESIDENT: 台湾居民证


authorize_letter_copy  选填 string

【法定代表人说明函】

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


id_card_info  选填 object

【经营者/法人身份证信息】 当证件持有人类型为经营者/法人且证件类型为“身份证”时填写。

属性

id_doc_info  选填 object

【经营者/法人其他类型证件信息】

当证件持有人类型为经营者/法人且证件类型不为“身份证”时填写。

属性

owner  选填 boolean

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


ubo_info_list  选填 array

【最终受益人信息列表】

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

属性

account_info  必填 object

【结算账户信息】 请填写商家提现收款的银行账户信息。

属性

contact_info  必填 object

【超级管理员信息】 请填写店铺的超级管理员信息。
超级管理员需在开户后进行签约,并可接收日常重要管理信息和进行资金操作,请确定其为商户法定代表人或负责人。

属性

sales_scene_info  必填 object

【经营场景信息】 请填写经营场景信息

属性

settlement_info  选填 object

【结算规则】

请填写商家的结算费率规则、所属行业等信息。若电商平台未传入,系统将填写默认值

属性

merchant_shortname  必填 string(64)

【商户简称】

UTF-8格式,中文占3个字节,即最多21个汉字长度。将在支付完成页向买家展示,需与商家的实际售卖商品相符 。


qualifications  选填 string(1024)

【特殊资质】 1、仅当商户选择了必需提交特殊资质的行业时,需要提供该项资料;若商户选择了无需特殊资质的行业,或未选择行业时,无需提交该项资料,详情查看《行业对应特殊资质》
2、请提供为“申请商家主体”所属的特殊资质,可授权使用总公司/分公司的特殊资质;
3、最多可上传5张照片,请填写通过图片上传API预先上传图片生成好的MediaID 。


business_addition_pics  选填 string(1024)

【补充材料】

根据实际审核情况,额外要求提供。最多可上传15张照片,请填写通过图片上传API预先上传图片生成好的MediaID 。


business_addition_desc  选填 string(512)

【补充说明】

若主体为“个人卖家”,该字段必传,则需填写描述“ 该商户已持续从事电子商务经营活动满6个月,且期间经营收入累计超过20万元。

请求示例

POST

1{
2    "out_request_no" : "APPLYMENT_00000000001",
3    "organization_type" : "2",
4    "finance_institution" : true,
5    "business_license_info" : {
6      "cert_type" : "CERTIFICATE_TYPE_2388",
7      "business_license_copy" : "47ZC6GC-vnrbEny__Ie_An5-tCpqxucuxi-vByf3Gjm7KE53JXvGy9tqZm2XAUf-4KGprrKhpVBDIUv0OF4wFNIO4kqg05InE4d2I6_H7I4",
8      "business_license_number" : "123456789012345678",
9      "merchant_name" : "腾讯科技有限公司",
10      "legal_person" : "张三",
11      "company_address" : "深圳南山区科苑路",
12      "business_time" : "[\\\"2014-01-01\\\",\\\"长期\\\"]"
13    },
14    "finance_institution_info" : {
15      "finance_type" : "BANK_AGENT",
16      "finance_license_pics" : [
17        "example_finance_license_pics"
18      ]
19    },
20    "id_holder_type" : "LEGAL",
21    "id_doc_type" : "IDENTIFICATION_TYPE_MAINLAND_IDCARD",
22    "authorize_letter_copy" : "47ZC6GC-vnrbEny_Ie_An5-tCpqxucuxi-vByf3Gjm7KEIUv0OF4wFNIO4kqg05InE4d2I6_H7I4",
23    "id_card_info" : {
24      "id_card_copy" : "jTpGmxUX3FBWVQ5NJTZvlKX_gdU4cRz7z5NxpnFuAxhBTEO_PvWkfSCJ3zVIn001D8daLC-ehEuo0BJqRTvDujqhThn4ReFxikqJ5YW6zFQ",
25      "id_card_national" : "47ZC6GC-vnrbEny__Ie_An5-tCpqxucuxi-vByf3Gjm7KE53JXvGy9tqZm2XAUf-4KGprrKhpVBDIUv0OF4wFNIO4kqg05InE4d2I6_H7I4",
26      "id_card_name" : "pVd1HJ6zyvPedzGaV+X3qtmrq9bb9tPROvwia4ibL+F6mfjbzQIzfb3HHLEjZ4YiR/cJiCrZxnAqi+pjeKIEdkwzXRAI7FUhrfPK3SNjaBTEu9GmsugMIA9r3x887Q+ODuC8HH2nzAn7NGpE/e3yiHgWhk0ps5k5DP/2qIdGdONoDzZelrxCl/NWWNUyB93K9F+jC1JX2IMttdY+aQ6zBlw0xnOiNW6Hzy7UtC+xriudjD5APomty7/mYNxLMpRSvWKIjOv/69bDnuC4EL5Kz4jBHLiCyOb+tI0m2qhZ9evAM+Jv1z0NVa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg==",
27      "id_card_number" : "AOZdYGISxo4y44/UgZ69bdu9X+tfMUJ9dl+LetjM45/zMbrYu+wWZ8gn4CTdo+D/m9MrPg+V4sm73oxqdQu/hj7aWyDl4GQtPXVdaztB9jVbVZh3QFzV+BEmytMNQp9dt1uWJktlfdDdLR3AMWyMB377xd+m9bSr/ioDTzagEcGe+vLYiKrzcroQv3OR0p3ppFYoQ3IfYeU/04S4t9rNFL+kyblK2FCCqQ11NdbbHoCrJc7NV4oASq6ZFonjTtgjjgKsadIKHXtb3JZKGZjduGdtkRJJp0/0eow96uY1Pk7Rq79Jtt7+I8juwEc4P4TG5xzchG/5IL9DBd+Z0zZXkw==",
28      "id_card_valid_time_begin" : "2019-06-06",
29      "id_card_valid_time" : "2026-06-06"
30    },
31    "id_doc_info" : {
32      "id_doc_name" : "jTpGmxUX3FBWVQ5NJTZvlKX_gdU4cRz7z5NxpnFuAxhBTEO_PvWkfSCJ3zVIn001D8daLC-ehEuo0BJqRTvDujqhThn4ReFxikqJ5YW6zFQ",
33      "id_doc_number" : "jTpGmxUX3FBWVQ5NJTZvlKX_gdU4cRz7z5NxpnFuAxhBTEO_PvWkfSCJ3zVIn001D8daLC-ehEuo0BJqRTvDujqhThn4ReFxikqJ5YW6zFQ",
34      "id_doc_copy" : "47ZC6GC-vnrbEny__Ie_An5-tCpqxucuxi-vByf3Gjm7KE53JXvGy9tqZm2XAUf-4KGprrKhpVBDIUv0OF4wFNIO4kqg05InE4d2I6_H7I4",
35      "id_doc_copy_back" : "47ZC6GC-vnrbEny__Ie_An5-tCpqxucuxi-vByf3Gjm7KE53JXvGy9tqZm2XAUf-4KGprrKhpVBDIUv0OF4wFNIO4kqg05InE4d2I6_H7I4",
36      "doc_period_begin" : "2019-06-06",
37      "doc_period_end" : "2020-01-02"
38    },
39    "owner" : true,
40    "account_info" : {
41      "bank_account_type" : "75",
42      "account_bank" : "工商银行",
43      "account_name" : "AOZdYGISxo4y44/UgZ69bdu9X+tfMUJ9dl+LetjM45/zMbrYu+wWZ8gn4CTdo+D/m9MrPg+V4sm73oxqdQu/hj7aWyDl4GQtPXVdaztB9jVbVZh3QFzV+BEmytMNQp9dt1uWJktlfdDdLR3AMWyMB377xd+m9bSr/ioDTzagEcGe+vLYiKrzcroQv3OR0p3ppFYoQ3IfYeU/04S4t9rNFL+kyblK2FCCqQ11NdbbHoCrJc7NV4oASq6ZFonjTtgjjgKsadIKHXtb3JZKGZjduGdtkRJJp0/0eow96uY1Pk7Rq79Jtt7+I8juwEc4P4TG5xzchG/5IL9DBd+Z0zZXkw==",
44      "bank_address_code" : "110000",
45      "bank_branch_id" : "402713354941",
46      "bank_name" : "施秉县农村信用合作联社城关信用社",
47      "account_number" : "d+xT+MQCvrLHUVDWv/8MR/dB7TkXM2YYZlokmXzFsWs35NXUot7C0NcxIrUF5FnxqCJHkNgKtxa6RxEYyba1+VBRLnqKG2fSy/Y5qDN08Ej9zHCwJjq52Wg1VG8MRugli9YMI1fI83KGBxhuXyemgS/hqFKsfYGiOkJqjTUpgY5VqjtL2N4l4z11T0ECB/aSyVXUysOFGLVfSrUxMPZy6jWWYGvT1+4P633f+R+ki1gT4WF/2KxZOYmli385ZgVhcR30mr4/G3HBcxi13zp7FnEeOsLlvBmI1PHN4C7Rsu3WL8sPndjXTd75kPkyjqnoMRrEEaYQE8ZRGYoeorwC+w=="
48    },
49    "contact_info" : {
50      "contact_type" : "65",
51      "contact_name" : "pVd1HJ6zyvPedzGaV+X3qtmrq9bb9tPROvwia4ibL+F6mfjbzQIzfb3HHLEjZ4YiR/cJiCrZxnAqi+pjeKIEdkwzXRAI7FUhrfPK3SNjaBTEu9GmsugMIA9r3x887Q+ODuC8HH2nzAn7NGpE/e3yiHgWhk0ps5k5DP/2qIdGdONoDzZelrxCl/NWWNUyB93K9F+jC1JX2IMttdY+aQ6zBlw0xnOiNW6Hzy7UtC+xriudjD5APomty7/mYNxLMpRSvWKIjOv/69bDnuC4EL5Kz4jBHLiCyOb+tI0m2qhZ9evAM+Jv1z0NVa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg==",
52      "contact_id_doc_type" : "IDENTIFICATION_TYPE_MAINLAND_IDCARD",
53      "contact_id_card_number" : "pVd1HJ6zyvPedzGaV+X3qtmrq9bb9tPROvwia4ibL+F6mfjbzQIzfb3HHLEjZ4YiR/cJiCrZxnAqi+pjeKIEdkwzXRAI7FUhrfPK3SNjaBTEu9GmsugMIA9r3x887Q+ODuC8HH2nzAn7NGpE/e3yiHgWhk0ps5k5DP/2qIdGdONoDzZelrxCl/NWWNUyB93K9F+jC1JX2IMttdY+aQ6zBlw0xnOiNW6Hzy7UtC+xriudjD5APomty7/mYNxLMpRSvWKIjOv/69bDnuC4EL5Kz4jBHLiCyOb+tI0m2qhZ9evAM+Jv1z0NVa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg==",
54      "contact_id_doc_copy" : "jTpGmxUX3FBWVQ5NJTZvvDujqhThn4ReFxikqJ5YW6zFQ",
55      "contact_id_doc_copy_back" : "jTpGmxUX3FBWVQ5NJTZvvDujqhThn4ReFxikqJ5YW6zFQ",
56      "contact_id_doc_period_begin" : "2019-06-06",
57      "contact_id_doc_period_end" : "2026-06-06",
58      "business_authorization_letter" : "47ZC6GC-vnrbEny_Ie_An5-tCpqxucuxi-vByf3Gjm7KEIUv0OF4wFNIO4kqg05InE4d2I6_H7I4",
59      "mobile_phone" : "pVd1HJ6zyvPedzGaV+X3qtmrq9bb9tPROvwia4ibL+F6mfjbzQIzfb3HHLEjZ4YiR/cJiCrZxnAqi+pjeKIEdkwzXRAI7FUhrfPK3SNjaBTEu9GmsugMIA9r3x887Q+ODuC8HH2nzAn7NGpE/e3yiHgWhk0ps5k5DP/2qIdGdONoDzZelrxCl/NWWNUyB93K9F+jC1JX2IMttdY+aQ6zBlw0xnOiNW6Hzy7UtC+xriudjD5APomty7/mYNxLMpRSvWKIjOv/69bDnuC4EL5Kz4jBHLiCyOb+tI0m2qhZ9evAM+Jv1z0NVa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg==",
60    },
61    "sales_scene_info" : {
62      "store_name" : "爱烧烤",
63      "store_url" : "http://www.qq.com",
64      "store_qr_code" : "jTpGmxUX3FBWVQ5NJTZvlKX_gdU4cRz7z5NxpnFuAxhBTEO_PvWkfSCJ3zVIn001D8daLC-ehEuo0BJqRTvDujqhThn4ReFxikqJ5YW6zFQ",
65      "mini_program_sub_appid" : "wxa123344545577"
66    },
67    "settlement_info" : {
68      "settlement_id" : 719,
69      "qualification_type" : "零售批发/生活娱乐/其他",
70    },
71    "merchant_shortname" : "腾讯",
72    "qualifications" : "[\"jTpGmxUX3FBWVQ5NJTZvlKX_gdU4cRz7z5NxpnFuAxhBTEO_PvWkfSCJ3zVIn001D8daLC-ehEuo0BJqRTvDujqhThn4ReFxikqJ5YW6zFQ\",\"47ZC6GC-vnrbEny__Ie_An5-tCpqxucuxi-vByf3Gjm7KE53JXvGy9tqZm2XAUf-4KGprrKhpVBDIUv0OF4wFNIO4kqg05InE4d2I6_H7I4\"]",
73    "business_addition_pics" : "[\"jTpGmxUX3FBWVQ5NJTZvlKX_gdU4cRz7z5NxpnFuAxhBTEO_PvWkfSCJ3zVIn001D8daLC-ehEuo0BJqRTvDujqhThn4ReFxikqJ5YW6zFQ\",\"47ZC6GC-vnrbEny__Ie_An5-tCpqxucuxi-vByf3Gjm7KE53JXvGy9tqZm2XAUf-4KGprrKhpVBDIUv0OF4wFNIO4kqg05InE4d2I6_H7I4\"]",
74    "business_addition_desc" : "特殊情况,说明原因",
75    "ubo_info_list" : [
76      {
77        "ubo_id_doc_type" : "IDENTIFICATION_TYPE_MAINLAND_IDCARD",
78        "ubo_id_doc_copy" : "jTpGmxUXqRTvDujqhThn4ReFxikqJ5YW6zFQ",
79        "ubo_id_doc_copy_back" : "jTpGmxUX3FBWVQ5NJTZvvDujqhThn4ReFxikqJ5YW6zFQ",
80        "ubo_id_doc_name" : "AOZdYGISxo4y44/Ug4P4TG5xzchG/5IL9DBd+Z0zZXkw==",
81        "ubo_id_doc_number" : "AOZdYGISxo4y44/Ug4P4TG5xzchG/5IL9DBd+Z0zZXkw==",
82        "ubo_id_doc_address" : "pVd1HJ6zyvPedzGaV+X3qtmrq9bb9tPROvwia4ibL+F6mfjbzQIzfb3HHLEjZ4YiR/cJiCrZxnAqi+pjeKIEdkwzXRAI7FUhrfPK3SNjaBTEu9GmsugMIA9r3x887Q+ODuC8HH2nzAn7NGpE/e3yiHgWhk0ps5k5DP/2qIdGdONoDzZelrxCl/NWWNUyB93K9F+jC1JX2IMttdY+aQ6zBlw0xnOiNW6Hzy7UtC+xriudjD5APomty7/mYNxLMpRSvWKIjOv/69bDnuC4EL5Kz4jBHLiCyOb+tI0m2qhZ9evAM+Jv1z0NVa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg==",
83        "ubo_id_doc_period_begin" : "2019-06-06",
84        "ubo_id_doc_period_end" : "2026-06-06"
85      }
86    ]
87  }'

应答参数

200 OK

applyment_id  必填 integer

【微信支付申请单号】

微信支付分配的申请单号 。


out_request_no  必填 string

【业务申请编号】

服务商自定义的商户唯一编号。每个编号对应一个申请单,每个申请单审核通过后会生成一个微信支付商户号。

应答示例

200 OK

1{
2  "applyment_id" : 2000002124775691,
3  "out_request_no" : "APPLYMENT_00000000001"
4}
5

 

错误码

公共错误码

状态码

错误码

描述

解决方案

400

PARAM_ERROR

参数错误

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

400

INVALID_REQUEST

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

请参阅 接口规则

401

SIGN_ERROR

验证不通过

请参阅 签名常见问题

500

SYSTEM_ERROR

系统异常,请稍后重试

请稍后重试

业务错误码

状态码

错误码

描述

解决方案

400

RESOURCE_ALREADY_EXISTS

存在流程进行中的申请单,请检查是否重入

可通过查询申请状态查看此申请单的申请状态,或更换out_request_no提交新的申请单

403

NO_AUTH

商户权限异常

请确认是否已经开通相关权限

404

RESOURCE_NOT_EXISTS

申请单不存在

确认入参,传入正确的申请单编号

 

 

反馈
咨询
目录
置顶