提交申请

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


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

接口说明

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

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

请求方式:POST

接口频率: 5QPS(商户号维度)

接口规则:https://pay.weixin.qq.com/wiki/doc/apiv3/wechatpay/wechatpay-1.shtml


path指该参数为路径参数

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

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


请求参数

参数名 变量 类型[长度限制] 必填 描述
渠道商户号 channel_id string[8,9] body1、微信支付分配的渠道商户唯一标识
2、当从业机构调用时,该字段必填,需填写从业机构下的渠道商户号
3、当渠道商户调用时,该字段无需填写
示例值:20001111
业务申请编号 business_code string[1,128] body1、只能由数字、字母或下划线组成
2、服务商自定义的唯一编号。每个编号对应一个申请单
3、建议前缀带上服务商商户号,参看示例值
示例值:1900013511_10000
+联系人信息 contact_info object body 联系人信息
参数名 变量 类型[长度限制] 必填 描述
联系人姓名 name string[1,1024] 1、明文只能由中文字符、英文字符、可见符号组成
2、该字段需进行加密处理,加密方法详见敏感信息加密说明
示例值:张三
联系人手机号 mobile string[1,1024] 1、填写11位的手机号
2、联系人手机号用于接收微信支付的重要管理信息及日常操作验证码
3、该字段需进行加密处理,加密方法详见敏感信息加密说明
示例值:13312345678
联系人身份证号码 id_card_number string[1,1024] 1、填写联系人的身份证号码
2、该字段需进行加密处理,加密方法详见敏感信息加密说明
示例值:430422199001236704
+主体信息 subject_info object body 主体信息
参数名 变量 类型[长度限制] 必填 描述
主体类型 subject_type string[1,32] SUBJECT_TYPE_ENTERPRISE:企业
SUBJECT_TYPE_INSTITUTIONS_CLONED:事业单位
SUBJECT_TYPE_INDIVIDUAL:个体工商户
SUBJECT_TYPE_OTHERS:其他组织
SUBJECT_TYPE_MICRO:小微商户
示例值:SUBJECT_TYPE_ENTERPRISE
+营业执照信息 business_licence_info object 主体类型为企业或个体户时,营业执照信息必填
参数名 变量 类型[长度限制] 必填 描述
营业执照注册号 licence_number string[1,32] 1、填写营业执照上的注册号
示例值:914201123033363296
营业执照照片 licence_copy string[1,255] 1、请填写通过《图片上传API》预先上传图片生成好的MediaID
示例值:0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV-4BBgVwtNkCHO_XXqK5dE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo
商户名称 merchant_name string[1,50] 1、个体工商户,不能以“公司”结尾
2、个体工商户,若营业执照上商户名称为空或为“无”,请填写"个体户+经营者姓名",如“个体户张三”
示例值:李四网络有限公司
法人姓名 legal_person string[1,64] 1、只能由中文字符、英文字符、可见符号组成
2、请填写营业执照的经营者/法定代表人姓名
示例值:李四
注册地址 company_address string[1,128] 1、请填写营业执照的注册地址
示例值:广东省深圳市南山区xx路xx号
营业执照有效日期 licence_valid_date string[1,64] 1、请填写营业执照上的营业期限,注意参照示例中的格式,长期用"forever"表示
2、结束时间需大于开始时间
3、有效期必须大于60天,即结束时间距当前时间需超过60天
示例值:["2017-10-28","2037-10-28"]["2017-10-28","forever"]
+登记证书信息 certificate_info object 主体类型为事业单位或其他组织时,登记证书信息必填
参数名 变量 类型[长度限制] 必填 描述
证书类型 cert_type string[1,32] 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] 1、请填写登记证书上的证书编号
示例值:111111111111
证书照片 cert_copy string[1,255] 1、请填写通过《图片上传API》预先上传图片生成好的MediaID
示例值:0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV-4BBgVwtNkCHO_XXqK5dE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo
商户名称 merchant_name string[1,50] 1、请填写登记证书上的商户名称
示例值:xx公益团体
法人姓名 legal_person string[1,64] 1、只能由中文字符、英文字符、可见符号组成
2、请填写登记证书上的法定代表人姓名
示例值:李四
注册地址 company_address string[1,128] 1、请填写登记证书的注册地址
示例值:广东省深圳市南山区xx路xx号
证书有效日期 cert_valid_date string[1,64] 1、请填写登记证书上的有效期限,注意参照示例中的格式,长期用"forever"表示
2、结束时间需大于开始时间
3、有效期必须大于60天,即结束时间距当前时间需超过60天
示例值:["2017-10-28","2037-10-28"]["2017-10-28","forever"]
单位证明函照片 company_prove_copy string[1,255] 1、主体类型为事业单位时,单位证明函照片必填
2、单位证明函格式[参考示例](https://kf.qq.com/touch/sappfaq/190428myABV719042867FFz6.html?scene_id=kf594&platform=15)
3、请填写通过《图片上传API》预先上传图片生成好的MediaID
示例值:0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV-4BBgVwtNkCHO_XXqK5dE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo
+辅助证明材料信息 assist_prove_info object 主体类型为小微商户时,辅助证明材料信息必填
参数名 变量 类型[长度限制] 必填 描述
小微经营类型 micro_biz_type string[1,32] MICRO_TYPE_STORE:门店场所 MI
CRO_TYPE_MOBILE:流动经营/便民服务
MICRO_TYPE_ONLINE:线上商品/服务交易
示例值:MICRO_TYPE_STORE
门店名称 store_name string[1,128] 1、填写规范:
门店场所:填写门店名称
流动经营/便民服务:填写经营/服务名称
线上商品/服务交易:填写线上店铺名称
示例值:大郎烧饼
门店省市编码 store_address_code string[1,16] 1、只能由数字组成
2、详细参见[微信支付提供的省市对照表]
3、填写规范:
门店场所:填写门店省市编码
流动经营/便民服务:填写经营/服务所在地省市编码
线上商品/服务交易:填写卖家所在地省市编码
示例值:440305
门店地址 store_address string[1,128] 1、填写规范:
门店场所:填写店铺详细地址,具体区/县及街道门牌号或大厦楼层;
流动经营/便民服务:填写“无”;
线上商品/服务交易:填写电商平台名称;
示例值:广东省深圳市南山区xx大厦x层xxxx室
门店门头照片 store_header_copy string[1,255] 1、请填写通过《图片上传API》预先上传图片生成好的MediaID
2、填写规范:
门店场所:提交门店门口照片,要求招牌清晰可见
流动经营/便民服务:提交经营/服务现场照片
线上商品/服务交易:提交店铺首页截图
示例值:0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV-4BBgVwtNkCHO_XXqK5dE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo
店内环境照片 store_indoor_copy string[1,255] 1、请填写通过《图片上传API》预先上传图片生成好的MediaID
2、填写规范:
门店场所:提交店内环境照片
流动经营/便民服务:可提交另一张经营/服务现场照片
线上商品/服务交易:提交店铺管理后台截图
示例值:0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV-4BBgVwtNkCHO_XXqK5dE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo
+经营许可证信息 special_operation_list array 特殊行业的经营许可证信息
参数名 变量 类型[长度限制] 必填 描述
行业id category_id int 参看微信支付提供的特殊行业id对照表
示例值:100
行业经营许可证资质照片 operation_copy_list array 1、请填写通过《图片上传API》预先上传图片生成好的MediaID
2、每个行业最多支持6张资质照片
示例值:0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV-4BBgVwtNkCHO_XXqK5dE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo
+法人身份信息 identification_info object body 法人身份信息
参数名 变量 类型[长度限制] 必填 描述
法人证件类型 identification_type string[1,64] 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、该字段需进行加密处理,加密方法详见敏感信息加密说明
示例值:李四
证件号码 identification_number string[1,1024] 1、明文只能由数字、字母组成
2、该字段需进行加密处理,加密方法详见[敏感信息加密说明]
示例值:430422199001236705
证件有效日期 identification_valid_date string[1,64] 1、请填写法人证件上的有效期限,注意参照示例中的格式,长期用"forever"表示
2、结束时间需大于开始时间
3、有效期必须大于60天,即结束时间距当前时间需超过60天
示例值:["2017-10-28","2037-10-28"]["2017-10-28","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

请求示例


{
  "channel_id": "20001111",
  "business_code": "1900013511_10000",
  "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": "[\"2017-10-28\",\"2037-10-28\"]"
	  },
    "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": "[\"2017-10-28\",\"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-4BBgVwtNkCHO_XXqK5dE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo",
          "store_indoor_copy": "0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV-4BBgVwtNkCHO_XXqK5dE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo"
		  },
       "special_operation_list":   [ 
	      {
            "category_id": 100,
            "operation_copy_list": [
              "0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV-4BBgVwtNkCHO_XXqK5dE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo",
			  "0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV-4BBgVwtNkCHO_XXqK5dE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo"
            ]
        }
	]
          
  },
  "identification_info": {
    "identification_type": "IDENTIFICATION_TYPE_IDCARD",
    "identification_name": "李四",
    "identification_number": "430422199001236705",
    "identification_valid_date": "[\"2017-10-28\",\"forever\"]",
    "identification_front_copy": "0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV-4BBgVwtNkCHO_XXqK5dE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo",
    "identification_back_copy": "0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV-4BBgVwtNkCHO_XXqK5dE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo"
  }
}

{
JAVA示例代码
}

返回参数

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

返回示例


{
  "applyment_state": "APPLYMENT_STATE_PASSED",
  "qrcode_data": "cGFnZXMvYXBwbHkvYXBpdzQvd2VsY29tZS93ZWxjb21lP2FwcGx5bWVudF9pZD14eHg=",
  "reject_param": "merchant_name",
  "reject_reason": "公司名称与工商局登记不一致",
  "authorize_state": "AUTHORIZE_STATE_AUTHORIZED",
  "applyment_id": 20000000011111
}
                    

http://2323weixin.qq.com
                    

错误码公共错误码

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


版本说明

关闭
V1.0
2020年6月19日
1.提交申请单接口上线

技术咨询

文档反馈