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

提交申请单API

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


渠道商可以通过该接口向微信支付提交商户的联系人、主体等信息,根据指引完成商户开户意愿确认。

功能接入可看产品流程指引

注意:

• 商户上送敏感信息时使用微信支付平台公钥加密,证书序列号包含在请求HTTP头部的Wechatpay-Serial,详见接口规则

接口说明

适用对象:渠道商从业机构

请求URL:https://api.mch.weixin.qq.com/v3/apply4subject/applyment

请求方式:POST


path指该参数为路径参数

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

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


请求参数

参数名 变量 类型[长度限制] 必填 描述
渠道商户号 channel_id string[8,9] body 1、微信支付分配的渠道商唯一标识。
2、当从业机构调用时,该字段必填,需要填写从业机构下的渠道商商户号(渠道号)。
3、当渠道商调用时,该字段无需填写,此时只需要在HTTP Authorization里面把mchid设置为渠道号即可。
示例值:20001111
业务申请编号 business_code string[1,128] body服务商自定义的唯一编号,每个编号对应一个申请单。
示例值:1111111111
+联系人信息 contact_info object body联系人信息,联系人是商户的超级管理员,将接收开户信息及日常重要管理信息,请确定超级管理员为商户法定代表人或负责人再进行操作。如超级管理员非商户法定代表人或负责人,请联系法定代表人或负责人提交申请。
参数名 变量 类型[长度限制] 必填 描述
联系人姓名 name string[1,1024] 1、请填写联系人姓名,2~30个中文字符、英文字符、符号。
2、该字段需进行加密处理,加密方法详见敏感信息加密说明
示例值:X/8KWvNPULFmbdM1oU/w58gd1Jv75z+qStfT018ms25FGlVGMR2An5yGhVEHTp509zscN9PKjhi+Q+VBGpy2ei6HY5DbXU3m74Q96IpHw7w==
联系人手机号 mobile string[11,1024] 1、联系人手机号用于接收微信支付的重要管理信息及日常操作验证码。
2、填写11位数字的手机号码。
3、该字段需进行加密处理,加密方法详见敏感信息加密说明
示例值:Oiw4DS+QVyZKC3eTd7CGvGQ1/sidmLm8mdsohkuR9jSiwXyHyVQD1OA1t+6Pb+Xn0q2HAJYLsNjh8O4S1iQgMrFohyaNms4IlDxJzujb9VA==
联系人身份证号码 id_card_number string[1,1024] 该字段需进行加密处理,加密方法详见敏感信息加密说明
示例值:rjbq82xBwMixDGAviRajNvdDah00E7jIA/jtnj+Wk5jjM+yyjn9BU8qUBZga+mKqQ==
+主体信息 subject_info object body主体信息
参数名 变量 类型[长度限制] 必填 描述
主体类型 subject_type string[1,32] 主体类型
枚举值:
  1. SUBJECT_TYPE_ENTERPRISE:企业
  2. SUBJECT_TYPE_INSTITUTIONS_CLONED:事业单位
  3. SUBJECT_TYPE_INDIVIDUAL:个体工商户
  4. SUBJECT_TYPE_OTHERS:其他组织
  5. SUBJECT_TYPE_MICRO:小微商户
示例值:SUBJECT_TYPE_ENTERPRISE
+营业执照信息 business_licence_info object 主体类型为企业或个体户时,营业执照信息必填。
参数名 变量 类型[长度限制] 必填 描述
营业执照注册号 licence_number string[1,32] 1、请填写营业执照上的注册号。
2、若主体类型为个体工商户或企业,注册号格式须为15位数字或18位数字|大写字母。
示例值:914201123033363296
营业执照照片 licence_copy string[1,255] 请填写通过《图片上传API》预先上传图片生成好的MediaID。
示例值:0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV-4BBgVwtNkCHO_XXqK5dE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo
商户名称 merchant_name string[1,128]
  1. 1、个体工商户,不能以“公司”结尾。
  2. 2、个体工商户,若营业执照上商户名称为空或为“无”,请填写"个体户+经营者姓名",如“个体户张三”。
示例值:李四网络有限公司
法人姓名 legal_person string[1,64] 1、只能由中文字符、英文字符、可见符号组成。
2、请填写营业执照的经营者/法定代表人姓名。
示例值:李四
注册地址 company_address string[1,128] 请填写营业执照的注册地址。
示例值:广东省深圳市南山区xx路xx号
营业执照有效日期 licence_valid_date string[1,64] 1、请填写营业执照上的营业期限,注意参照示例中的格式,长期用"forever"表示。
2、结束时间需大于开始时间。
3、有效期必须大于60天,即结束时间距当前时间需超过60天。
示例值:[\"1970-01-01\",\"forever\"]
+登记证书信息 certificate_info object 主体类型为事业单位或其他组织时,登记证书信息必填。
参数名 变量 类型[长度限制] 必填 描述
证书类型 cert_type string[1,21] 证书类型
枚举值:
CERTIFICATE_TYPE_2388:事业单位法人证书
CERTIFICATE_TYPE_2389:统一社会信用代码证书
CERTIFICATE_TYPE_2390:有偿服务许可证(军队医院适用)
CERTIFICATE_TYPE_2391:医疗机构执业许可证(军队医院适用)
CERTIFICATE_TYPE_2392:企业营业执照(挂靠企业的党组织适用)
CERTIFICATE_TYPE_2393:组织机构代码证(政府机关适用)
CERTIFICATE_TYPE_2394:社会团体法人登记证书
CERTIFICATE_TYPE_2395:民办非企业单位登记证书
CERTIFICATE_TYPE_2396:基金会法人登记证书
CERTIFICATE_TYPE_2397:慈善组织公开募捐资格证书
CERTIFICATE_TYPE_2398:农民专业合作社法人营业执照
CERTIFICATE_TYPE_2399:宗教活动场所登记证
CERTIFICATE_TYPE_2400:其他证书/批文/证明
示例值:CERTIFICATE_TYPE_2388
证书编号 cert_number string[1,32] 请填写登记证书上的证书编号。
示例值:111111111111
证书照片 cert_copy string[1,255] 请填写通过《图片上传API》预先上传图片生成好的MediaID。
示例值:0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV-4BBgVwtNkCHO_XXqK5dE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo
商户名称 merchant_name string[1,128] 请填写登记证书上的商户名称。
示例值:xx公益团体
法人姓名 legal_person string[1,64] 1、只能由中文字符、英文字符、可见符号组成。
2、请填写登记证书上的法定代表人姓名。
示例值:李四
注册地址 company_address string[1,128] 请填写登记证书的注册地址。
示例值:广东省深圳市南山区xx路xx号
证书有效日期 cert_valid_date string[1,64] 1、请填写登记证书上的有效期限,注意参照示例中的格式,长期用"forever"表示。
2、结束时间需大于开始时间。
3、有效期必须大于60天,即结束时间距当前时间需超过60天。
示例值:[\"1970-01-01\",\"forever\"]
单位证明函照片 company_prove_copy string[1,255] 1、主体类型为事业单位时,单位证明函照片必填。
2、单位证明函格式参考示例
3、请填写通过《图片上传API》预先上传图片生成好的MediaID。
示例值:0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV-4BBgVwtNkCHO_XXqK5dE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo
+辅助证明材料信息 assist_prove_info object 主体类型为小微商户时,辅助证明材料信息必填。
参数名 变量 类型[长度限制] 必填 描述
小微经营类型 micro_biz_type string[1,18] 小微经营类型
枚举值:
  1. MICRO_TYPE_STORE:门店场所
  2. MICRO_TYPE_MOBILE:流动经营/便民服务
  3. MICRO_TYPE_ONLINE:线上商品/服务交易
示例值:MICRO_TYPE_STORE
门店名称 store_name string[1,128] 填写规范:
  1. 1、门店场所:填写门店名称。
  2. 2、流动经营/便民服务:填写经营/服务名称。
  3. 3、线上商品/服务交易:填写线上店铺名称。
示例值:大郎烧饼
门店省市编码 store_address_code string[1,16] 详细参见《微信支付提供的省市对照表》。
  1. 1、门店场所:填写门店省市编码。
  2. 2、流动经营/便民服务:填写经营/服务所在地省市编码。
  3. 3、线上商品/服务交易:填写卖家所在地省市编码。
示例值:440305
门店地址 store_address string[1,128]
  1. 最长500个中文字符。
  2. 1、门店场所:填写店铺详细地址,具体区/县及街道门牌号或大厦楼层。
  3. 2、流动经营/便民服务:填写“无"。
  4. 3、线上商品/服务交易:填写电商平台名称。
示例值:广东省深圳市南山区xx大厦x层xxxx室
门店门头照片 store_header_copy string[1,255]

1、请填写通过《图片上传API》预先上传图片生成好的MediaID。
2、填写规范:
  1)门店场所:提交门店门口照片,要求招牌清晰可见。
  2)流动经营/便民服务:提交经营/服务现场照片。
  3)线上商品/服务交易:提交店铺首页截图。
示例值: 0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV-4BBgVwtNkCHO_XXqK5dE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo

店内环境照片 store_indoor_copy string[1,255] 1、请填写通过《图片上传API》预先上传图片生成好的MediaID。
2、填写规范:
  1)门店场所:提交店内环境照片。
  2)流动经营/便民服务:可提交另一张经营/服务现场照片。
  3)线上商品/服务交易:提交店铺管理后台截图。
示例值:0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV-4BBgVwtNkCHO_XXqK5dE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo
+经营许可证 special_operation_list array 经营许可证信息
参数名 变量 类型[长度限制] 必填 描述
行业id category_id uint32 参看微信支付提供的特殊行业id对照表
示例值:100
行业经营许可证资质照片 operation_copy_list array 1、请填写通过《图片上传API》预先上传图片生成好的MediaID
2、最多上传6张资质照片
字符长度限制:[0, 255]
示例值:0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV-4BBgVwtNkCHO_XXqK5dE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo
+法人身份信息 identification_info object body法人身份信息
参数名 变量 类型[长度限制] 必填 描述
法人证件类型 identification_type string[1,37] 法人证件类型
枚举值:
IDENTIFICATION_TYPE_IDCARD:身份证(限中国大陆居民)
IDENTIFICATION_TYPE_OVERSEA_PASSPORT:护照(限境外人士)
IDENTIFICATION_TYPE_HONGKONG_PASSPORT :中国香港居民-来往内地通行证
IDENTIFICATION_TYPE_MACAO_PASSPORT:中国澳门居民-来往内地通行证
IDENTIFICATION_TYPE_TAIWAN_PASSPORT:中国台湾居民-来往大陆通行证
示例值: IDENTIFICATION_TYPE_IDCARD
证件姓名 identification_name string[1,1024] 1、请填写法人证件上的姓名,2~30个中文字符、英文字符、符号。
2、该字段需进行加密处理,加密方法详见敏感信息加密说明
示例值:MZnwEx6zotwIz6ctW2/iQL5z94odwP9sKiF74RPCPztcJOScaXsaGs82HJNU3K+46ndk7pMrENiPDw==
证件号码 identification_number string[1,1024] 1、请填写法人证件上的证件号码。
2、该字段需进行加密处理,加密方法详见敏感信息加密说明
示例值:ZTnn5dKGCvP4csw4XTLug/+VLB+4R6nxSPQwqSpmPVZtXmye+/3s9O+y32w==
证件有效日期 identification_valid_date string[1,64] 1、请填写法人证件的有效时间,注意参照示例中的格式。
2、结束时间需大于开始时间。
3、证件有效期需大于60天,即结束时间距当前时间需超过60天。
示例值:[\"1970-01-01\",\"forever\"]
证件正面照片 identification_front_copy string[1,255] 1、请上传法人证件的正面照片。
2、若法人证件类型为身份证,请上传人像面照片。
3、请填写通过《图片上传API》预先上传图片生成好的MediaID。
示例值:0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV-4BBgVwtNkCHO_XXqK5dE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo
证件反面照片 identification_back_copy string[1,255] 1、请上传法人证件的反面照片。
2、若法人证件类型为身份证,请上传国徽面照片。
3、若证件类型为护照或通行证,无需上传反面照片。
4、请填写通过《图片上传API》预先上传图片生成好的MediaID。
示例值:0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV-4BBgVwtNkCHO_XXqK5dE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo
+补充材料 addition_info object body 1、可填写需「确认开户意愿」的商户号
2、根据实际审核情况,额外要求商家提供指定的补充资料。
参数名 变量 类型[长度限制] 必填 描述
待确认商户号列表 confirm_mchid_list array 1、若有填写,创建申请单后,商家可扫码打开申请单的二维码,提前完成授权商户号; 详细流程请看产品指引
2、商户号填写要求如下:
(1)请确保商户号全称与申请单主体名称一致;
(2)如特殊行业商户,请确保商户号结算规则ID与经营许可证匹配;
(3)一个申请单最多可以提交20个商户号。
3、校验报错说明
(1)提交申请单不满足上述要求,则无法创建申请单,返回报错格式参考如下。
"123456789:待确认商户号不存在,请检查待确认商户号是否正确;1234567:查询待确认商户信息发生系统失败,请稍后再试[269795842];999990017:待确认商户号不是当前从业机构的特约商户"
(2)若服务商需实现剔除报错商户号逻辑,建议根据格式(如标点符号)筛选商户号,不根据报错文案筛选(因后续可能调整文案)。
示例值:20001113

请求示例


{
	"business_code": "1111111111",
	"contact_info": {
		"name": "wRNIsXOvVuTYIhVxZJCD8uJIGmNPGozCe44Ph8rD+QAJEPxw==",
		"mobile": "w+zPKEVNm7IDxPvK55P0OfNd5E5VXoWbRwyyGk37HiB6C/F2lUog==",
		"id_card_number": "rjbq82xBwMixDGA5A4x6/hqZRAYmaeM+yyjn9BU8qUBZga+mKqQ=="
	},
	"subject_info": {
		"subject_type": "SUBJECT_TYPE_ENTERPRISE",
		"business_licence_info": {
			"licence_number": "914201123033363296",
			"licence_copy": "0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV4BBgVwtNkCHO_XXqK5dE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo",
			"merchant_name": "李四网络有限公司",
			"legal_person": "李四",
			"company_address": "广东省深圳市南山区xx路xx号",
			"licence_valid_date": "[\"1970-01-01\",\"forever\"]"
		},
		"certificate_info": {
			"cert_type": "CERTIFICATE_TYPE_2388",
			"cert_number": "111111111111",
			"cert_copy": "0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV4BBgVwtNkCHO_XXqK5dE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo",
			"merchant_name": "xx公益团体",
			"legal_person": "李四",
			"company_address": "广东省深圳市南山区xx路xx号",
			"cert_valid_date": "[\"1970-01-01\",\"forever\"]"
		},
		"company_prove_copy": "0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV4BBgVwtNkCHO_XXqK5dE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo",
		"assist_prove_info": {
			"micro_biz_type": "MICRO_TYPE_STORE",
			"store_name": "大郎烧饼",
			"store_address_code": "440305",
			"store_address": "广东省深圳市南山区xx大厦x层xxxx室",
			"store_header_copy": "0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV-4BBgVwtNkCHO_XXqK5dE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo",
			"store_indoor_copy": "0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV4BBgVwtNkCHO_XXqK5dE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo"
		}
	},
	"identification_info": {
		"identification_type": "IDENTIFICATION_TYPE_IDCARD",
		"identification_name": "MZnwEx6zotwIz6ctW2/iQL5z94odwP9sKiFRL8Aii3L4U74RPCPztcJOScaXsaGs82HJNU3K+46ndk7prENiPDw==",
		"identification_number": "ZTnn5dKGCvP4csw4XTLug/+VLB+4R6nxSPQwqSpmPVZtXmye+/3s9O+y32w==",
		"identification_valid_date": "[\"1970-01-01\",\"forever\"]",
		"identification_front_copy": "0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV-4BBgVwtNkCHO_XXqK5dE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo",
		"identification_back_copy": "0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV4BBgVwtNkCHO_XXqK5dE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo"
	},
	"addition_info": {
		"confirm_mchid_list": [
			"20001113",
			"20001112"
		]
	}
}
    
{
JAVA示例代码
}
    

返回参数

参数名 变量 类型[长度限制] 必填 描述
申请单编号 applyment_id int64 微信支付分配的申请单号。
示例值:20000000011111

返回示例


{
 "applyment_id": 20000000011111
}
                                

    http://2323weixin.qq.com
                                

错误码公共错误码

状态码 错误码 描述 解决方案
500 SYSTEMERROR 系统错误 系统异常,请使用相同参数稍后重新调用
400 PARAM_ERROR 参数错误 请使用正确的参数重新调用
400 INVALID_REQUEST 无效请求 请查看返回的错误信息,根据错误信息进行操作
403 NOAUTH 商户权限异常 请确认是否已经开通相关权限


技术咨询

文档反馈