提交申请单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. 提交申请单接口上线

技术咨询

反馈有奖