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

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

注意

1. 商户上送敏感信息时使用微信支付平台公钥加密，证书序列号包含在请求HTTP头部的Wechatpay-Serial，详见接口规则
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
【微信支付平台证书序列号】
请求参数中的敏感字段，需要使用微信支付平台证书公钥加密。请设置为该证书的证书序列号。详见敏感信息加解密

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 选填 BusinessLicense
【营业执照信息】
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。
注：12月
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

应答参数

200OK
applyment_id 必填 integer
【微信支付申请单号】
微信支付分配的申请单号 。
out_request_no 必填 string
【业务申请编号】
服务商自定义的商户唯一编号。每个编号对应一个申请单，每个申请单审核通过后会生成一个微信支付商户号。

应答示例

200 OK

错误码

公共错误码

状态码	错误码	描述	解决方案
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	申请单不存在	确认入参，传入正确的申请单编号