商户进件
特约商户进件
基础支付
JSAPI支付
APP支付
H5支付
Native支付
小程序支付
合单支付
付款码支付
经营能力
支付即服务
点金计划
行业方案
电商收付通(商户进件)
电商收付通(普通支付)
电商收付通(合单支付)
电商收付通(分账)
电商收付通(补差)
电商收付通(退款)
电商收付通(余额查询)
电商收付通(商户提现)
电商收付通(下载账单)
智慧商圈
微信支付分停车服务
营销工具
代金券
商家券
委托营销
支付有礼
小程序发券插件
H5发券
图片上传(营销专用)
现金红包
资金应用
分账
连锁品牌分账
风险合规
商户开户意愿确认
消费者投诉2.0
其他能力
图片上传
视频上传

二级商户进件API

最新更新时间:2020.05.25 版本说明


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

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

接口说明

适用对象:电商平台

请求URL:https://api.mch.weixin.qq.com/v3/ecommerce/applyments/

请求方式:POST


path指该参数为路径参数

query指该参数需在请求URL传参

body指该参数需在请求JSON传参


请求参数

参数名 变量 类型[长度限制] 必填 描述
业务申请编号 out_request_no string[1,124]

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

主体类型 organization_type string[1,4]

body 非小微的主体类型需与营业执照/登记证书上一致,可参考选择主体指引,枚举值如下。
2401:小微商户,指无营业执照的个人商家。
2500:个人卖家,指无营业执照,已持续从事电子商务经营活动满6个月,且期间经营收入累计超过20万元的个人商家。(若选择该主体,请在“补充说明”填写相关描述)
4:个体工商户,营业执照上的主体类型一般为个体户、个体工商户、个体经营。
2:企业,营业执照上的主体类型一般为有限公司、有限责任公司。
3:党政、机关及事业单位,包括国内各级、各类政府机构、事业单位等(如:公安、党团、司法、交通、旅游、工商税务、市政、医疗、教育、学校等机构)。
1708:其他组织,不属于企业、政府/事业单位的组织机构(如社会团体、民办非企业、基金会),要求机构已办理组织机构代码证。
示例值:2401

+营业执照/登记证书信息 business_license_info object 条件选填

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

参数名 变量 类型[长度限制] 必填 描述
证件扫描件 business_license_copy string[1,256] 1、主体为“个体工商户/企业”时,请上传营业执照的证件图片。
2、主体为“党政、机关及事业单位/其他组织”时,请上传登记证书的证件图片。
3、可上传1张图片,请填写通过图片上传接口预先上传图片生成好的MediaID 。
4、图片要求:
(1)请上传证件的彩色扫描件或彩色数码拍摄件,黑白复印件需加盖公章(公章信息需完整) 。
(2)不得添加无关水印(非微信支付商户申请用途的其他水印)。
(3)需提供证件的正面拍摄件,完整、照面信息清晰可见。信息不清晰、扭曲、压缩变形、反光、不完整均不接受。
(4)不接受二次剪裁、翻拍、PS的证件照片。
示例值: 47ZC6GC-vnrbEny_Ie_An5-tCpqxucuxi-vByf3Gjm7KE53JXvGy9tqZm2XAUf-4KGprrKhpVBDIUv0OF4wFNIO4kqg05InE4d2I6_H7I4

证件注册号 business_license_number string[15,18] 1、主体为“个体工商户/企业”时,请填写营业执照上的注册号/统一社会信用代码,须为15位数字或 18位数字|大写字母。
2、主体为“党政、机关及事业单位/其他组织”时,请填写登记证书的证书编号。
示例值:123456789012345678
商户名称 merchant_name string[1,128] 1、请填写营业执照/登记证书的商家名称,2~110个字符,支持括号 。
2、个体工商户/党政、机关及事业单位,不能以“公司”结尾。
3、个体工商户,若营业执照上商户名称为空或为“无”,请填写"个体户+经营者姓名",如“个体户张三” 。
示例值:腾讯科技有限公司
经营者/法定代表人姓名 legal_person string[1,128] 请填写证件的经营者/法定代表人姓名
示例值:张三
注册地址 company_address string[1,128] 条件选填 主体为“党政、机关及事业单位/其他组织”时必填,请填写登记证书的注册地址。
示例值:深圳南山区科苑路
营业期限 business_time string[1,256] 条件选填 1、主体为“党政、机关及事业单位/其他组织”时必填,请填写证件有效期。
2、若证件有效期为长期,请填写:长期。
3、结束时间需大于开始时间。
4、有效期必须大于60天,即结束时间距当前时间需超过60天。
示例值:[\"2014-01-01\",\"长期\"]
+组织机构代码证信息 organization_cert_info object 条件选填

body 主体为企业/党政、机关及事业单位/其他组织,且证件号码不是18位时必填。

注:
若营业执照未三证合一 ,该参数必传;
若营业执照三证合一 ,该参数可不传。
参数名 变量 类型[长度限制] 必填 描述
组织机构代码证照片 organization_copy string[1,256] 可上传1张图片,请填写通过图片上传接口预先上传图片生成好的MediaID。
示例值:vByf3Gjm7KE53JXv\prrKhpVBDIUv0OF4wFNIO4kqg05InE4d2I6_H7I4
组织机构代码 organization_number string[1,256] 1、请填写组织机构代码证上的组织机构代码。
2、可填写9或10位 数字|字母|连字符。
示例值:12345679-A
组织机构代码有效期限 organization_time string[1,256] 1、请填写组织机构代码证的有效期限,注意参照示例中的格式。
2、若证件有效期为长期,请填写:长期。
3、结束时间需大于开始时间。
4、有效期必须大于60天,即结束时间距当前时间需超过60天。
示例值:[\"2014-01-01\",\"长期\"]
经营者/法人证件类型 id_doc_type string[1,64]

body 1、主体为“小微/个人卖家”,可选择:身份证。
2、主体为“个体户/企业/党政、机关及事业单位/其他组织”,可选择:以下任一证件类型。
3、若没有填写,系统默认选择:身份证。
枚举值:
IDENTIFICATION_TYPE_MAINLAND_IDCARD:中国大陆居民-身份证
IDENTIFICATION_TYPE_OVERSEA_PASSPORT:其他国家或地区居民-护照
IDENTIFICATION_TYPE_HONGKONG:中国香港居民–来往内地通行证
IDENTIFICATION_TYPE_MACAO:中国澳门居民–来往内地通行证
IDENTIFICATION_TYPE_TAIWAN:中国台湾居民–来往大陆通行证
示例值:IDENTIFICATION_TYPE_MACAO

+经营者/法人身份证信息 id_card_info object 条件选填

body 请填写经营者/法人的身份证信息
证件类型为“身份证”时填写。

参数名 变量 类型[长度限制] 必填 描述
身份证人像面照片 id_card_copy string[1,256] 1、请上传经营者/法定代表人的身份证人像面照片。
2、可上传1张图片,请填写通过图片上传接口预先上传图片生成好的MediaID。
示例值:xpnFuAxhBTEO_PvWkfSCJ3zVIn001D8daLC-ehEuo0BJqRTvDujqhThn4ReFxikqJ5YW6zFQ
身份证国徽面照片 id_card_national string[1,256] 1、请上传经营者/法定代表人的身份证国徽面照片。
2、可上传1张图片,请填写通过图片上传接口预先上传图片生成好的MediaID 。
示例值:vByf3Gjm7KE53JXvGy9tqZm2XAUf-4KGprrKhpVBDIUv0OF4wFNIO4kqg05InE4d2I6_H7I4
身份证姓名 id_card_name string[1,256] 1、请填写经营者/法定代表人对应身份证的姓名,2~30个中文字符、英文字符、符号。
2、该字段需进行加密处理,加密方法详见敏感信息加密说明(提醒:必须在HTTP头中上送Wechatpay-Serial)
示例值:pVd1HJ6v/69bDnuC4EL5Kz4jBHLiCa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg==
身份证号码 id_card_number string[15,18] 1、请填写经营者/法定代表人对应身份证的号码。
2、15位数字或17位数字+1位数字|X ,该字段需进行加密处理,加密方法详见敏感信息加密说明(提醒:必须在HTTP头中上送Wechatpay-Serial)
示例值:zV+BEmytMNQCqQ8juwEc4P4TG5xzchG/5IL9DBd+Z0zZXkw==4
身份证有效期限 id_card_valid_time string[1,128] 1、请填写身份证有效期的结束时间,注意参照示例中的格式。
2、若证件有效期为长期,请填写:长期。
3、证件有效期需大于60天。
示例值:2026-06-06
+经营者/法人其他类型证件信息 id_doc_info object 条件选填

body 证件类型为“来往内地通行证、来往大陆通行证、护照”时填写。

参数名 变量 类型[长度限制] 必填 描述
证件姓名 id_doc_name string[1,128] 1、请填写经营者/法人姓名。
2、该字段需进行加密处理,加密方法详见敏感信息加密说明(提醒:必须在HTTP头中上送Wechatpay-Serial)
示例值:jTpGmxUX3FBWVQ5NJTZvlKX_gdU4LC-ehEuo0BJqRTvDujqhThn4ReFxikqJ5YW6zFQ
证件号码 id_doc_number string[1,128] 7~11位 数字|字母|连字符 。
该字段需进行加密处理,加密方法详见敏感信息加密说明(提醒:必须在HTTP头中上送Wechatpay-Serial)
示例值:jTpGmxUX3FBWVQ5NJTZvlKX_go0BJqRTvDujqhThn4ReFxikqJ5YW6zFQ
证件照片 id_doc_copy string[1,256] 1、可上传1张图片,请填写通过图片上传接口预先上传图片生成好的MediaID。
2、2M内的彩色图片,格式可为bmp、png、jpeg、jpg或gif 。
示例值:xi-vByf3Gjm7KE53JXvGy9tqZm2XAUf-4KGprrKhpVBDIUv0OF4wFNIO4kqg05InE4d2I6_H7I4
证件结束日期 doc_period_end string[1,128] 1、请按照示例值填写。
2、若证件有效期为长期,请填写:长期。
3、证件有效期需大于60天 。
示例值:2020-01-02
是否填写结算银行账户 need_account_info bool

body 1、可根据实际情况,填写“true”或“false”。
   1)若为“true”,则需填写结算银行账户。
   2)若为“false”,则无需填写结算银行账户。
2、若入驻时未填写结算银行账户,则需入驻后调用修改结算账户API补充信息,才能发起提现。
3、当超级管理员类型为负责人时,该字段只能传true,即结算银行账户必填
示例值:true

+结算银行账户 account_info object 条件选填

body 若"是否填写结算账户信息"填写为“true”, 则必填,填写为“false”不填 。

参数名 变量 类型[长度限制] 必填 描述
账户类型 bank_account_type string[1,2] 1、若主体为企业/党政、机关及事业单位/其他组织,可填写:74-对公账户。
2、主体为“小微/个人卖家”,可选择:75-对私账户。
3、若主体为个体工商户,可填写:74-对公账户、75-对私账户。
示例值:75
开户银行 account_bank string[1,10] 详细参见开户银行对照表
注:
17家直连银行,请根据开户银行对照表直接填写银行名 ;
非17家直连银行,该参数请填写为“其他银行”。
示例值:工商银行
开户名称 account_name string[1,128] 1、选择经营者个人银行卡时,开户名称必须与身份证姓名一致。
2、选择对公账户时,开户名称必须与营业执照上的“商户名称”一致。
3、该字段需进行加密处理,加密方法详见敏感信息加密说明(提醒:必须在HTTP头中上送Wechatpay-Serial)
示例值:AOZdYGISxo4yw96uY1Pk7Rq79Jtt7+I8juwEc4P4TG5xzchG/5IL9DBd+Z0zZXkw==
开户银行省市编码 bank_address_code string[1,12] 至少精确到市,详细参见省市区编号对照表
注:
仅当省市区编号对照表中无对应的省市区编号时,可向上取该银行对应市级编号或省级编号。
示例值:110000
开户银行联行号 bank_branch_id string[1,64] 条件选填 1、17家直连银行无需填写,如为其他银行,开户银行全称(含支行)和开户银行联行号二选一。
2、详细参见开户银行全称(含支行)对照表
示例值:402713354941
开户银行全称 (含支行) bank_name string[1,128] 条件选填 1、17家直连银行无需填写,如为其他银行,开户银行全称(含支行)和开户银行联行号二选一。
2、需填写银行全称,如"深圳农村商业银行XXX支行" 。
3、详细参见开户银行全称(含支行)对照表。
示例值:施秉县农村信用合作联社城关信用社
银行账号 account_number string[1,128] 1、数字,长度遵循系统支持的对公/对私卡号长度要求表。
2、该字段需进行加密处理,加密方法详见敏感信息加密说明。(提醒:必须在HTTP头中上送Wechatpay-Serial)
示例值: d+xT+MQCvrLHUVDWv/8MR/dB7TkXLVfSrUxMPZy6jWWYzpRrEEaYQE8ZRGYoeorwC+w==
+超级管理员信息 contact_info object

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

参数名 变量 类型[长度限制] 必填 描述
超级管理员类型 contact_type string[1,2] 1、主体为“小微/个人卖家 ”,可选择:65-经营者/法人。
2、主体为“个体工商户/企业/党政、机关及事业单位/其他组织”,可选择:65-经营者/法人、66- 负责人。 (负责人:经商户授权办理微信支付业务的人员,授权范围包括但不限于签约,入驻过程需完成账户验证)。
示例值:65
超级管理员姓名 contact_name string[1,256] 1、若管理员类型为“法人”,则该姓名需与法人身份证姓名一致。
2、若管理员类型为“负责人”,则可填写实际负责人的姓名。
3、该字段需进行加密处理,加密方法详见敏感信息加密说明(提醒:必须在HTTP头中上送Wechatpay-Serial)
(后续该管理员需使用实名微信号完成签约)
示例值: pVd1HJ6zyvPedzGaV+X3IdGdbDnuC4Eelw/wDa4SzfeespQO/0kjiwfqdfg==
超级管理员身份证件号码 contact_id_card_number string[1,256] 1、若管理员类型为法人,则该身份证号码需与法人身份证号码一致。若管理员类型为负责人,则可填写实际负责人的身份证号码。
2、可传身份证、来往内地通行证、来往大陆通行证、护照等证件号码。
3、超级管理员签约时,校验微信号绑定的银行卡实名信息,是否与该证件号码一致。
4、该字段需进行加密处理,加密方法详见敏感信息加密说明(提醒:必须在HTTP头中上送Wechatpay-Serial)
示例值:pVd1HJ6zmty7/mYNxLMpRSvMRtelw/wDa4SzfeespQO/0kjiwfqdfg==
超级管理员手机 mobile_phone string[1,256] 1、请填写管理员的手机号,11位数字, 用于接收微信支付的重要管理信息及日常操作验证码 。
2、该字段需进行加密处理,加密方法详见敏感信息加密说明(提醒:必须在HTTP头中上送Wechatpay-Serial)
示例值:pVd1HJ6zyvPedzGaV+X3qtmrq9bb9tPROvwia4ibL+F6mfjbzQIzfb3HHLEjZ4YiNWWNeespQO/0kjiwfqdfg==
超级管理员邮箱 contact_email string[1,256] 条件选填 1、主体类型为“小微商户/个人卖家”可选填,其他主体需必填。
2、用于接收微信支付的开户邮件及日常业务通知。
3、需要带@,遵循邮箱格式校验 。
4、该字段需进行加密处理,加密方法详见敏感信息加密说明(提醒:必须在HTTP头中上送Wechatpay-Serial)
示例值:pVd1HJ6zyvPedzGaV+X3qtmrq9bb9tPROvwia4ibL+FWWNUlw/wDa4SzfeespQO/0kjiwfqdfg==
+店铺信息 sales_scene_info object

body 请填写店铺信息

参数名 变量 类型[长度限制] 必填 描述
店铺名称 store_name string[1,256] 请填写店铺全称。
示例值:爱烧烤
店铺链接 store_url string[1,1024] 二选一 1、店铺二维码or店铺链接二选一必填。
2、请填写店铺主页链接,需符合网站规范。
示例值:http://www.qq.com
店铺二维码 store_qr_code string[1,256] 1、店铺二维码 or 店铺链接二选一必填。
2、若为电商小程序,可上传店铺页面的小程序二维码。
3、请填写通过图片上传接口预先上传图片生成好的MediaID,仅能上传1张图片 。
示例值:jTpGmxUX3FBWVQ5NJTZvlKX_gdU4cRz7z5NxpnFuAxhBTEO1D8daLC-ehEuo0BJqRTvDujqhThn4ReFxikqJ5YW6zFQ
小程序AppID mini_program_sub_appid string[1,256]

body 1、商户自定义字段,可填写已认证的小程序AppID,认证主体需与二级商户主体一致;
2、完成入驻后, 系统发起二级商户号与该AppID的绑定(即配置为sub_appid,可在发起支付时传入)
示例值:wxd678efh567hg6787

商户简称 merchant_shortname string[1,64]

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

特殊资质 qualifications string[1,1024]

body 1、根据商户经营业务要求提供相关资质,详情查看《行业对应特殊资质》。
2、请提供为“申请商家主体”所属的特殊资质,可授权使用总公司/分公司的特殊资 质;
3、最多可上传5张照片,请填写通过图片上传接口预先上传图片生成好的MediaID 。
示例值:[\"jTpGmxUX3FBWVQ5NJInE4d2I6_H7I4\"]

补充材料 business_addition_pics string[1,1024]

body 根据实际审核情况,额外要求提供。最多可上传5张照片,请填写通过图片上传接口预先上传图片生成好的MediaID 。
示例值:[\"jTpGmg05InE4d2I6_H7I4\"]

补充说明 business_addition_desc string[1,256]

body 1、可填写512字以内 。
2、若主体为“个人卖家”,该字段必传,则需填写描述“ 该商户已持续从事电子商务经营活动满6个月,且期间经营收入累计超过20万元。”
示例值:特殊情况,说明原因

请求示例


{
	"organization_type": "2",
	"business_license_info": {
		"business_license_copy": "47ZC6GC-vnrbEg05InE4d2I6_H7I4",
		"business_license_number": "123456789012345678",
		"merchant_name": "腾讯科技有限公司",
		"legal_person": "张三"
	},
	"organization_cert_info": {
		"organization_copy": "47ZC6GC-vnrbEny_Ie_An5-tCpqxuGprrKhpVBDIUv0OF4wFNIO4kqg05InE4d2I6_H7I4 ",
		"organization_time": "[\"2014-01-01\",\"长期\"]",
		"organization_number": "12345679-A"
	},
	"id_card_info": {
		"id_card_copy": "jTpGmxUX3FBWVQ5NJTZvlKC-ehEuo0BJqRTvDujqhThn4ReFxikqJ5YW6zFQ",
		"id_card_national": "47ZC6GC-vnrbEny_Ie_AnGprrKhpVBDIUv0OF4wFNIO4kqg05InE4d2I6_H7I4",
		"id_card_name": "pVd1HJ6z7UtC + xriudjD5AqhZ9evAM + Jv1z0NVa8MRtelw / wDa4SzfeespQO / 0 kjiwfqdfg =",
		"id_card_number": "UZFETyabYFFlgvGh6R4vTzDRgzvA2HtP5VHahNhSUqhR9iuGTunRPRVFg ==",
		"id_card_valid_time": "2026-06-06"
	},
	"need_account_info": true,
	"account_info": {
		"bank_account_type": "74",
		"account_name": "fTA4TXc8yMOwFCYeGPktOOSbOBei3KAmUWHGxCQo2hfaC7xumTqXR7 / NyRHpFKXURQFcmmw ==",
		"account_bank": "工商银行",
		"bank_address_code": "110000",
		"bank_branch_id": "402713354941",
		"bank_name": "施秉县农村信用合作联社城关信用社",
		"account_number": "d+xT+MQCvrLHUVD5Fnx30mr4L8sPndjXTd75kPkyjqnoMRrEEaYQE8ZRGYoeorwC"
	},
	"contact_info": {
		"contact_type": "65",
		"contact_name": "pVd1HJ6zyvPedzGaV+Xy7UDa4SzfeespQO / 0 kjiwfqdfg ==",
		"contact_id_card_number": "UZFETyabYFFlgvGh6R4vTzDEOiZZ4ka9+5RgzvA2rJx+NztYUbN209rqR9iuGTunRPRVFg ==",
		"mobile_phone": "Uy5Hb0c5Se/orEbrWze/ROHu9EPAs/CigDlJ2fnyzC1ppJNBrqcBszhYQUlu5zn6o2uZpBhAsQwd3QAjw==",
		"contact_email": "Uy5Hb0c5Se/orEbrWze/ROHu9EPAs/CigDlJ2fnyzC1ppJNaLZExOEzmUn6o2uZpBhAsQwd3QAjw=="
	},
	"sales_scene_info": {
		"store_name": "爱烧烤",
		"store_url": "http://www.qq.com",
		"store_qr_code": "jTpGmxUX3FBWVQ5NJTZvlKX_gdU4cRz7z5NxpnFuAujqhThn4ReFxikqJ5YW6zFQ"
	},
	"merchant_shortname": "爱烧烤",
	"out_request_no": "APPLYMENT_00000000001",
	"qualifications": "[\"jTpGmxUX3FBWVQ5NJInE4d2I6_H7I4\"]",
	"business_addition_pics": "[\"jTpGmg05InE4d2I6_H7I4\"]",
	"business_addition_desc": "特殊情况,说明原因"

}
    
{
JAVA示例代码
}
    

返回参数

参数名 变量 类型[长度限制] 必填 描述
微信支付申请单号 applyment_id uint64 微信支付分配的申请单号 。
示例值:2000002124775691
业务申请编号 out_request_no string[1,124] 服务商自定义的商户唯一编号。每个编号对应一个申请单,每个申请单审核通过后会生成一个微信支付商户号。
示例值:APPLYMENT_00000000001

返回示例


{
  "applyment_id": 2000002124775691,
  "out_request_no": "APPLYMENT_00000000001"
}
                                

    http://2323weixin.qq.com
                                

错误码公共错误码

状态码 错误码 描述 解决方案
500 SYSTEMERROR

系统错误

系统异常,请使用相同参数稍后重新调用
400 PARAM_ERROR

参数错误

请使用正确的参数重新调用
400 RESOURCE_ALREADY_EXISTS

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

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

商户权限异常

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

申请单不存在

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


技术咨询

文档反馈