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

提交申请单API

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


服务商(银行、支付机构、电商平台不可用)使用该接口提交商家资料,帮助商家入驻成为微信支付的特约商户。
流程指引请看 特约商户进件流程

注意:

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

接口说明

适用对象:服务商

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

请求方式:POST


path指该参数为路径参数

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

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


请求参数

参数名 变量 类型[长度限制] 必填 描述
业务申请编号 business_code string[1,128] body
  1. 1、服务商自定义的唯一编号。
  2. 2、每个编号对应一个申请单,每个申请单审核通过后会生成一个微信支付商户号。
  3. 3、若申请单被驳回,可填写相同的“业务申请编号”,即可覆盖修改原申请单信息。
示例值:APPLYMENT_00000000001
+超级管理员信息 contact_info object body 特约商户的超级管理员,超级管理员需在开户后进行签约,并接收日常重要管理信息和进行资金操作,请确定其为商户法定代表人或负责人。
参数名 变量 类型[长度限制] 必填 描述
超级管理员姓名 contact_name string[2,2048]
  1. 1、该字段需进行加密处理,加密方法详见敏感信息加密说明(提醒:必须在HTTP头中上送Wechatpay-Serial)
示例值:pVd1HJ6zyvPedzGaV+X3qtmrq9bb9tPttdY+aQ6zBlw0xnOiNW6Hzy7UtC+xriuhZ9evAM+Jv1z0NVa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg==
超级管理员身份证件号码 contact_id_number string[1,2048] 二选一 1、“超级管理员身份证号码”与“超级管理员微信openid”,二选一必填。
2、超级管理员签约时,校验微信号绑定的银行卡实名信息,是否与该证件号码一致。
3、可传身份证、来往内地通行证、来往大陆通行证、护照等证件号码。
4、该字段需进行加密处理,加密方法详见敏感信息加密说明(提醒:必须在HTTP头中上送Wechatpay-Serial)
示例值:pVd1HJ6zyvPedzGaV+X3qtWKIjOv/69bDnuC4EL5Kz4jBHLiCyOb+tI0m2qhZ9evAM+Jv1z0NVa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg==
超级管理员微信openid openid string[1,128] 1、“超级管理员身份证件号码”与“超级管理员微信openid”,二选一必填。
2、超级管理员签约时,校验微信号是否与该微信openid一致。
3、openid的获取方式详见openid获取
示例值:oUpF8uMuAJO_M2pxb1Q9zNjWeS6o
联系手机 mobile_phone string[1,2048] 1、11位数字。
2、用于接收微信支付的重要管理信息及日常操作验证码。
3、该字段需进行加密处理,加密方法详见敏感信息加密说明(提醒:必须在HTTP头中上送Wechatpay-Serial)
示例值:pVd1HJ6zyvPedzGaV+Xv/69bDnuC4EL5Kz4jBHLiCyOb+tI0m2qhZ9evAM+Jv1z0NVa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg==
联系邮箱 contact_email string[1,2048] 1、用于接收微信支付的开户邮件及日常业务通知。
2、需要带@,遵循邮箱格式校验,该字段需进行加密处理,加密方法详见敏感信息加密说明(提醒:必须在HTTP头中上送Wechatpay-Serial)
示例值:pVd1HJ6zyvPedzGaV+P/2qIdGdONoDzZelrxCl/NWWKIjOv/69bDnuC4EL5Kz4jBHLiCyOa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg==
+主体资料 subject_info object body 请填写商家的营业执照/登记证书、经营者/法人的证件等信息。
参数名 变量 类型[长度限制] 必填 描述
主体类型 subject_type string[1,32] 主体类型需与营业执照/登记证书上一致,可参考选择主体指引
SUBJECT_TYPE_INDIVIDUAL(个体户):营业执照上的主体类型一般为个体户、个体工商户、个体经营;
SUBJECT_TYPE_ENTERPRISE(企业):营业执照上的主体类型一般为有限公司、有限责任公司;
SUBJECT_TYPE_INSTITUTIONS(党政、机关及事业单位):包括国内各级、各类政府机构、事业单位等(如:公安、党团、司法、交通、旅游、工商税务、市政、医疗、教育、学校等机构);
SUBJECT_TYPE_OTHERS(其他组织):不属于企业、政府/事业单位的组织机构(如社会团体、民办非企业、基金会),要求机构已办理组织机构代码证。
示例值:SUBJECT_TYPE_ENTERPRISE
+营业执照 business_license_info object 条件选填 1、主体为个体户/企业,必填。
2、请上传“营业执照”,需年检章齐全,当年注册除外。
参数名 变量 类型[长度限制] 必填 描述
营业执照照片 license_copy string[1,255] 1、可上传1张图片,请填写通过图片上传API预先生成的MediaID。
2、 请上传彩色照片or彩色扫描件or复印件(需加盖公章鲜章),可添加“微信支付”相关水印(如微信支付认证) 。
示例值:47ZC6GC-vnrbEny_Ie_An5-tCpqxucuxi-vByf3Gjm7KE53JXvGy9tqZm2XAUf-4KGprrKhpVBDIUv0OF4wFNIO4kqg05InE4d2I6_H7I4
注册号/统一社会信用代码 license_number string[1,32] 请填写营业执照上的营业执照注册号,注册号格式须为15位数字或18位数字|大写字母。
示例值:123456789012345678
商户名称 merchant_name string[1,128] 1、请填写营业执照上的商户名称,2~110个字符,支持括号。
2、个体户,不能以“公司”结尾。
3、个体户,若营业执照上商户名称为“空”或“无”时,填写"个体户+经营者姓名",如“个体户张三”。
示例值:腾讯科技有限公司
个体户经营者/法人姓名 legal_person string[1,64] 请填写营业执照的经营者/法定代表人姓名。
示例值:张三
+登记证书 certificate_info object 条件选填 主体为党政、机关及事业单位/其他组织,必填。
1、党政、机关及事业单位:请上传相关部门颁发的证书,如:事业单位法人证书、统一社会信用代码证书。
2、其他组织:请上传相关部门颁发的证书,如:社会团体法人登记证书、民办非企业单位登记证书、基金会法人登记证书。
参数名 变量 类型[长度限制] 必填 描述
登记证书照片 cert_copy string[1,255] 1、请填写通过图片上传API预先生成的MediaID,上传1张图片即可;
2、请上传彩色照片or彩色扫描件or复印件(需加盖公章鲜章),可添加“微信支付”相关水 印(如微信支付认证) 。
示例值: 0P3ng6_XXqK5dE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo
登记证书类型 cert_type string[1,25] 登记证书的类型
枚举值:
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
商户名称 merchant_name string[1,128] 请填写登记证书上的商户名称。
示例值:xx公益团体
注册地址 company_address string[1,128] 请填写登记证书的注册地址。
示例值:广东省深圳市南山区xx路xx号
法人姓名 legal_person string[1,64] 1、只能由中文字符、英文字符、可见符号组成。
2、请填写登记证书上的法定代表人姓名。
示例值:李四
有效期限开始日期 period_begin string[1,32] 1、必填, 请参考示例值填写。
2、开始日期,开始日期需大于当前日期
示例值:2019-08-01
有效期限结束日期 period_end string[1,32] 1、必填,请参考示例值填写。
2、若证件有效期为长期,请填写:长期。
3、结束日期大于开始日期。
4、有效期必须大于60天。
示例值:2029-08-01,长期
+组织机构代码证 organization_info object 条件选填

body 主体为企业/党政、机关及事业单位/其他组织,且证件号码不是18位时必填。

注:
若营业执照未三证合一 ,该参数必传;
若营业执照三证合一 ,该参数可不传。
参数名 变量 类型[长度限制] 必填 描述
组织机构代码证照片 organization_copy string[1,256] 可上传1张图片,请填写通过图片上传API预先上传图片生成好的MediaID。
示例值:47ZC6GCGy9tqZm2XAUf-4KGprrKhpVBDIUv0OF4wFNIO4kqg05InE4d2I6_H7I4
组织机构代码 organization_code string[1,32] 1、请填写组织机构代码证上的组织机构代码。
2、可填写9或10位数字|字母|连字符。
示例值:123456789-A
组织机构代码证有效期开始日期 org_period_begin string[1,32] 1、请按照示例值填写。
2、证件有效期需大于60天。
示例值:2019-08-01
组织机构代码证有效期结束日期 org_period_end string[1,32] 1、请按照示例值填写。
2、若证件有效期为长期,请填写:长期。
3、结束日期大于开始日期。
4、证件有效期需大于60天。
示例值:2029-08-01,长期
单位证明函照片 certificate_letter_copy string[1,255] 条件选填 1、主体类型为党政、机关及事业单位选传;
    (1)若上传,则审核通过后即可签约,无需汇款验证。
    (2)若未上传,则审核通过后,需汇款验证。
2、主体为个体户、企业、其他组织等,不需要上传本字段。
3、请参照示例图打印单位证明函,全部信息需打印,不支持手写商户信息,并加盖公章。
4、可上传1张图片,请填写通过图片上传API预先上传图片生成好的MediaID。
示例值: 47ZC6GC-vnrbEny_Ie_An5-tCpqxucuxi-vByf3Gjm7KEIUv0OF4wFNIO4kqg05InE4d2I6_H7I4
+经营者/法人身份证件 identity_info object body 1、个体户:请上传经营者的身份证件。
2、企业/党政、机关及事业单位/其他组织:请上传法人的身份证件。
参数名 变量 类型[长度限制] 必填 描述
证件类型 id_doc_type string[1,42]
  1. 个体户/企业/党政、机关及事业单位/其他组织:可选择任一证件类型。

枚举值:

  1. IDENTIFICATION_TYPE_IDCARD:中国大陆居民-身份证
  2. IDENTIFICATION_TYPE_OVERSEA_PASSPORT:其他国家或地区居民-护照
  3. IDENTIFICATION_TYPE_HONGKONG_PASSPORT:中国香港居民-来往内地通行证
  4. IDENTIFICATION_TYPE_MACAO_PASSPORT:中国澳门居民-来往内地通行证
  5. IDENTIFICATION_TYPE_TAIWAN_PASSPORT:中国台湾居民-来往大陆通行证
示例值:IDENTIFICATION_TYPE_IDCARD
+身份证信息 id_card_info object 证件类型为“身份证”时填写。
参数名 变量 类型[长度限制] 必填 描述
身份证人像面照片 id_card_copy string[1,256] 1、请上传彩色照片or彩色扫描件or复印件(需加盖公章鲜章),可添加“微信支付”相关水印(如微信支付认证)。
2、可上传1张图片,请填写通过图片上传API预先上传图片生成好的MediaID。
示例值:jTpGmxUX3FBWVQ5NJTZvlKX_gdU4cRz7z5NxpnFuAxhBTEO_PvWkfSCJ3zVIn001D8daLC-ehEuo0BJqRTvDujqhThn4ReFxikqJ5YW6zFQ
身份证国徽面照片 id_card_national string[1,256] 1、请上传彩色照片or彩色扫描件or复印件(需加盖公章鲜章),可添加“微信支付”相关水印(如微信支付认证)。
2、可上传1张图片,请填写通过图片上传API预先上传图片生成好的MediaID。
示例值: 47ZC6GC-vnrbEny_Ie_An5-tCpqxucuxi-vByf3Gjm7KE53JXvGy9tqZm2XAUf-4KGprrKhpVBDIUv0OF4wFNIO4kqg05InE4d2I6_H7I4
身份证姓名 id_card_name string[1,256] 1、请填写个体户经营者/法定代表人对应身份证的姓名,2~30个中文字符、英文字符、符号。
2、该字段需进行加密处理,加密方法详见敏感信息加密说明(提醒:必须在HTTP头中上送Wechatpay-Serial)
示例值:pVd1HJ6zyvPedzGaV+X3qtmrq9bb9tPRDm2qhZ9evAM+Jv1z0NVa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg==
身份证号码 id_card_number string[1,256] 1、请填写个体户经营者/法定代表人对应身份证的号码。
2、15位数字或17位数字+1位数字|X,该字段需进行加密处理,加密方法详见敏感信息加密说明(提醒:必须在HTTP头中上送Wechatpay-Serial)
示例值:AOZdYGISxo4y44/UgZ69bdagEcGe+vLYiKrzcrodtkRJJp0/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天。
示例值:2036-06-06
+其他类型证件信息 id_doc_info object 证件类型为“来往内地通行证、来往大陆通行证、护照”时填写。
参数名 变量 类型[长度限制] 必填 描述
证件照片 id_doc_copy string[1,256] 1、请上传彩色照片or彩色扫描件or复印件(需加盖公章鲜章),可添加“微信支付”相关水印(如微信支付认证)。
2、可上传1张图片,请填写通过图片上传API预先上传图片生成好的MediaID。
示例值:jTpGmxUX3FBWVQ5NJTZvlKX_gdU4cRz7z5NxpnFuAxhBTEO_PvWkfSCJ3zVIn001D8daLC-ehEuo0BJqRTvDujqhThn4ReFxikqJ5YW6zFQ
证件姓名 id_doc_name string[1,128] 1、请填写经营者/法定代表人的证件姓名,2~30个中文字符、英文字符、符号。
2、该字段需进行加密处理,加密方法详见敏感信息加密说明(提醒:必须在HTTP头中上送Wechatpay-Serial)
示例值:pVd1HJ6NxLMpRSvWKIjOv/69bDnuC4EL5Kz4jBHLiCyOb+tI0m2qhZ9evAM+Jv1z0NVa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg==
证件号码 id_doc_number string[1,128] 1、请填写经营者/法定代表人的证件号码。
2、8-30位数字|字母|连字符,该字段需进行加密处理,加密方法详见敏感信息加密说明(提醒:必须在HTTP头中上送Wechatpay-Serial)
示例值:AOZdYGISxo4V4oASq6ZFonjTtgjjgKsadIKHXtb3JZKGZjduGdtkRJJp0/0eow96uY1Pk7Rq79Jtt7+I8juwEc4P4TG5xzchG/5IL9DBd+Z0zZXkw==
证件有效期开始时间 doc_period_begin string[1,128] 1、选填,请按照示例值填写。
2、结束时间大于开始时间。
示例值:2019-06-06
证件有效期结束时间 doc_period_end string[1,128] 1、必填,请按照示例值填写。
2、若证件有效期为长期,请填写:长期。
3、结束时间大于开始时间。
4、证件有效期需大于60天。
示例值:2026-06-06
经营者/法人是否为受益人 owner bool 1、若经营者/法人是最终受益人,则填写:true。
2、若经营者/法人不是最终受益人,则填写:false。
示例值:true
+最终受益人信息(UBO) ubo_info object 条件选填 若经营者/法人不是最终受益所有人,则需提填写受益所有人信息。
根据国家相关法律法规,需要提供公司受益所有人信息,受益所有人需符合至少以下条件之一:
1、直接或者间接拥有超过25%公司股权或者表决权的自然人。
2、通过人事、财务等其他方式对公司进行控制的自然人。
3、公司的高级管理人员,包括公司的经理、副经理、财务负责人、上市公司董事会秘书和公司章程规定的其他人员。
参数名 变量 类型[长度限制] 必填 描述
证件类型 id_type string[1,37]
  1. 填写受益人的证件类型。

枚举值:

  1. IDENTIFICATION_TYPE_IDCARD:中国大陆居民-身份证
  2. IDENTIFICATION_TYPE_OVERSEA_PASSPORT:其他国家或地区居民-护照
  3. IDENTIFICATION_TYPE_HONGKONG_PASSPORT:中国香港居民-来往内地通行证
  4. IDENTIFICATION_TYPE_MACAO_PASSPORT:中国澳门居民-来往内地通行证
  5. IDENTIFICATION_TYPE_TAIWAN_PASSPORT:中国台湾居民-来往大陆通行证

示例值:IDENTIFICATION_TYPE_IDCARD

身份证人像面照片 id_card_copy string[1,256] 条件选填 1、受益人的证件类型为“身份证”时,上传身份证人像面照片。
2、可上传1张图片,请填写通过图片上传API预先上传图片生成好的MediaID。
3、请上传彩色照片or彩色扫描件or复印件(需加盖公章鲜章),可添加“微信支付”相关水印(如微信支付认证)。
示例值:jTpGmxUX3FBWeFxikqJ5YW6zFQ
身份证国徽面照片 id_card_national string[1,256] 条件选填 1、受益人的证件类型为“身份证”时,上传身份证国徽面照片。
2、可上传1张图片,请填写通过图片上传API预先上传图片生成好的MediaID。
3、请上传彩色照片or彩色扫描件or复印件(需加盖公章鲜章),可添加“微信支付”相关水印(如微信支付认证)。
示例值:jTpGmxUXqRTvDujqhThn4ReFxikqJ5YW6zFQ
证件照片 id_doc_copy string[1,256] 条件选填 1、受益人的证件类型为“来往内地通行证、来往大陆通行证、护照”时,上传证件照片。
2、可上传1张图片,请填写通过图片上传API预先上传图片生成好的MediaID。
3、请上传彩色照片or彩色扫描件or复印件(需加盖公章鲜章),可添加“微信支付”相关水印(如微信支付认证)。
示例值:jTpGmxUX3FBWVQ5NJTZvvDujqhThn4ReFxikqJ5YW6zFQ
受益人姓名 name string[1,128] 该字段需进行加密处理,加密方法详见敏感信息加密说明(提醒:必须在HTTP头中上送Wechatpay-Serial)
示例值:AOZdYGISxo4y44/Ug4P4TG5xzchG/5IL9DBd+Z0zZXkw==
证件号码 id_number string[1,128] 该字段需进行加密处理,加密方法详见敏感信息加密说明(提醒:必须在HTTP头中上送Wechatpay-Serial)
示例值:AOZdYGISxo4y44/Ug4P4TG5xzchG/5IL9DBd+Z0zZXkw==
证件有效期开始时间 id_period_begin string[1,128] 1、请按照示例值填写。
2、结束时间大于开始时间。
示例值:2019-06-06
证件有效期结束时间 id_period_end string[1,128] 1、请按照示例值填写,若证件有效期为长期,请填写:长期。
2、结束时间大于开始时间。
3、证件有效期需大于60天。
示例值:2026-06-06
+经营资料 business_info object body 请填写商家的经营业务信息、售卖商品/提供服务场景信息。
参数名 变量 类型[长度限制] 必填 描述
商户简称 merchant_shortname string[1,64] 1、请输入2-30个字符,支持中文/字母/数字/特殊符号
2、在支付完成页向买家展示,需与微信经营类目相关;
3、简称要求
    (1)不支持单纯以人名来命名,若为个体户经营,可用“个体户+经营者名称”或“经营者名 称+业务”命名,如“个体户张三”或“张三餐饮店”;
    (2)不支持无实际意义的文案,如“XX特约商户”、“800”、“XX客服电话XXX”;
示例值:张三餐饮店
客服电话 service_phone string[1,32] 1、请填写真实有效的客服电话,将在交易记录中向买家展示,提供咨询服务;
2、请确保电话畅通,以便入驻后平台回拨确认。
示例值:0758XXXXX
+经营场景 sales_info object 请根据实际经营情况,填写经营场景
参数名 变量 类型[长度限制] 必填 描述
经营场景类型 sales_scenes_type array
  1. 1、请勾选实际售卖商品/提供服务场景(至少一项),以便为你开通需要的支付权限。
  2. 2、建议只勾选目前必须的场景,以便尽快通过入驻审核,其他支付权限可在入驻后再根据实际需要发起申请。

枚举值:

  1. SALES_SCENES_STORE:线下门店
  2. SALES_SCENES_MP:公众号
  3. SALES_SCENES_MINI_PROGRAM:小程序
  4. SALES_SCENES_WEB:PC网站
  5. SALES_SCENES_APP:APP
  6. SALES_SCENES_WEWORK:企业微信

示例值: “SALES_SCENES_STORE”,“SALES_SCENES_MP”

+线下门店场景 biz_store_info object 条件选填
  1. 1、审核通过后,服务商可帮商户发起付款码支付、JSAPI支付。
  2. 2、当“经营场景类型“选择“SALES_SCENES_STORE“,该场景资料必填。
参数名 变量 类型[长度限制] 必填 描述
门店名称 biz_store_name string[1,128] 请填写门店名称。
示例值:大郎烧饼
门店省市编码 biz_address_code string[1,128] 只能由数字组成,详细参见微信支付提供的省市对照表
示例值:440305
门店地址 biz_store_address string[1,128] 请填写详细的经营场所信息,如有多个场所,选择一个主要场所填写即可。
示例值:南山区xx大厦x层xxxx室
门店门头照片 store_entrance_pic array[1, 1024] 1、请上传门店照片(要求门店招牌清晰可见)。若为停车场、售卖机等无固定门头照片 的经营场所,请提供真实的经营现场照片即可;
2、请填写通过图片上传API预先上传图片生成好的MediaID。
示例值: 0P3ng6KTIW4-QJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo
店内环境照片 indoor_pic array[1,1024] 1、请上传门店内部环境照片。若为停车场、售卖机等无固定门头照片的经营场所,请提 供真实的经营现场照片即可;
2、请填写通过图片上传API预先上传图片生成好的MediaID。
示例值:0P3ng6KTIW4-Q_l2FjmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo
线下场所对应的商家APPID biz_sub_appid string[1,256] 1、可填写已认证的公众号、小程序、应用的APPID,其中公众号APPID需是已认证的服务 号、政府或媒体类型的订阅号。
2、完成进件后,系统发起特约商户号与该AppID的绑定(即配置为sub_appid,可在发起支付时传入)
    (1)若APPID主体与商家主体一致,则直接完成绑定;
    (2)若APPID主体与商家主体不一致,则商户签约时显示《联合营运承诺函》,并且 AppID的管理员需登录公众平台确认绑定意愿;( 暂不支持绑定异主体的应用APPID)
示例值:wx1234567890123456
+公众号场景 mp_info object 条件选填
  1. 1、审核通过后,服务商可帮商家发起JSAPI支付。
  2. 2、当“经营场景类型“选择” SALES_SCENES_MP “,该场景资料必填。
参数名 变量 类型[长度限制] 必填 描述
服务商公众号APPID mp_appid string[1,256] 二选一 1、服务商公众号APPID与商家公众号APPID,二选一必填。
2、可填写当前服务商商户号已绑定的公众号APPID。
示例值:wx1234567890123456
商家公众号APPID mp_sub_appid string[1,256] 1、服务商公众号APPID与商家公众号APPID,二选一必填。
2、可填写与商家主体一致且已认证的公众号APPID,需是已认证的服务号、政府或媒体类型的订阅号。
3、审核通过后,系统将发起特约商家商户号与该AppID的绑定(即配置为sub_appid),服务商随后可在发起支付时选择传入该appid,以完成支付,并获取sub_openid用于数据统计,营销等业务场景 。
示例值:wx1234567890123456
公众号页面截图 mp_pics array[1, 1024] 条件选填 1、请提供展示商品/服务的页面截图/设计稿(最多5张),若公众号未建设完善或未上线请务必提供。
2、请填写通过图片上传API预先上传图片生成好的MediaID。
示例值:0P3ng6KTIW4-Q_l2FjmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo
+小程序场景 mini_program_info object 条件选填
  1. 1、审核通过后,服务商可帮商家发起JSAPI支付。
  2. 2、当“经营场景类型“选择”SALES_SCENES_MINI_PROGRAM“,该场景资料必填。
参数名 变量 类型[长度限制] 必填 描述
服务商小程序APPID mini_program_appid string[1,256] 二选一 1、服务商小程序APPID与商家小程序APPID,二选一必填。
2、可填写当前服务商商户号已绑定的小程序APPID。
示例值:wx1234567890123456
商家小程序APPID mini_program_sub_appid string[1,256] 1、服务商小程序APPID与商家小程序APPID,二选一必填;
2、请填写已认证的小程序APPID;
3、完成进件后,系统发起特约商户号与该AppID的绑定(即配置为sub_appid可在发起支付时传入)
(1)若APPID主体与商家主体/服务商主体一致,则直接完成绑定;
(2)若APPID主体与商家主体/服务商主体不一致,则商户签约时显示《联合营运承诺函》,并且AppID的管理员需登录公众平台确认绑定意愿;
示例值:wx1234567890123456
小程序截图 mini_program_pics array[1, 1024] 条件选填 1、请提供展示商品/服务的页面截图/设计稿(最多5张),若小程序未建设完善或未上线 请务必提供;
2、请填写通过图片上传API预先上传图片生成好的MediaID。
示例值:0P3ng6KTIW4-Q_l2FjmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo
+APP场景 app_info object 条件选填
  1. 1、审核通过后,服务商可帮商家发起APP支付。
  2. 2、当“经营场景类型“选择”SALES_SCENES_APP“,该场景资料必填。
参数名 变量 类型[长度限制] 必填 描述
服务商应用APPID app_appid string[1,256] 二选一 1、服务商应用APPID与商家应用APPID,二选一必填。
2、可填写当前服务商商户号已绑定的应用APPID。
示例值:wx1234567890123456
商家应用APPID app_sub_appid string[1,256] 1、服务商应用APPID与商家应用APPID,二选一必填。
2、可填写与商家主体一致且已认证的应用APPID,需是已认证的APP。
3、审核通过后,系统将发起特约商家商户号与该AppID的绑定(即配置为sub_appid),服务商随后可在发起支付时选择传入该appid,以完成支付,并获取sub_openid用于数据统计,营销等业务场景。
示例值:wx1234567890123456
APP截图 app_pics array[1, 1024] 1、请提供APP首页截图、尾页截图、应用内截图、支付页截图各1张。
2、请填写通过图片上传API预先上传图片生成好的MediaID。
示例值:0P3ng6KTIW4-Q_l2FjmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo
+互联网网站场景 web_info object 条件选填
  1. 1、审核通过后,服务商可帮商家发起JSAPI支付、Native支付。
  2. 2、当“经营场景类型“选择”SALES_SCENES_WEB“,该场景资料必填。
参数名 变量 类型[长度限制] 必填 描述
互联网网站域名 domain string[1,1024] 1、如为PC端商城、智能终端等场景,可上传官网链接。
2、网站域名需ICP备案,若备案主体与申请主体不同,请上传加盖公章的网站授权函。
示例值:http://www.qq.com
网站授权函 web_authorisation string[1,1024] 1、若备案主体与申请主体不同,请务必上传加盖公章的网站授权函
2、请填写通过图片上传API预先上传图片生成好的MediaID。
示例值: 47ZC6GC-vnrbEnyVBDIUv0OF4wFNIO4kqg05InE4d2I6_H7I4
互联网网站对应的商家APPID web_appid string[1,256] 1、可填写已认证的公众号、小程序、应用的APPID,其中公众号APPID需是已认证的服务 号、政府或媒体类型的订阅号;
2、完成进件后,系统发起特约商户号与该AppID的绑定(即配置为sub_appid,可在发起 支付时传入)
   (1)若APPID主体与商家主体一致,则直接完成绑定;
   (2)若APPID主体与商家主体不一致,则商户签约时显示《联合营运承诺函》,并且 AppID的管理员需登录公众平台确认绑定意愿;( 暂不支持绑定异主体的应用APPID)。
示例值:wx1234567890123456
+企业微信场景 wework_info object 条件选填
  1. 1、审核通过后,商家可自行发起企业微信支付。
  2. 2、当“经营场景类型“选择”SALES_SCENES_WEWORK“,该场景资料必填。
参数名 变量 类型[长度限制] 必填 描述
商家企业微信CorpID sub_corp_id string[1,256] 1、可填写与商家主体一致且已认证的企业微信CorpID。
2、审核通过后,系统将为商家开通企业微信专区的自有交易权限,并完成商家商户号与该APPID的绑定,商家可自行发起交易。
示例值:wx1234567890123456
企业微信页面截图 wework_pics array[1, 1024] 1、最多可上传5张照片。
2、请填写通过图片上传API预先上传图片生成好的MediaID。
示例值:0P3ng6KTIW4-Q_l2FjmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo
+结算规则 settlement_info object body 请填写商家的结算费率规则、特殊资质等信息。
参数名 变量 类型[长度限制] 必填 描述
入驻结算规则ID settlement_id string[1,3] 请选择结算规则ID,详细参见费率结算规则对照表
示例值:719
所属行业 qualification_type string[1,128] 请填写所属行业名称,详细参见费率结算规则对照表
示例值:餐饮
特殊资质图片 qualifications array [1, 1024] 条件选填 1、根据所属行业的特殊资质要求提供,详情查看费率结算规则对照表
2、请提供为“申请商家主体”所属的特殊资质,可授权使用总公司/分公司的特殊资 质;
3、最多可上传5张照片,请填写通过图片上传API预先上传图片生成好的MediaID。
示例值:0P3ng6KTIW4-Q_l2FjmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo
优惠费率活动ID activities_id string[1,32] 条件选填 选择指定活动ID,如果商户有意向报名优惠费率活动,该字段必填。详细参见优惠费率活动对照表
示例值:20191030111cff5b5e
优惠费率活动值 activities_rate string[1,50] 条件选填 根据优惠费率活动规则,若填写“优惠费率活动ID”,则该字段必填。由服务商自定义填写,支持两个小数点,需在优惠费率活动ID指定费率范围内,如0.6%(接口无需传%,只需传数字)。
示例值:0.6
优惠费率活动补充材料 activities_additions array[1, 1024] 1、根据所选优惠费率活动,提供相关材料,详细参见优惠费率活动对照表
2、最多可上传5张照片,请填写通过图片上传API预先上传图片生成好的MediaID。
示例值:0P3ng6KTIW4-Q_l2FjmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo
+结算银行账户 bank_account_info object body 请填写商家提现收款的银行账户信息。
<
参数名 变量 类型[长度限制] 必填 描述
账户类型 bank_account_type string[1,27]
  1. 1、若主体为企业/党政、机关及事业单位/其他组织,可填写:对公银行账户。
  2. 2、若主体为个体户,可选择填写:对公银行账户或经营者个人银行卡。

枚举值:

  1. BANK_ACCOUNT_TYPE_CORPORATE:对公银行账户
  2. BANK_ACCOUNT_TYPE_PERSONAL:经营者个人银行卡
示例值:BANK_ACCOUNT_TYPE_CORPORATE
开户名称 account_name string[1,2048] 1、选择“经营者个人银行卡”时,开户名称必须与“经营者证件姓名”一致。
2、选择“对公银行账户”时,开户名称必须与营业执照/登记证书的“商户名称”一致。
3、该字段需进行加密处理,加密方法详见敏感信息加密说明(提醒:必须在HTTP头中上送Wechatpay-Serial)
示例值:AOZdYGISxo4y4+kyblK2FCCqQJJp0/0eow96uY1Pk7Rq79Jtt7+I8juwEc4P4TG5xzchG/5IL9DBd+Z0zZXkw==
开户银行 account_bank string[1,128] 开户银行,详细参见开户银行对照表
注:
17家直连银行,请根据开户银行对照表直接填写银行名 ;
非17家直连银行,该参数请填写为“其他银行”。
示例值:工商银行
开户银行省市编码 bank_address_code string[1,128] 至少精确到市,详细参见省市区编号对照表
注:
仅当省市区编号对照表中无对应的省市区编号时,可向上取该银行对应市级编号或省级编号。
示例值:110000
开户银行联行号 bank_branch_id string[1,128] 二选一 1、17家直连银行无需填写,如为其他银行,则开户银行全称(含支行)和开户银行联行号二选一。
2、详细参见开户银行全称(含支行)对照表
示例值:402713354941
开户银行全称(含支行) bank_name string[1,128] 1、17家直连银行无需填写,如为其他银行,则开户银行全称(含支行)和 开户银行联行号二选一。
2、需填写银行全称,如"深圳农村商业银行XXX支行",详细参见开户银行全称(含支行)对照表
示例值:施秉县农村信用合作联社城关信用社
银行账号 account_number string[1,2048] 1、数字,长度遵循系统支持的卡号长度要求表
2、该字段需进行加密处理,加密方法详见敏感信息加密说明(提醒:必须在HTTP头中上送Wechatpay-Serial)
示例值:d+xT+MQCvrLHUVDWC1PHN4C7Rsu3WL8sPndjXTd75kPkyjqnoMRrEEaYQE8ZRGYoeorwC+w==
+补充材料 addition_info object body 根据实际审核情况,额外要求商家提供指定的补充资料。
参数名 变量 类型[长度限制] 必填 描述
法人开户承诺函 legal_person_commitment string[1,1024] 1、请上传法定代表人或负责人亲笔签署的开户承诺函扫描件(下载模板)。亲笔签名承诺函内容清晰可见,不得有涂污,破损,字迹不清晰现象。
2、请填写通过图片上传API预先上传图片生成好的MediaID。
示例值:
47ZC6GC-vnrIUv0OF4wFNIO4kqg05InE4d2I6_H7I4
法人开户意愿视频 legal_person_video string[1,1024] 1、建议法人按如下话术录制“法人开户意愿视频”:
我是#公司全称#的法定代表人(或负责人),特此证明本公司申请的商户号为我司真实意愿开立且用于XX业务(或XX服务)。我司现有业务符合法律法规及腾讯的相关规定。
2、支持上传5M内的视频,格式可为avi、wmv、mpeg、mp4、mov、mkv、flv、f4v、m4v、rmvb。
3、请填写通过视频上传API预先上传视频生成好的MediaID。
示例值:47ZC6GC-NIO4kqg05InE4d2I6_H7I4
补充材料 business_addition_pics array 1、根据驳回要求提供额外信息,如:
    (1)业务模式不清晰时,需详细描述支付场景或提供相关材料(如业务说明/门店照/ 手持证件照等);
    (2)特殊业务要求提供相关的协议材料等;
2、请填写通过图片上传API预先上传图片生成好的MediaID。
示例值:47ZC6GC-NIO4kqg05InE4d2I6_H7I4
补充说明 business_addition_msg string[1,512] 根据驳回要求提供额外信息,如:业务模式不清晰时,请详细描述支付场景。
示例值:特殊情况,说明原因

请求示例


{
  "business_code": "1900013511_10000",
  "contact_info": {
    "contact_name":"pVd1HJ6zyvPedmty7/mYNxLMpyOb+tI0pQO/0kjiwfqdfg==",
    "contact_id_number": "pVd1HJ6zyvPedzGaV+X5Kz4jBHLiCyObapQO/0kjiwfqdfg==",
    "openid": "oUpF8uMuAJO_M2pxb1Q9zNjWeS6o",
    "mobile_phone": "pVd1HJ6zyv1z0NVa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg==",
    "contact_email": "pVd1HJ6I0m+Jv1z0NVa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg=="
  },
  "subject_info": {
    "subject_type": "SUBJECT_TYPE_ENTERPRISE",
    "business_license_info": {
      "license_copy": "47ZC6GC-cuxi-v-4KGprrKhwFNIO4kqg05InE4d2I6_H7I4",
      "license_number": "123456789012345678",
      "merchant_name": "腾讯科技有限公司",
      "legal_person": "张三"
    },
    "certificate_info": {
      "cert_copy": "0P3ng6KTICz7ScmhEIThCaV-4BBJehHhAZN6BKXQPcs-VvdSo",
      "cert_type": "CERTIFICATE_TYPE_2388",
      "cert_number": "111111111111",
      "merchant_name": "xx公益团体",
      "company_address": "广东省深圳市南山区xx路xx号",
      "legal_person": "李四",
      "period_begin": "2019-08-01",
      "period_end": "2029-08-01"
    },
    "organization_info": {
      "organization_copy": "47ZC6GC-vnrbEny_Ie_An5-tCpqxwFNIO4kqg05InE4d2I6_H7I4",
      "organization_code": "123456789-A",
      "org_period_begin": "2019-08-01",
      "org_period_end": "2029-08-01"
    },
    "certificate_letter_copy": "47ZC6GC-vnrbEny_Ie_An5-DIUv0OF4wFNIO4kqg05InE4d2I6_H7I4",
    "identity_info": {
      "id_doc_type": "IDENTIFICATION_TYPE_IDCARD",
      "id_card_info": {
        "id_card_copy": "jTpGmxUX3FBWVQ5NJTZvlD8daLC-ehEuo0BJqRTvDujqhThn4ReFxikqJ5YW6zFQ",
        "id_card_national": "47ZC6GC-vnrbEny_Ie_An5-tCpqxuUv0OF4wFNIO4kqg05InE4d2I6_H7I4",
        "id_card_name": "pVd1HJ6zyvPedzGaV+X3qtmrq9bb9t/wDa4SzfeespQO/0kjiwfqdfg==",
        "id_card_number": "AOZdYGISxo4y44/UgZ69bdu9X+tq79Jtt7+I8juwEc4P4TG5xzchG/5IL9DBd+Z0zZXkw==",
        "card_period_begin": "2026-06-06",
        "card_period_end": "2026-06-06"
      },
      "id_doc_info": {
        "id_doc_copy": "jTpGmxUX3FBWVQ5NJTZvlKX_gdU4cRz7z5Nxpn0BJqRTvDujqhThn4ReFxikqJ5YW6zFQ",
        "id_doc_name": "pVd1HJ6zyvPedzGaV+X3qtmrq9bb9tPR/wDa4SzfeespQO/0kjiwfqdfg==",
        "id_doc_number": "AOZdYGISxo4y44/UgZ69bdu9X+tfMUJ94P4TG5xzchG/5IL9DBd+Z0zZXkw==",
        "doc_period_begin": "2019-06-06",
        "doc_period_end": "2026-06-06"
      },
      "owner": true
    },
    "ubo_info": {
      "id_type": "IDENTIFICATION_TYPE_IDCARD",
      "id_card_copy": "jTpGmxUX3FBWVQ5NJTZvlKX_gdU4c0BJqRTvDujqhThn4ReFxikqJ5YW6zFQ",
      "id_card_national": "jTpGmxUX3FBWVQ5NJTZvlKX_gdU4cTvDujqhThn4ReFxikqJ5YW6zFQ",
      "id_doc_copy": "jTpGmxUX3FBWVQ5NJTZvlKXhBTEO_JqRTvDujqhThn4ReFxikqJ5YW6zFQ",
      "name": "AOZdYGISxo4y44/Ug4P4TG5xzchG/5IL9DBd+Z0zZXkw==",
      "id_number": "AOZdYGISxo4y44/UgZ69bdu9X+tfMUJ9dl+Le4P4TG5xzchG/5IL9DBd+Z0zZXkw==",
      "id_period_begin": "2019-06-06",
      "id_period_end": "2026-06-06"
    }
  },
  "business_info": {
    "merchant_shortname": "张三餐饮店",
    "service_phone": "0758XXXXX",
    "sales_info": {
      "sales_scenes_type": [
        "SALES_SCENES_STORE"
      ],
      "biz_store_info": {
        "biz_store_name": "大郎烧饼",
        "biz_address_code": "440305",
        "biz_store_address": "南山区xx大厦x层xxxx室",
        "store_entrance_pic": [
          "0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCzzhJehHhAZN6BKXQPcs-VvdSo"
        ],
        "indoor_pic": [
          "0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV-4R9FwczhJehHhAZN6BKXQPcs-VvdSo"
        ],
        "biz_sub_appid": "wx1234567890123456"
      },
      "mp_info": {
        "mp_appid": "wx1234567890123456",
        "mp_sub_appid": "wx1234567890123456",
        "mp_pics": [
          "ZC6GC-vnrbEny_Ie_An5-tCpqxucuxi-vByf3Gjm7KE53JXvGy9tqZm2XAUf-4KGprrKhpVBD"
        ]
      },
      "mini_program_info": {
        "mini_program_appid": "wx1234567890123456",
        "mini_program_sub_appid": "wx1234567890123456",
        "mini_program_pics": [
          "ZC6GC-vnrbEny_Ie_An5-tCpqxucuxi-vByf3Gjm7KE53JXvGy9tqZm2XAUf-4KGprrKhpVBD"
        ]
      },
      "app_info": {
        "app_appid": "wx1234567890123456",
        "app_sub_appid": "wx1234567890123456",
        "app_pics": [
          "ZC6GC-vnrbEny_Ie_An5-tCpqxucuxi-vByf3Gjm7KE53JXvGy9tqZm2XAUf-4KGprrKhpVBD"
        ]
      },
      "web_info": {
        "domain": "http://www.qq.com",
        "web_authorisation": "47ZC6GC-vnrbEny_Ie_An5-tCpqxucBDIUv0OF4wFNIO4kqg05InE4d2I6_H7I4",
        "web_appid": "wx1234567890123456"
      },
      "wework_info": {
        "corp_id": "wx1234567890123456",
        "sub_corp_id": "wx1234567890123456",
        "wework_pics": [
          "ZC6GC-vnrbEny_Ie_An5-tCpqxucuxi-vByf3Gjm7KE53JXvGy9tqZm2XAUf-4KGprrKhpVBD"
        ]
      }
    }
  },
  "settlement_info": {
    "settlement_id": "719",
    "qualification_type": "餐饮",
    "qualifications": [
      "ZC6GC-vnrbEny_Ie_An5-tCpqxucuxi-vByf3Gjm7KE53JXvGy9tqZm2XAUf-4KGprrKhpVBD"
    ],
    "activities_id": "20191030111cff5b5e",
    "activities_rate": "0.6",
    "activities_additions": [
      "ZC6GC-vnrbEny_Ie_An5-tCpqxucuxi-vByf3Gjm7KE53JXvGy9tqZm2XAUf-4KGprrKhpVBD"
    ]
  },
  "bank_account_info": {
    "bank_account_type": "BANK_ACCOUNT_TYPE_CORPORATE",
    "account_name": "AOZdYGISxo4y44/UgZ69bdu9X+tfMUJ9dl+L79Jtt7+I8juwEc4P4TG5xzchG/5IL9DBd+Z0zZXkw==",
    "account_bank": "工商银行",
    "bank_address_code": "110000",
    "bank_branch_id": "402713354941",
    "bank_name": "施秉县农村信用合作联社城关信用社",
    "account_number":"d+xT+MQCvrLHUVDWv/8MR/dB7TkXM2hcR3WL8sPndjXTd75kPkyjqnoMRrEEaYQE8ZRGYoeorwC+w=="
  },
  "addition_info": {
    "legal_person_commitment": "47ZC6GC-vnrbEny_Ie3JXvGy9tqZm2XAUf-4KGprrKhpVBDIUv0OF4wFNIO4kqg05InE4d2I6_H7I4",
    "legal_person_video": "47ZC6GC-vnrbEny_Ie_An5-tCpqxucuxi-v4KGprrKhpVBDIUv0OF4wFNIO4kqg05InE4d2I6_H7I4",
    "business_addition_pics": [
      "ZC6GC-vnrbEny_Ie_An5-tCp3Gjm7KE53JXvGy9tqZm2XAUf-4KGprrKhpVBD",
	  "ZC6GC-vnrbEny_Ie_An5-tCp3Gjm7KE53JXvGy9tqZm2XAUf-4KGprrKhpVBD"
    ],
    "business_addition_msg": "特殊情况,说明原因"
  }
}
    
{
JAVA示例代码
}
    

返回参数

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

返回示例


> 200 Response
{
  "applyment_id": 2000002124775691
}
                                

    http://2323weixin.qq.com
                                

错误码公共错误码

状态码 错误码 描述 解决方案
500 SYSTEMERROR 系统错误 系统异常,请使用相同参数稍后重新调用
400 PARAM_ERROR 参数错误 请使用正确的参数重新调用
400 PROCESSING 存在流程进行中的申请单,请检查是否重入 可通过查询申请单状态查看此申请单的申请状态,或更换business_code提交新的申请单
403 NO_AUTH 商户权限异常 请确认是否已经开通相关权限
429 RATE_LIMITED 频率限制 请降低调用频率
400 APPLYMENT_NOTEXIST 申请单不存在 确认入参,传入正确的申请单编号
400 PARAM_ERROR 图片文件为空 商户更换文件后,重新调用
403 REQUEST_BLOCKED 未知图片类型 图片类型必须为JPG、BMP、PNG
图片meta信息不一致 请检查meta信息是否正确
签名信息不匹配 请检查签名信息



技术咨询

文档反馈