提交申请单API

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


普通服务商(银行、支付机构、电商平台不可用)申请获取小微进件权限后,可使用该接口提交商家资料,帮助商家入驻成为微信支付的小微商户。

注意:

• 本文档与“特约商户进件”文档是同一接口,不同的请求参数


• 仅供已获取小微进件权限的普通服务商使用(银行、支付机构、电商平台不可用)。

接口说明

适用对象:普通服务商

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

请求方式:POST

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


path 指该参数为路径参数

query 指该参数为URL参数

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


请求参数

参数名 变量 类型[长度限制] 必填 描述
业务申请编号 business_code string[1,124] query 1、只能由数字、字母或下划线组成,建议前缀为服务商商户号
2、服务商自定义的唯一编号
3、每个编号对应一个申请单,每个申请单审核通过后生成一个微信支付商户号
4、若申请单被驳回,可填写相同的“业务申请编号”,即可覆盖修改原申请单信息
示例值:1900013511_10000
+超级管理员信息 contact_info object query 超级管理员需在开户后进行签约,并接收日常重要管理信息和进行资金操作,请确定其为商户法定代表人或负责人。
参数名 变量 类型[长度限制] 必填 描述
超级管理员姓名 contact_name string[2,2048] 1、若为小微主体类型,要求“超级管理员姓名”与“经营者的身份证姓名”一致;
2、该字段需进行加密处理,加密方法详见《敏感信息加密说明(提醒:必须在HTTP头中上送Wechatpay-Serial)
示例值:hZ9evAM+Jv1z0NVa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg==
超级管理员身份证件号码 contact_id_number string[1,2048]

二选一

1、“超级管理员身份证号码”与“超级管理员微信openid”,二选一必填
2、超级管理员签约时,校验微信号绑定的银行卡实名信息,是否与该证件号码一致
3、可传身份证、来往内地通行证、来往大陆通行证、护照等证件号码
4、该字段需进行加密处理,加密方法详见《敏感信息加密说明(提醒:必须在HTTP头中上送Wechatpay-Serial)
示例值:BHLiCyOb+tI0m2qhZ9evAM+Jv1z0NVa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg==
超级管理员微信openid openid string[1,128] 1、“超级管理员身份证件号码”与“超级管理员微信openid”,二选一必填
2、超级管理员签约时,校验微信号是否与该微信openid一致
3、该字段需进行加密处理,加密方法详见《敏感信息加密说明(提醒:必须在HTTP头中上送Wechatpay-Serial)
示例值:5Kz4jBHLiCyOb+tI0m2qhZ9evAM+Jv1z0NVa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg==
联系手机 mobile_phone string[1,2048] 1、11位数字
2、用于接收微信支付的重要管理信息及日常操作验证码
3、该字段需进行加密处理,加密方法详见《敏感信息加密说明(提醒:必须在HTTP头中上送Wechatpay-Serial)
示例值:I0m2qhZ9evAM+Jv1z0NVa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg==
联系邮箱 contact_email string[1,2048]
  1. 用于接收微信支付的开户邮件及日常业务通知
    2、需要带@,遵循邮箱格式校验,该字段需进行加密处理,加密方法详见《敏感信息加密说明(提醒:必须在HTTP头中上送Wechatpay-Serial)
示例值:vAM+Jv1z0NVa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg==
+主体资料 subject_info object query 请填写商家的经营者证件、辅助证明材料等信息
参数名 变量 类型[长度限制] 必填 描述
主体类型 subject_type string[1,32] 主体类型包括:
SUBJECT_TYPE_MICRO(小微):无营业执照、免办理工商注册登记的实体商户
示例值:SUBJECT_TYPE_MICRO
+小微辅助证明材料 micro_biz_info object 请根据小微的实际经营情况,填写对应的经营场景资料
参数名 变量 类型[长度限制] 必填 描述
小微经营类型 micro_biz_type string[1,32] 请选择实际的小微经营场景,单选
枚举值:
1、MICRO_TYPE_STORE:门店场所
2、MICRO_TYPE_MOBILE:流动经营/便民服务
3、MICRO_TYPE_ONLINE:线上商品/服务交易
示例值:MICRO_TYPE_STORE
+ 门店场所 micro_store_info object 三选一填写 经营类型为“门店场所”时填写
参数名 变量 类型[长度限制] 必填 描述
门店名称 micro_name string[1,128] 填写门店名称
示例值:大郎烧饼
门店省市编码 micro_address_code string[1,16] 填写门店省市编码,只能由数字组成,详细参见《微信支付提供的省市对照表
示例值:440305
门店地址 micro_address string[1,128] 填写店铺详细地址,具体区/县及街道门牌号或大厦楼层
示例值:南山区xx大厦x层xxxx室
门店门头照片 store_entrance_pic string[1,255] 1、提交门店门口照片,要求招牌清晰可见
2、可上传1张图片,请填写通过《图片上传API》预先上传图片生成好的MediaID
示例值:0P3ng6KTIW4-Q_lCHO_XXqK5dE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo
店内环境照片 micro_indoor_copy string[1,255] 1、提交店内环境照片
2、可上传1张图片,请填写通过《图片上传API》预先上传图片生成好的MediaID
示例值:MAjmVtCz7ScmhEIThCaV-4BBgVwtNkCHO_XXqK5dE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo
门店经度 store_longitude string 数字或小数,商户自定义字段
示例值:113.941355
门店纬度 store_latitude string 数字或小数,商户自定义字段
示例值:22.546245
+ 流动经营/便民服务 micro_mobile_info object 经营类型为“流动经营/便民服务”时填写
参数名 变量 类型[长度限制] 必填 描述
经营/服务名称 micro_mobile_name string 请填写经营/服务名称
示例值:早餐车
经营/服务所在地省市 micro_mobile_city string 请填写经营/服务所在地省市编码
示例值:440305
经营/服务所在地(不含省市] micro_mobile_address string 填写“无"
示例值:无
经营/服务现场照片 micro_mobile_pics array 1、提交经营/服务现场照片
2、可上传多张图片,请填写通过《图片上传API》预先上传图片生成好的MediaID
示例值:0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo
+线上商品/服务交易 micro_online_info object 经营场景为“线上商品/服务交易”时填写
参数名 变量 类型[长度限制] 必填 描述
线上店铺名称 micro_online_store string 填写商家的线上店铺名称
示例值:李三服装店
电商平台名称 micro_ec_name string 填写电商平台名称
示例值:XX购物平台
店铺二维码 micro_qrcode string 二选一 1、店铺二维码或店铺链接二选一必填
2、若为电商小程序,可上传店铺页面的小程序二维码
3、可上传1张图片,请填写通过《图片上传API》预先上传图片生成好的MediaID
示例值:https://www.qq.com
店铺链接 micro_link string 1、店铺二维码或店铺链接二选一必填
2、请填写店铺主页链接,需符合网站规范
示例值:https://www.qq.com
+经营者身份证件 identity_info object 请上传经营者的身份证件
参数名 变量 类型[长度限制] 必填 描述
证件类型 id_doc_type enum 1、枚举值:
IDENTIFICATION_TYPE_IDCARD:中国大陆居民-身份证
示例值:IDENTIFICATION_TYPE_IDCARD
+身份证信息 id_card_info object 证件类型为“身份证”时填写
参数名 变量 类型[长度限制] 必填 描述
身份证人像面照片 id_card_copy string[1,256] 1、请上传经营者的身份证人像面照片
2、可上传1张图片,请填写通过《图片上传API》预先上传图片生成好的MediaID
示例值:j-ehEuo0BJqRTvDujqhThn4ReFxikqJ5YW6zFQ
身份证国徽面照片 id_card_national string[1,256] 1、请上传经营者的身份证国徽面照片
2、可上传1张图片,请填写通过《图片上传API》预先上传图片生成好的MediaID
示例值: qZm2XAUf-4KGprrKhpVBDIUv0OF4wFNIO4kqg05InE4d2I6_H7I4
身份证姓名 id_card_name string[8,256] 1、请填写经营者的身份证姓名,2~30个中文字符、英文字符、符号
2、该字段需进行加密处理,加密方法详见《敏感信息加密说明(提醒:必须在HTTP头中上送Wechatpay-Serial)
示例值:Pz4jBHLiCyOb+tI0m2qhZ9evAM+Jv1z0NVa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg==
身份证号码 id_card_number string[1,256] 1、请填写经营者的身份证号码
2、15位数字或17位数字+1位数字|X,该字段需进行加密处理,加密方法详见《敏感信息加密说明(提醒:必须在HTTP头中上送Wechatpay-Serial)
示例值:3uGdtkRJJp0/0eow96uY1Pk7Rq79Jtt7+I8juwEc4P4TG5xzchG/5IL9DBd+Z0zZXkw==
身份证有效期开始时间 card_period_begin string[1,128] 1、必填,请按照示例值填写
2、结束时间大于开始时间
示例值:2026-06-06
身份证有效期结束时间 card_period_end string[1,128] 1、必填,请按照示例值填写
2、若证件有效期为长期,请填写:长期
3、结束时间大于开始时间
4、证件有效期需大于60天
示例值:2026-06-06
+经营资料 business_info object query请填写商家的商家简称、客服电话。
参数名 变量 类型[长度限制] 必填 描述
商户简称 merchant_shortname string[1,64] 在支付完成页向买家展示,需与微信经营类目相关
示例值:张三餐饮店
客服电话 service_phone string[1,32] 在交易记录中向买家展示,请确保电话畅通以便平台回拨确认
示例值:0758XXXXX
+结算规则 settlement_info object query 请填写商家的结算费率规则、特殊资质等信息
参数名 变量 类型[长度限制] 必填 描述
入驻结算规则ID settlement_id string 请选择结算规则ID,详细参见《费率结算规则对照表
示例值:703
所属行业 qualification_type string 请填写所属行业名称,建议参见《费率结算规则对照表
示例值:餐饮
特殊资质图片 qualifications array 1、根据所属行业的特殊资质要求提供,详情查看《费率结算规则对照表
2、最多可上传5张照片,请填写通过《图片上传API》预先上传图片生成好的MediaID
优惠费率活动ID activities_id string 条件选填 选择指定活动ID,如果商户有意向报名优惠费率活动,该字段必填,详细参见优惠费率活动对照表
示例值:20191030111cff5b5e
优惠费率活动值 activities_rate string[1,50] 条件选填 1、若填写“优惠费率活动ID”,则必填
2、根据优惠费率活动规则,由服务商自定义填写,支持两个小数点,需在优惠费率活动ID指定费率范围内,如0.6%
(接口无需传%,只需传数字)
示例值:0.6
优惠费率活动补充材料 activities_additions array 1、根据所选优惠费率活动,提供相关材料,详细参见优惠费率活动对照表
2、最多可上传5张照片,请填写通过《图片上传API》预先上传图片生成好的MediaID
+收款银行卡 bank_account_info object query 请填写商家提现收款的银行卡信息
参数名 变量 类型[长度限制] 必填 描述
账户类型 bank_account_type string[1,32] 若主体为小微,可填写:经营者个人银行卡
枚举值:
BANK_ACCOUNT_TYPE_PERSONAL:经营者个人银行卡
示例值:BANK_ACCOUNT_TYPE_CORPORATE
开户名称 account_name string[1,2048] 1、选择“经营者个人银行卡”时,开户名称必须与“经营者证件姓名”一致,
2、该字段需进行加密处理,加密方法详见《敏感信息加密说明(提醒:必须在HTTP头中上送Wechatpay-Serial)
示例值:AYiKrzcroQv3OR0p3pp+I8juwEc4P4TG5xzchG/5IL9DBd+Z0zZXkw==
开户银行 account_bank string[1,128] 开户银行,详细参见《开户银行对照表
示例值:工商银行
开户银行省市编码 bank_address_code string[1,128] 至少精确到市,详细参见《省市区编号对照表
示例值:110000
开户银行联行号 bank_branch_id string[1,128] 二选一 1、“开户银行”为17家直连银行无需填写
2、“开户银行”为其他银行,则开户银行全称(含支行)和开户银行联行号二选一
3、详细参见《开户银行全称(含支行)对照表
示例值:402713354941
开户银行全称(含支行] bank_name string[1,128] 1、“开户银行”为17家直连银行无需填写
2、“开户银行”为其他银行,则开户银行全称(含支行)和开户银行联行号二选一
3、需填写银行全称,如"深圳农村商业银行XXX支行",详细参见《开户银行全称(含支行)对照表
示例值:施秉县农村信用合作联社城关信用社
银行账号 account_number string[1,2048] 1、数字,长度遵循系统支持的卡号长度要求表
2、该字段需进行加密处理,加密方法详见《敏感信息加密》说明(提醒:必须在HTTP头中上送Wechatpay-Serial)
示例值:SC7Rsu3WL8sPndjXTd75kPkyjqnoMRrEEaYQE8ZRGYoeorwC+w==
+补充材料 addition_info object query 根据实际审核情况,额外要求商家提供指定的补充资料
参数名 变量 类型[长度限制] 必填 描述
法人开户承诺函 legal_person_commitment string 1、请上传法定代表人或负责人亲笔签署的开户承诺函扫描件(下载模板)。亲笔签名承诺函内容清晰可见,不得有涂污,破损,字迹不清晰现象。
2、请填写通过《图片上传API》预先上传图片生成好的MediaID
示例值:Uf-4KGprrKhpVBDIUv0OF4wFNIO4kqg05InE4d2I6_H7I4
法人开户意愿视频 legal_person_video string 1、建议法人按如下话术录制“法人开户意愿视频”:
我是#公司全称#的法定代表人(或负责人),特此证明本公司申请的商户号为我司真实意愿开立且用于XX业务(或XX服务)。我司现有业务符合法律法规及腾讯的相关规定。
2、支持上传20M内的视频,格式可为avi、wmv、mpeg、mp4、mov、mkv、flv、f4v、m4v、rmvb
3、请填写通过《图片上传API》预先上传视频生成好的MediaID
示例值:KGprrKhpVBDIUv0OF4wFNIO4kqg05InE4d2I6_H7I4
补充材料 business_addition_pics array 1、最多可上传5张照片
2、请填写通过《图片上传API》预先上传图片生成好的MediaID
补充说明 business_addition_msg string[1,512] 补充说明
示例值:特殊情况,说明原因

请求示例


{
  "business_code": "1900013511_10000",
  "contact_info": {
    "contact_name": "pVd1HJ6zy0NVa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg==",
    "contact_id_number": "pVd1HJ6zyvPedzGaV+X3qtmrq9bbm2qhZ9evAM+Jv1z0NVa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg==",
    "openid": "pVd1HJ6z9evAM+Jv1z0NVa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg==",
    "mobile_phone": "pVd1HJ6z+tI0m2qhZ9evAM+Jv1z0NVa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg==",
    "contact_email": "pVd1HJ6zyvPedz8MRtelw/wDa4SzfeespQO/0kjiwfqdfg=="
  },
  "subject_info": {
    "subject_type": "SUBJECT_TYPE_MICRO",
    "micro_biz_info": {
      "micro_biz_type": "MICRO_TYPE_STORE",
      "micro_store_info": {
        "micro_name": "大郎烧饼",
        "micro_address_code": "440305",
        "micro_address": "南山区xx大厦x层xxxx室",
        "store_entrance_pic": "0P3ng6KTIW4-Q_l2FjKLZuhHFwczhJehHhAZN6BKXQPcs-VvdSo",
        "micro_indoor_copy": "0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMwczhJehHhAZN6BKXQPcs-VvdSo",
        "store_longitude": "113.941355",
        "store_latitude": "22.546245",
        "address_certification": "0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAzhJehHhAZN6BKXQPcs-VvdSo"
      },
      "micro_mobile_info": {
        "micro_mobile_name": "早餐车",
        "micro_mobile_city": "440305",
        "micro_mobile_address": "无",
        "micro_mobile_pics": [
          "0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAO_XXqK5dE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo"
        ]
      },
      "micro_online_info": {
        "micro_online_store": "李三服装店",
        "micro_ec_name": "XX购物平台",
        "micro_qrcode": "https://www.qq.com",
        "micro_link": "https://www.qq.com"
      }
    },
    "identity_info": {
      "id_doc_type": "IDENTIFICATION_TYPE_IDCARD",
      "id_card_info": {
        "id_card_copy": "jTpGmxUX3FBWqRTvDujqhThn4ReFxikqJ5YW6zFQ",
        "id_card_national": "47ZC6GC-vnrbEny__Ie_An5-tCpkqg05InE4d2I6_H7I4",
        "id_card_name": "pVd1HJ6zyvPedzGaV+X3qtmrq9Da4SzfeespQO/0kjiwfqdfg==",
        "id_card_number": "AOZdYGISxo0eow96uY1Pk7Rq79Jtt7+I8juwEc4P4TG5xzchG/5IL9DBd+Z0zZXkw==",
        "card_period_begin": "2026-06-06",
        "card_period_end": "2026-06-06"
      },
  },
},
  "business_info": {
    "merchant_shortname": "张三餐饮店",
    "service_phone": "0758XXXXX",
  },
  "settlement_info": {
    "settlement_id": "719",
    "qualification_type": "餐饮",
    "qualifications": [
      "string"
    ],
    "activities_id": "716",
    "activities_rate": "0.6",
    "activities_additions": [
      "string"
    ]
  },
  "bank_account_info": {
    "bank_account_type": "BANK_ACCOUNT_TYPE_PERSONAL",
    "account_name": "AOZdYGISxo4ytt7+I8juwEc4P4TG5xzchG/5IL9DBd+Z0zZXkw==",
    "account_bank": "工商银行",
    "bank_address_code": "110000",
    "bank_branch_id": "402713354941",
    "bank_name": "施秉县农村信用合作联社城关信用社",
    "account_number": "d+xT+MQCvrLHUVDWv/8MR/dBXTd75kPkyjqnoMRrEEaYQE8ZRGYoeorwC+w=="
  },
  "addition_info": {
    "legal_person_commitment": "47ZC6GC-vnrbEny__Ie_An5-tCpqg05InE4d2I6_H7I4",
    "legal_person_video": "47ZC6GC-vnrbEny__Ie_An5-tCpqxucuxi-vByf3Gjm7KE53JXvGy9tI6_H7I4",
    "business_addition_pics": [
      "string"
    ],
    "business_addition_msg": "特殊情况,说明原因"
  }
}
    
{
JAVA示例代码
}
    

返回参数

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

返回示例


> 200 Response
{
  "applyment_id": 2000002124775691
}                             

    http://2323weixin.qq.com
                                

错误码公共错误码

错误码 描述 解决方案
SYSTEMERROR 系统错误 系统异常,请使用相同参数稍后重新调用
PARAM_ERROR 参数错误 请使用正确的参数重新调用
PROCESSING 存在流程进行中的申请单,请检查是否重入 可通过查询申请状态接口查看此申请单的申请状态,或更换out_request_no提交新的申请单
NO_AUTH 商户权限异常 请确认是否已经开通相关权限
RATE_LIMITED 频率限制 请降低调用频率
APPLYMENT_NOTEXIST 申请单不存在 确认入参,传入正确的申请单编号

版本说明

关闭
V1.1
2020年4月9日
1.新增经营资料(business_info)字段
V1.0
2020年3月13日
1.小微进件提交申请单接口上线