首页 接入指引 产品中心 解决方案 文档中心 接入微信支付
商户开户意愿确认文档
产品介绍
产品介绍
接入指引
接口规则
开发指引
公共API
提交申请单
撤销申请单
查询申请单审核结果
获取商户开户意愿确认状态
对照表
特殊行业id对照表
帮助中心
联系我们
返回上一层 文档首页 / 通用接口 / 商户开户意愿确认 / 提交申请单API

提交申请单API

最新更新时间：2020.12.17 版本说明


服务商可以通过该接口向微信支付提交商户的联系人信息、主体信息以及联系人信息。

注意：

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

接口说明

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

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

请求方式：POST

接口规则：https://wechatpay-api.gitbook.io/wechatpay-api-v3


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

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、该字段需进行加密处理，加密方法详见敏感信息加密说明。
示例值：张三
联系人手机号 mobile string[11,1024] 是 1、联系人手机号用于接收微信支付的重要管理信息及日常操作验证码。
2、填写11位数字的手机号码。
3、该字段需进行加密处理，加密方法详见敏感信息加密说明。
示例值：13312345678
联系人身份证号码 id_card_number string[1,1024] 是 该字段需进行加密处理，加密方法详见敏感信息加密说明。
示例值：430422199001236704
+主体信息 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,50] 是
  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
示例值：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、该字段需进行加密处理，加密方法详见敏感信息加密说明。
示例值：李四
证件号码 identification_number string[1,1024] 是 1、请填写法人证件上的证件号码。
2、该字段需进行加密处理，加密方法详见敏感信息加密说明。
示例值：430422199001236705
证件有效日期 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

请求示例


{
 "business_code": "1111111111",
  "contact_info": {
    "name": "张三",
    "mobile": "13312345678",
    "id_card_number": "430422199001236704"
  },
  "subject_info": {
    "subject_type": "SUBJECT_TYPE_ENTERPRISE",
    "business_licence_info": {
      "licence_number": "914201123033363296",
      "licence_copy": "0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV-
	  4BBgVwtNkCHO_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_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV-
	  4BBgVwtNkCHO_XXqK5dE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo",
      "merchant_name": "xx公益团体",
      "legal_person": "李四",
      "company_address": "广东省深圳市南山区xx路xx号",
      "cert_valid_date": "[\"1970-01-01\",\"forever\"]"
    },
    "company_prove_copy": "0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV-
	4BBgVwtNkCHO_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-4
	  BBgVwtNkCHO_XXqK5dE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo",
      "store_indoor_copy": "0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV-
	  4BBgVwtNkCHO_XXqK5dE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo"
    }
  },
  "identification_info": {
    "identification_type": "IDENTIFICATION_TYPE_IDCARD",
    "identification_name": "李四",
    "identification_number": "430422199001236705",
    "identification_valid_date": "[\"1970-01-01\",\"forever\"]",
    "identification_front_copy": "0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV-
	4BBgVwtNkCHO_XXqK5dE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo",
    "identification_back_copy": "0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV-
	4BBgVwtNkCHO_XXqK5dE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo"
  }
}

    
｛
JAVA示例代码
｝

返回参数

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

返回示例


{
 "applyment_id": 20000000011111
}
                                

    http://2323weixin.qq.com

错误码公共错误码

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

版本说明

关闭
V1.2
2020年12月17日
1. 参数：special_operation_info调整为special_operation_list； store_indoor_copy调整为operation_copy_list
V1.1
2020年04月07日
1. 主体信息新增经营许可证信息（special_operation_info）参数
V1.0
2019年08月08日
1. 提交申请单接口上线

技术咨询
技术咨询

反馈有奖
反馈有奖
返回顶部
关于我们
关于微信支付
平台使用协议
支付服务协议
联系我们
服务支持
开发文档 (V2版)
微信开放社区
物料下载
友情链接
微信开放平台
微信公众平台
企业微信
客服帮助
自助服务专区
客服：95017
（工作日 09:00-22:00）
Powered By Tencent & Tenpay　Copyright 2005-2021 Tenpay All Rights Reserved.