最新更新时间:2022.05.13 版本说明
电商平台,可使用该接口,帮助其二级商户进件成为微信支付商户。
流程指引请看二级商户进件流程
1. 商户上送敏感信息时使用微信支付平台公钥加密,证书序列号包含在请求HTTP头部的Wechatpay-Serial,详见接口规则
适用对象:电商平台
请求URL:https://api.mch.weixin.qq.com/v3/ecommerce/applyments/
请求方式:POST
接口频率:15QPS(商户号维度)
是否支持幂等:是
path 指该参数为路径参数
query 指该参数为URL参数
body 指该参数需在请求JSON传参
参数名 | 变量 | 类型[长度限制] | 必填 | 描述 |
---|---|---|---|---|
业务申请编号 | out_request_no | string[1,124] | 是 | body1、服务商自定义的商户唯一编号。 2、每个编号对应一个申请单,每个申请单审核通过后会生成一个微信支付商户号。 3、若申请单被驳回,可填写相同的“业务申请编号”,即可覆盖修改原申请单信息 。 示例值:APPLYMENT_00000000001 |
主体类型 | organization_type | string[1,4] | 是 | body非小微的主体类型需与营业执照/登记证书上一致,可参考选择主体指引,枚举值如下。 2401:小微商户,指无营业执照的个人商家。 2500:个人卖家,指无营业执照,已持续从事电子商务经营活动满6个月,且期间经营收入累计超过20万元的个人商家。(若选择该主体,请在“补充说明”填写相关描述)。 4:个体工商户,营业执照上的主体类型一般为个体户、个体工商户、个体经营。 2:企业,营业执照上的主体类型一般为有限公司、有限责任公司。 3:事业单位,包括国内各类事业单位,如:医疗、教育、学校等单位。 2502:政府机关,包括各级、各类政府机关,如机关党委、税务、民政、人社、工商、商务、市监等。 1708:社会组织,包括社会团体、民办非企业、基金会、基层群众性自治组织、农村集体经济组织等组织。 示例值:2 |
是否金融机构 | finance_institution | boolean | 条件选填 | body选填,请根据申请主体的实际情况填写,可参考选择金融机构指引: 1、若商户主体是金融机构,则填写:true。 2、若商户主体不是金融机构,则填写:false。 若未传入将默认填写:false。 示例值:true |
+ 营业执照/登记证书信息 | business_license_info | object | 条件选填 | body1、主体为“小微/个人卖家”时,不填。 2、主体为“个体工商户/企业”时,请上传营业执照。 3、主体为“政府机关/事业单位/社会组织”时,请上传登记证书。 |
+ 金融机构许可证信息 | finance_institution_info | object | 条件选填 | body当主体是金融机构时,必填 |
证件持有人类型 | id_holder_type | string | 条件选填 | body1. 主体类型为政府机关/事业单位时选传: (1)若上传的是法人证件,则不需要上传该字段。 (2)若因特殊情况,无法提供法人证件时,可上传经办人。 (经办人:经商户授权办理微信支付业务的人员,授权范围包括但不限于签约,入驻过程需完成账户验证)。 2. 主体类型为企业/个体户/社会组织时,默认为经营者/法人,不需要上传该字段。 LEGAL:法人 SUPER:经办人 示例值:LEGAL |
经营者/法人证件类型 | id_doc_type | string | 条件选填 | body1、当证件持有人类型为经营者/法人时,需要填写。其他情况,无需上传。 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:台湾居民证 示例值:IDENTIFICATION_TYPE_MAINLAND_IDCARD |
法定代表人说明函 | authorize_letter_copy | string[1,256] | 条件选填 | body1、当证件持有人类型为经办人时,必须上传。其他情况,无需上传。 2、若因特殊情况,无法提供法定代表人证件时,请参照示例图打印法定代表人说明函,全部信息需打印,不支持手写商户信息,并加盖公章。 3、可上传1张图片,请填写通过图片上传API预先上传图片生成好的MediaID。 示例值:47ZC6GC-vnrbEny_Ie_An5-tCpqxucuxi-vByf3Gjm7KEIUv0OF4wFNIO4kqg05InE4d2I6_H7I4 |
+ 经营者/法人身份证信息 | id_card_info | object | 条件选填 | body当证件持有人类型为经营者/法人且证件类型为“身份证”时填写。 |
+ 经营者/法人其他类型证件信息 | id_doc_info | object | 条件选填 | body当证件持有人类型为经营者/法人且证件类型不为“身份证”时填写。 |
经营者/法人是否为受益人 | owner | boolean | 条件选填 | body主体类型为企业时,需要填写: 1、若经营者/法人是最终受益人,则填写:true。 2、若经营者/法人不是最终受益人,则填写:false。 示例值:true |
+ 最终受益人信息列表 | ubo_info_list | array | 条件选填 | body仅企业需要填写。 若经营者/法人不是最终受益所有人,则需提填写受益所有人信息,最多上传4个。 若经营者/法人是最终受益所有人之一,可在此填写其他受益所有人信息,最多上传3个。 根据国家相关法律法规,需要提供公司受益所有人信息,受益所有人需符合至少以下条件之一: 1、直接或者间接拥有超过25%公司股权或者表决权的自然人。 2、通过人事、财务等其他方式对公司进行控制的自然人。 3、公司的高级管理人员,包括公司的经理、副经理、财务负责人、上市公司董事会秘书和公司章程规定的其他人员。 |
+ 结算账户信息 | account_info | object | 是 | body请填写商家提现收款的银行账户信息 |
+ 超级管理员信息 | contact_info | object | 是 | body请填写店铺的超级管理员信息。 超级管理员需在开户后进行签约,并可接收日常重要管理信息和进行资金操作,请确定其为商户法定代表人或负责人。 |
+ 店铺信息 | sales_scene_info | object | 是 | body请填写店铺信息 |
+ 结算规则 | settlement_info | object | 否 | body请填写商家的结算费率规则、所属行业等信息。若电商平台未传入,系统将填写默认值 |
商户简称 | merchant_shortname | string[1,64] | 是 | body UTF-8格式,中文占3个字节,即最多21个汉字长度。将在支付完成页向买家展示,需与商家的实际售卖商品相符 。 |
特殊资质 | qualifications | string[1,1024] | 否 | body 1、根据商户经营业务要求提供相关资质,详情查看《行业对应特殊资质》。 |
补充材料 | business_addition_pics | string[1,1024] | 否 | body 根据实际审核情况,额外要求提供。最多可上传5张照片,请填写通过图片上传接口预先上传图片生成好的MediaID 。 |
补充说明 | business_addition_desc | string[1,512] | 否 | body 1、若主体为“个人卖家”,该字段必传,则需填写描述“ 该商户已持续从事电子商务经营活动满6个月,且期间经营收入累计超过20万元。” |
{
"organization_type": "2",
"out_request_no": "APPLYMENT_00000000001",
"finance_institution": true,
"business_license_info": {
"business_license_copy": "47ZC6GC-vnrbEny__Ie_An5-tCpqxucuxi-vByf3Gjm7KE53JXvGy9tqZm2XAUf-4KGprrKhpVBDIUv0OF4wFNIO4kqg05InE4d2I6_H7I4",
"business_license_number": "123456789012345678",
"business_time": "[\\\"2014-01-01\\\",\\\"长期\\\"]",
"cert_type": "CERTIFICATE_TYPE_2388",
"company_address": "深圳南山区科苑路",
"legal_person": "张三",
"merchant_name": "腾讯科技有限公司"
},
"finance_institution_info": {
"finance_license_pics": "47ZC6GC-vnrbEny__Ie_An5-tCpqxucuxi-vByf3Gjm7KE53JXvGy9tqZm2XAUf-4KGprrKhpVBDIUv0OF4wFNIO4kqg05InE4d2I6_H7I4",
"finance_type": "BANK_AGENT"
},
"id_doc_type": "IDENTIFICATION_TYPE_MAINLAND_IDCARD",
"id_holder_type": "LEGAL",
"authorize_letter_copy": "47ZC6GC-vnrbEny_Ie_An5-tCpqxucuxi-vByf3Gjm7KEIUv0OF4wFNIO4kqg05InE4d2I6_H7I4",
"id_card_info": {
"id_card_address": "AOZdYGISxo4y44/UgZ69bdu9X+tfMUJ9dl+LetjM45/zMbrYu+wWZ8gn4CTdo+D/m9MrPg+V4sm73oxqdQu/hj7aWyDl4GQtPXVdaztB9jVbVZh3QFzV+BEmytMNQp9dt1uWJktlfdDdLR3AMWyMB377xd+m9bSr/ioDTzagEcGe+vLYiKrzcroQv3OR0p3ppFYoQ3IfYeU/04S4t9rNFL+kyblK2FCCqQ11NdbbHoCrJc7NV4oASq6ZFonjTtgjjgKsadIKHXtb3JZKGZjduGdtkRJJp0/0eow96uY1Pk7Rq79Jtt7+I8juwEc4P4TG5xzchG/5IL9DBd+Z0zZXkw==",
"id_card_copy": "jTpGmxUX3FBWVQ5NJTZvlKX_gdU4cRz7z5NxpnFuAxhBTEO_PvWkfSCJ3zVIn001D8daLC-ehEuo0BJqRTvDujqhThn4ReFxikqJ5YW6zFQ",
"id_card_name": "pVd1HJ6zyvPedzGaV+X3qtmrq9bb9tPROvwia4ibL+F6mfjbzQIzfb3HHLEjZ4YiR/cJiCrZxnAqi+pjeKIEdkwzXRAI7FUhrfPK3SNjaBTEu9GmsugMIA9r3x887Q+ODuC8HH2nzAn7NGpE/e3yiHgWhk0ps5k5DP/2qIdGdONoDzZelrxCl/NWWNUyB93K9F+jC1JX2IMttdY+aQ6zBlw0xnOiNW6Hzy7UtC+xriudjD5APomty7/mYNxLMpRSvWKIjOv/69bDnuC4EL5Kz4jBHLiCyOb+tI0m2qhZ9evAM+Jv1z0NVa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg==",
"id_card_national": "47ZC6GC-vnrbEny__Ie_An5-tCpqxucuxi-vByf3Gjm7KE53JXvGy9tqZm2XAUf-4KGprrKhpVBDIUv0OF4wFNIO4kqg05InE4d2I6_H7I4",
"id_card_number": "AOZdYGISxo4y44/UgZ69bdu9X+tfMUJ9dl+LetjM45/zMbrYu+wWZ8gn4CTdo+D/m9MrPg+V4sm73oxqdQu/hj7aWyDl4GQtPXVdaztB9jVbVZh3QFzV+BEmytMNQp9dt1uWJktlfdDdLR3AMWyMB377xd+m9bSr/ioDTzagEcGe+vLYiKrzcroQv3OR0p3ppFYoQ3IfYeU/04S4t9rNFL+kyblK2FCCqQ11NdbbHoCrJc7NV4oASq6ZFonjTtgjjgKsadIKHXtb3JZKGZjduGdtkRJJp0/0eow96uY1Pk7Rq79Jtt7+I8juwEc4P4TG5xzchG/5IL9DBd+Z0zZXkw==",
"id_card_valid_time": "2026-06-06",
"id_card_valid_time_begin": "2019-06-06"
},
"id_doc_info": {
"doc_period_begin": "2019-06-06",
"doc_period_end": "2020-01-02",
"id_doc_address": "jTpGmxUX3FBWVQ5NJTZvlKX_gdU4cRz7z5NxpnFuAxhBTEO_PvWkfSCJ3zVIn001D8daLC-ehEuo0BJqRTvDujqhThn4ReFxikqJ5YW6zFQ",
"id_doc_copy": "47ZC6GC-vnrbEny__Ie_An5-tCpqxucuxi-vByf3Gjm7KE53JXvGy9tqZm2XAUf-4KGprrKhpVBDIUv0OF4wFNIO4kqg05InE4d2I6_H7I4",
"id_doc_copy_back": "47ZC6GC-vnrbEny__Ie_An5-tCpqxucuxi-vByf3Gjm7KE53JXvGy9tqZm2XAUf-4KGprrKhpVBDIUv0OF4wFNIO4kqg05InE4d2I6_H7I4",
"id_doc_name": "jTpGmxUX3FBWVQ5NJTZvlKX_gdU4cRz7z5NxpnFuAxhBTEO_PvWkfSCJ3zVIn001D8daLC-ehEuo0BJqRTvDujqhThn4ReFxikqJ5YW6zFQ",
"id_doc_number": "jTpGmxUX3FBWVQ5NJTZvlKX_gdU4cRz7z5NxpnFuAxhBTEO_PvWkfSCJ3zVIn001D8daLC-ehEuo0BJqRTvDujqhThn4ReFxikqJ5YW6zFQ"
},
"owner": true,
"ubo_info_list": [{
"ubo_id_doc_address": "pVd1HJ6zyvPedzGaV+X3qtmrq9bb9tPROvwia4ibL+F6mfjbzQIzfb3HHLEjZ4YiR/cJiCrZxnAqi+pjeKIEdkwzXRAI7FUhrfPK3SNjaBTEu9GmsugMIA9r3x887Q+ODuC8HH2nzAn7NGpE/e3yiHgWhk0ps5k5DP/2qIdGdONoDzZelrxCl/NWWNUyB93K9F+jC1JX2IMttdY+aQ6zBlw0xnOiNW6Hzy7UtC+xriudjD5APomty7/mYNxLMpRSvWKIjOv/69bDnuC4EL5Kz4jBHLiCyOb+tI0m2qhZ9evAM+Jv1z0NVa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg==",
"ubo_id_doc_copy": "jTpGmxUXqRTvDujqhThn4ReFxikqJ5YW6zFQ",
"ubo_id_doc_copy_back": "jTpGmxUX3FBWVQ5NJTZvvDujqhThn4ReFxikqJ5YW6zFQ",
"ubo_id_doc_name": "AOZdYGISxo4y44/Ug4P4TG5xzchG/5IL9DBd+Z0zZXkw==",
"ubo_id_doc_number": "AOZdYGISxo4y44/Ug4P4TG5xzchG/5IL9DBd+Z0zZXkw==",
"ubo_id_doc_period_begin": "2019-06-06",
"ubo_id_doc_period_end": "2026-06-06",
"ubo_id_doc_type": "IDENTIFICATION_TYPE_MAINLAND_IDCARD"
}]
"account_info": {
"account_bank": "工商银行",
"account_cert_info": {
"other_cert_pics": ["47ZC6GC-vnrbEny_Ie_An5-tCpqxucuxi-vByf3Gjm7KEIUv0OF4wFNIO4kqg05InE4d2I6_H7I4"],
"relation_cert_pic": ["47ZC6GC-vnrbEny_Ie_An5-tCpqxucuxi-vByf3Gjm7KEIUv0OF4wFNIO4kqg05InE4d2I6_H7I4"],
"settlement_cert_pic": ["47ZC6GC-vnrbEny_Ie_An5-tCpqxucuxi-vByf3Gjm7KEIUv0OF4wFNIO4kqg05InE4d2I6_H7I4"]
},
"account_name": "AOZdYGISxo4y44/UgZ69bdu9X+tfMUJ9dl+LetjM45/zMbrYu+wWZ8gn4CTdo+D/m9MrPg+V4sm73oxqdQu/hj7aWyDl45IL9DBd+Z0zZXkw==",
"account_number": "d+xT+MQCvrLHUVDWv/8MR/dB7TkXM2YYZlokmXzFsWs35NXUot7C0NcxIrUF5FnxqCJHkNgKtxa6RxEYyba1+VBRLnqKGYQE8ZRGYoeorwC+w==",
"bank_account_type": "75",
"bank_address_code": "110000",
"bank_branch_id": "402713354941"
},
"contact_info": {
"business_authorization_letter": "47ZC6GC-vnrbEny_Ie_An5-tCpqxucuxi-vByf3Gjm7KEIUv0OF4wFNIO4kqg05InE4d2I6_H7I4",
"contact_email": "pVd1HJ6zyvPedzGaV+X3qtmrq9bb9tPROvwia4ibL+F6mfjbzQIzfb3HHLEjZ4YiR/cJiCrZxnAqi+pjeKIEdkwzXRAI7FUhrfPK3SNjaBTEu9GmsugMIA9r3x887Q+ODuC8HH2nzAn7NGpE/e3yiHgWhk0ps5k5DP/2qIdGdONoDzZelrxCl/NWWNUyB93K9F+jC1JX2IMttdY+aQ6zBlw0xnOiNW6Hzy7UtC+xriudjD5APomty7/mYNxLMpRSvWKIjOv/69bDnuC4EL5Kz4jBHLiCyOb+tI0m2qhZ9evAM+Jv1z0NVa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg==",
"contact_id_card_number": "pVd1HJ6zyvPedzGaV+X3qtmrq9bb9tPROvwia4ibL+F6mfjbzQIzfb3HHLEjZ4YiR/cJiCrZxnAqi+pjeKIEdkwzXRAI7FUhrfPK3SNjaBTEu9GmsugMIA9r3x887Q+ODuC8HH2nzAn7NGpE/e3yiHgWhk0ps5k5DP/2qIdGdONoDzZelrxCl/NWWNUyB93K9F+jC1JX2IMttdY+aQ6zBlw0xnOiNW6Hzy7UtC+xriudjD5APomty7/mYNxLMpRSvWKIjOv/69bDnuC4EL5Kz4jBHLiCyOb+tI0m2qhZ9evAM+Jv1z0NVa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg==",
"contact_id_doc_copy": "jTpGmxUX3FBWVQ5NJTZvvDujqhThn4ReFxikqJ5YW6zFQ",
"contact_id_doc_copy_back": "jTpGmxUX3FBWVQ5NJTZvvDujqhThn4ReFxikqJ5YW6zFQ",
"contact_id_doc_period_begin": "2019-06-06",
"contact_id_doc_period_end": "2026-06-06",
"contact_id_doc_type": "IDENTIFICATION_TYPE_MACAO",
"contact_name": "pVd1HJ6zyvPedzGaV+X3qtmrq9bb9tPROvwia4ibL+F6mfjbzQIzfb3HHLEjZ4YiR/cJiCrZxnAqi+pjeKIEdkwzXRAI7FUhrfPK3SNjaBTEu9GmsugMIA9r3x887Q+ODuC8HH2nzAn7NGpE/e3yiHgWhk0ps5k5DP/2qIdGdONoDzZelrxCl/NWWNUyB93K9F+jC1JX2IMttdY+aQ6zBlw0xnOiNW6Hzy7UtC+xriudjD5APomty7/mYNxLMpRSvWKIjOv/69bDnuC4EL5Kz4jBHLiCyOb+tI0m2qhZ9evAM+Jv1z0NVa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg==",
"contact_type": "65",
"mobile_phone": "pVd1HJ6zyvPedzGaV+X3qtmrq9bb9tPROvwia4ibL+F6mfjbzQIzfb3HHLEjZ4YiR/cJiCrZxnAqi+pjeKIEdkwzXRAI7FUhrfPK3SNjaBTEu9GmsugMIA9r3x887Q+ODuC8HH2nzAn7NGpE/e3yiHgWhk0ps5k5DP/2qIdGdONoDzZelrxCl/NWWNUyB93K9F+jC1JX2IMttdY+aQ6zBlw0xnOiNW6Hzy7UtC+xriudjD5APomty7/mYNxLMpRSvWKIjOv/69bDnuC4EL5Kz4jBHLiCyOb+tI0m2qhZ9evAM+Jv1z0NVa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg=="
},
"sales_scene_info": {
"mini_program_sub_appid": "wxa123344545577",
"store_name": "爱烧烤",
"store_qr_code": "jTpGmxUX3FBWVQ5NJTZvlKX_gdU4cRz7z5NxpnFuAxhBTEO_PvWkfSCJ3zVIn001D8daLC-ehEuo0BJqRTvDujqhThn4ReFxikqJ5YW6zFQ"
},
"settlement_info": {
"qualification_type": "零售批发/生活娱乐/其他",
"settlement_id": 719
},
"business_addition_desc": "特殊情况,说明原因",
"business_addition_pics": ""jTpGmxUX3FBWVQ5NJTZvlKX_gdU4cRz7z5NxpnFuAxhBTEO_PvWkfSCJ3zVIn001D8daLC-ehEuo0BJqRTvDujqhThn4ReFxikqJ5YW6zFQ\",\"47ZC6GC-vnrbEny__Ie_An5-tCpqxucuxi-vByf3Gjm7KE53JXvGy9tqZm2XAUf-4KGprrKhpVBDIUv0OF4wFNIO4kqg05InE4d2I6_H7I4",
"merchant_shortname": "腾讯",
"qualifications": "jTpGmxUX3FBWVQ5NJTZvlKX_gdU4cRz7z5NxpnFuAxhBTEO_PvWkfSCJ3zVIn001D8daLC-ehEuo0BJqRTvDujqhThn4ReFxikqJ5YW6zFQ\\\",\\\"47ZC6GC-vnrbEny__Ie_An5-tCpqxucuxi-vByf3Gjm7KE53JXvGy9tqZm2XAUf-4KGprrKhpVBDIUv0OF4wFNIO4kqg05InE4d2I6_H7I4"
}
参数名 | 变量 | 类型[长度限制] | 必填 | 描述 |
---|---|---|---|---|
微信支付申请单号 | applyment_id | int | 是 | 微信支付分配的申请单号 。 示例值:2000002124775691 |
业务申请编号 | out_request_no | string[1,124] | 是 | 服务商自定义的商户唯一编号。每个编号对应一个申请单,每个申请单审核通过后会生成一个微信支付商户号。 示例值:APPLYMENT_00000000001 |
{
"applyment_id": 2000002124775691,
"out_request_no": "APPLYMENT_00000000001"
}
状态码 | 错误码 | 描述 | 解决方案 |
---|---|---|---|
500 | SYSTEM_ERROR | 系统错误 | 系统异常,请使用相同参数稍后重新调用 |
400 | PARAM_ERROR | 参数错误 | 请使用正确的参数重新调用 |
400 | RESOURCE_ALREADY_EXISTS | 存在流程进行中的申请单,请检查是否重入 | 可通过查询申请状态查看此申请单的申请状态,或更换out_request_no提交新的申请单 |
403 | NO_AUTH | 商户权限异常 | 请确认是否已经开通相关权限 |
404 | RESOURCE_NOT_EXISTS | 申请单不存在 | 确认入参,传入正确的申请单编号 |