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

特约商户进件(提交申请单)

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


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

注意:

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

2. 微信支付平台证书公钥需调用接口获取,详见获取文档

3. 调用接口获取的微信支付平台证书,证书需要解密后才能使用,详见解密说明文档

4. 本接口不支持进件个人小微商户

接口说明

适用对象:服务商

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

请求方式:POST

频率限制:15/s


path 指该参数为路径参数

query 指该参数为URL参数

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


请求参数

参数名 变量 类型[长度限制] 必填 描述
业务申请编号 business_code string[1, 124] body1、只能由数字、字母或下划线组成,建议前缀为服务商商户号;
2、服务商自定义的唯一编号;
3、每个编号对应一个申请单,每个申请单审核通过后会生成一个微信支付商户号。
示例值:1900013511_10000
+ 超级管理员信息 contact_info object body超级管理员需在开户后进行签约,并可接收日常重要管理信息和进行资金操作,请确定其为商户法定代表人或负责人。
参数名 变量 类型[长度限制] 必填 描述
超级管理员类型 contact_type string 1、主体为“个体工商户/企业/政府机关/事业单位/社会组织”,可选择:LEGAL:经营者/法人,SUPER:经办人 。(经办人:经商户授权办理微信支付业务的人员)。
枚举值:
LEGAL:经营者/法人
SUPER:经办人
示例值:LEGAL
超级管理员姓名 contact_name string 1、长度为2-100个字符
2、前后不能有空格、制表符、换行符
3、不能仅含数字、特殊字符
4、仅能填写数字、英文字母、汉字及特殊字符
该字段需进行加密处理,加密方法详见敏感信息加密说明(提醒:必须在HTTP头中上送Wechatpay-Serial)
示例值:pVd1HJ6zyvPedzGaV+X3qtmrq9bb9tPROvwia4ibL+F6mfjbzQIzfb3HHLEjZ44EL5Kz4jBHLiCyOb+tI0m2qhZ9evAM+Jv1z0NVa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg==
超级管理员证件类型 contact_id_doc_type string 条件选填 当超级管理员类型是经办人时,请上传超级管理员证件类型。
IDENTIFICATION_TYPE_IDCARD:中国大陆居民-身份证
IDENTIFICATION_TYPE_OVERSEA_PASSPORT:其他国家或地区居民-护照
IDENTIFICATION_TYPE_HONGKONG_PASSPORT:中国香港居民-来往内地通行证
IDENTIFICATION_TYPE_MACAO_PASSPORT:中国澳门居民-来往内地通行证
IDENTIFICATION_TYPE_TAIWAN_PASSPORT:中国台湾居民-来往大陆通行证
IDENTIFICATION_TYPE_FOREIGN_RESIDENT:外国人居留证
IDENTIFICATION_TYPE_HONGKONG_MACAO_RESIDENT:港澳居民证
IDENTIFICATION_TYPE_TAIWAN_RESIDENT:台湾居民证
示例值:IDENTIFICATION_TYPE_IDCARD
超级管理员身份证件号码 contact_id_number string 条件选填 1、当超级管理员类型是经办人时,请上传超级管理员证件号码
2、可传身份证、来往内地通行证、来往大陆通行证、护照等证件号码,号码规范如下:
身份证(限中国大陆居民):17位数字+1位数字|X
护照(限境外人士):4-15位 数字|字母|连字符
中国香港居民--来往内地通行证:H/h开头+8或10位数字/字母
中国澳门居民--来往内地通行证:M/m开头+8或10位数字/字母
中国台湾居民--来往大陆通行证:8位数字或10位数字
外国人居留证:15位 数字|字母
港澳居住证/台湾居住证:17位数字+1位数字|X
3、超级管理员签约时,校验微信号绑定的银行卡实名信息,是否与该证件号码一致。
4、该字段需进行加密处理,加密方法详见敏感信息加密说明(提醒:必须在HTTP头中上送Wechatpay-Serial)
示例值:pVd1HJ6zyvPedzGaV+X3qtmrq9bb9tPROvwia4ibL+F6mfjbzQIzfb3HHLEjZ4YiR/cJiCrZxnAqi+pjeKIqhZ9evAM+Jv1z0NVa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg==
超级管理员证件正面照片 contact_id_doc_copy string 条件选填 1、当超级管理员类型是经办人时,请上传超级管理员证件的正面照片。
2、若证件类型为身份证,请上传人像面照片。
3、正面拍摄、清晰、四角完整、无反光或遮挡;不得翻拍、截图、镜像、PS。
4、请上传彩色照片or彩色扫描件,复印件需加盖公章鲜章,可添加“微信支付”相关水印(如微信支付认证),见【指引文档
5、可上传1张图片,请填写通过图片上传API预先上传图片生成好的MediaID。
示例值:jTpGmxUXqRTvDujqhThn4ReFxikqJ5YW6zFQ
超级管理员证件反面照片 contact_id_doc_copy_back string 条件选填 1、当超级管理员类型是经办人时,请上传超级管理员证件的反面照片。
2、若证件类型为护照,无需上传反面照片。
3、正面拍摄、清晰、四角完整、无反光或遮挡;不得翻拍、截图、镜像、PS。
4、请上传彩色照片or彩色扫描件,复印件需加盖公章鲜章,可添加“微信支付”相关水印(如微信支付认证),见【指引文档
5、可上传1张图片,请填写通过图片上传API预先上传图片生成好的MediaID。
示例值:jTpGmxUX3FBWVQ5NJTZvvDujqhThn4ReFxikqJ5YW6zFQ
超级管理员证件有效期开始时间 contact_period_begin string 条件选填 1、当超级管理员类型是经办人时,请上传证件有效期开始时间。
2、请按照示例值填写,日期格式应满足合法的YYYY-MM-DD格式
3、开始时间不能小于1900-01-01,开始时间不能大于等于当前日期。
示例值:2019-06-06
超级管理员证件有效期结束时间 contact_period_end string 条件选填 1、当超级管理员类型是经办人时,请上传证件有效期结束时间。
2、请按照示例值填写,日期格式应满足合法的YYYY-MM-DD格式,若证件有效期为长期,请填写:长期。
3、结束时间大于开始时间。
示例值:2026-06-06
业务办理授权函 business_authorization_letter string 条件选填 1、当超级管理员类型是经办人时,请上传业务办理授权函。
2、请参照[示例图]打印业务办理授权函,全部信息需打印,不支持手写商户信息,并加盖公章。
3、可上传1张图片,请填写通过图片上传API预先上传图片生成好的MediaID。
示例值:47ZC6GC-vnrbEny_Ie_An5-tCpqxucuxi-vByf3Gjm7KEIUv0OF4wFNIO4kqg05InE4d2I6_H7I4
超级管理员微信OpenID openid string 条件选填 该字段选填,若上传为超级管理员签约时,会校验微信号是否与该微信OpenID一致
示例值:123456789
联系手机 mobile_phone string 1、前后不能有空格、制表符、换行符
2、需满足以下任一条件
- 11位数字的手机号码
- 5-20位数字、连字符“-”、加号“+”
3、用于接收微信支付的重要管理信息及日常操作验证码
4、该字段需进行加密处理,加密方法详见敏感信息加密说明(提醒:必须在HTTP头中上送Wechatpay-Serial)
示例值:pVd1HJ6zyvPedzGaV+X3qtmrq9bb9tPROvwia4ibL+F6mfjbzQIzfb369bDnuC4EL5Kz4jBHLiCyOb+tI0m2qhZ9evAM+Jv1z0NVa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg==
联系邮箱 contact_email string 1、用于接收微信支付的开户邮件及日常业务通知;
2、需要带@,遵循邮箱格式校验 ,该字段需进行加密处理,加密方法详见敏感信息加密说明(提醒:必须在HTTP头中上送Wechatpay-Serial)
示例值:pVd1HJ6zyvPedzGaV+X3qtmrq9bb9tPROvwia4ibL+F6mfjbzQIzfb3HHLEjZ4YiR/cJiCrZxnAqiOb+tI0m2qhZ9evAM+Jv1z0NVa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg==
+ 主体资料 subject_info object body请填写商家的营业执照/登记证书、经营者/法人的证件等信息
参数名 变量 类型[长度限制] 必填 描述
主体类型 subject_type string 主体类型需与营业执照/登记证书上一致,可参考选择主体指引
SUBJECT_TYPE_INDIVIDUAL(个体户):营业执照上的主体类型一般为个体户、个体工商户、个体经营;
SUBJECT_TYPE_ENTERPRISE(企业):营业执照上的主体类型一般为有限公司、有限责任公司;
SUBJECT_TYPE_GOVERNMENT (政府机关):包括各级、各类政府机关,如机关党委、税务、民政、人社、工商、商务、市监等;
SUBJECT_TYPE_INSTITUTIONS(事业单位):包括国内各类事业单位,如:医疗、教育、学校等单位;
SUBJECT_TYPE_OTHERS(社会组织): 包括社会团体、民办非企业、基金会、基层群众性自治组织、农村集体经济组织等组织。
示例值:SUBJECT_TYPE_ENTERPRISE
是否是金融机构 finance_institution boolean 条件选填 选填,请根据申请主体的实际情况填写,可参考选择金融机构指引
1、若商户主体是金融机构,则填写:true。
2、若商户主体不是金融机构,则填写:false。
若未传入将默认填写:false。
示例值:true
+ 营业执照 business_license_info object 条件选填 1、主体为个体户/企业,必填
2、请上传“营业执照”,需年检章齐全,当年注册除外
参数名 变量 类型[长度限制] 必填 描述
营业执照照片 license_copy string 1、照片应正面拍摄、清晰、四角完整、无反光或遮挡;不得翻拍、截图、镜像、PS;
2、上传彩色照片、彩色扫描件,复印件需加盖公章鲜章。
3、水印仅限于微信支付业务相关。
4、指引与示例可参考【指引文档
5、可上传1张图片,请填写通过图片上传API接口预先上传图片生成好的MediaID
示例值:47ZC6GC-vnrbEny__Ie_An5-tCpqxucuxi-vByf3Gjm7KE53JXvGy9tqZm2XAUf-4KGprrKhpVBDIUv0OF4wFNIO4kqg05InE4d2I6_H7I4
注册号/统一社会信用代码 license_number string 1、主体为“个体工商户”时,请填写营业执照上的注册号/统一社会信用代码,格式需满足以下任一条件:
-15位数字
-18位阿拉伯数字或大写英文字母(不得包含英文字母I/O/Z/S/V),并且以9开头
2、主体为“企业”时,请填写营业执照上的注册号/统一社会信用代码,格式如下:
-18位阿拉伯数字或大写英文字母(不得包含英文字母I/O/Z/S/V),并且以9开头
示例值:123456789012345678
商户名称 merchant_name string[2,128] 1、长度为2-128个字符
2、前后不能有空格、制表符、换行符
3、不能仅含数字、特殊字符
4、仅能填写数字、英文字母、汉字及特殊字符
5、仅支持utf-8格式
6、个体户证件为以下情况时,按照个体户XXX命名(XXX是营业执照经营人姓名):营业执照登记名称为空、仅含数字、仅含特殊字符、“无”、“无字号”
7、个体户不能使用“企业”“公司”或“农民专业合作社”结尾
示例值:腾讯科技有限公司
个体户经营者/法人姓名 legal_person string[2,100] 请填写营业执照的经营者/法定代表人姓名
1、长度为2-100个字符
2、前后不能有空格、制表符、换行符
3、不能仅含特殊字符
4、仅能填写数字、英文字母、汉字及特殊字符
示例值:张三
注册地址 license_address string[4,128] 条件选填 建议填写营业执照的注册地址,若该字段未填写,系统将会查询国家工商信息填入。需注意若工商信息查询不到,则会被审核驳回。
1、长度为4-128个字符
2、前后不能有空格、制表符、换行符
3、不能仅含数字、特殊字符
4、仅能填写数字、英文字母、汉字及特殊字符
5、仅支持utf-8格式
示例值:广东省深圳市南山区xx路xx号
有效期限开始日期 period_begin string 条件选填 建议填写营业执照的有效期限开始时间,若该字段未填写,系统将会查询国家工商信息填入。需注意若工商信息查询不到,则会被审核驳回。
1、日期格式应满足合法的YYYY-MM-DD格式
2、开始时间不能小于1900-01-01
3、开始时间不能大于等于当前日期
示例值:2019-08-01
有效期限结束日期 period_end string 条件选填 建议填写营业执照的有效期限结束时间,若该字段未填写,系统将会查询国家工商信息填入。需注意若工商信息查询不到,则会被审核驳回。
1、日期格式应满足合法的YYYY-MM-DD格式或长期
2、结束时间需大于开始时间
示例值:2029-08-01
+ 登记证书 certificate_info object 条件选填 主体为政府机关/事业单位/其他组织时,必填。
参数名 变量 类型[长度限制] 必填 描述
登记证书照片 cert_copy string 1、照片应正面拍摄、清晰、四角完整、无反光或遮挡;不得翻拍、截图、镜像、PS;
2、上传彩色照片、彩色扫描件,复印件需加盖公章鲜章。
3、水印仅限于微信支付业务相关。
4、指引与示例可参考【指引文档
5、请填写通过图片上传API接口预先上传图片生成好的MediaID
示例值:0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV-4BBgVwtNkCHO_XXqK5dE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo
登记证书类型 cert_type string 1、主体为“政府机关/事业单位/社会组织”时,请上传登记证书类型。
2、主体为“个体工商户/企业”时,不填。
当主体为事业单位时,选择此枚举值:
CERTIFICATE_TYPE_2388:事业单位法人证书

当主体为政府机关,选择此枚举值:
CERTIFICATE_TYPE_2389:统一社会信用代码证书

当主体为社会组织,选择以下枚举值之一:
CERTIFICATE_TYPE_2389:统一社会信用代码证书
CERTIFICATE_TYPE_2394:社会团体法人登记证书
CERTIFICATE_TYPE_2395:民办非企业单位登记证书
CERTIFICATE_TYPE_2396:基金会法人登记证书
CERTIFICATE_TYPE_2520:执业许可证/执业证
CERTIFICATE_TYPE_2521:基层群众性自治组织特别法人统一社会信用代码证
CERTIFICATE_TYPE_2522:农村集体经济组织登记证
CERTIFICATE_TYPE_2399:宗教活动场所登记证
CERTIFICATE_TYPE_2400:政府部门下发的其他有效证明文件
示例值:CERTIFICATE_TYPE_2388
证书号 cert_number string 请输入与所选证书类型相匹配且符合国家标准规范的证书号,其中除政府证明文件外,需满足18位阿拉伯数字或大写英文字母(不得包含英文字母I/O/Z/S/V)
示例值:111111111111
商户名称 merchant_name string[2,128] 请填写登记证书上的商户名称
1、长度为2-128个字符
2、前后不能有空格、制表符、换行符
3、不能仅含数字、特殊字符
4、仅能填写数字、英文字母、汉字及特殊字符
5、仅支持utf-8格式
示例值:xx公益团体
注册地址 company_address string[4,128] 请填写登记证书的注册地址
1、长度为4-128个字符
2、前后不能有空格、制表符、换行符
3、不能仅含数字、特殊字符
4、仅能填写数字、英文字母、汉字及特殊字符
5、仅支持utf-8格式
示例值:广东省深圳市南山区xx路xx号
法定代表人 legal_person string[2,100] 请填写登记证书上的法定代表人姓名
1、长度为2-100个字符
2、前后不能有空格、制表符、换行符
3、不能仅含特殊字符
4、仅能填写数字、英文字母、汉字及特殊字符
示例值:李四
有效期限开始日期 period_begin string 1、日期格式应满足合法的YYYY-MM-DD格式
2、开始时间不能小于1900-01-01
3、开始时间不能大于等于当前日期
示例值:2019-08-01
有效期限结束日期 period_end string 1、日期格式应满足合法的YYYY-MM-DD格式或长期
2、结束时间需大于开始时间
示例值:2019-08-01
单位证明函照片 certificate_letter_copy string 条件选填 1、主体类型为政府机关、事业单位选传:
(1)若上传,则审核通过后即可签约,无需汇款验证。
(2)若未上传,则审核通过后,需汇款验证。
2、主体为个体户、企业、其他组织等,不需要上传本字段。
3、请参照示例图打印单位证明函,全部信息需打印,不支持手写商户信息,并加盖公章。
4、可上传1张图片,请填写通过图片上传API预先上传图片生成好的MediaID。
示例值:47ZC6GC-vnrbEny__Ie_An5-tCpqxucuxi-vByf3Gjm7KE53JXvGy9tqZm2XAUf-4KGprrKhpVBDIUv0OF4wFNIO4kqg05InE4d2I6_H7I4
+ 金融机构许可证信息 finance_institution_info object 条件选填 当主体是金融机构时,必填。
参数名 变量 类型[长度限制] 必填 描述
金融机构类型 finance_type string 金融机构类型需与营业执照/登记证书上一致,可参考选择金融机构指引
BANK_AGENT:银行业, 适用于商业银行、政策性银行、农村合作银行、村镇银行、开发性金融机构等
PAYMENT_AGENT:支付机构, 适用于非银行类支付机构
INSURANCE:保险业, 适用于保险、保险中介、保险代理、保险经纪等保险类业务
TRADE_AND_SETTLE:交易及结算类金融机构, 适用于交易所、登记结算类机构、银行卡清算机构、资金清算中心等
OTHER:其他金融机构, 适用于财务公司、信托公司、金融资产管理公司、金融租赁公司、汽车金融公司、贷款公司、货币经纪公司、消费金融公司、证券业、金融控股公司、股票、期货、货币兑换、小额贷款公司、金融资产管理、担保公司、商业保理公司、典当行、融资租赁公司、财经咨询等其他金融业务
示例值:BANK_AGENT
金融机构许可证图片 finance_license_pics array 1、照片应正面拍摄、清晰、四角完整、无反光或遮挡;不得翻拍、截图、镜像、PS;
2、上传彩色照片、彩色扫描件,复印件需加盖公章鲜章。
3、水印仅限于微信支付业务相关。
4、根据所属金融机构类型的许可证要求提供,详情查看金融机构指引
5、请提供为“申请商家主体”所属的许可证,可授权使用总公司/分公司的特殊资质。
6、最多可上传5张照片,请填写通过图片上传API预先上传图片生成好的MediaID。
示例值:0P3ng6KTIW4-Q_l2FjmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo
+ 经营者/法人身份证件 identity_info object 1、个体户:请上传经营者的身份证件。
2、企业/社会组织:请上传法人的身份证件。
3、政府机关/事业单位:请上传法人/经办人的身份证件。
参数名 变量 类型[长度限制] 必填 描述
证件持有人类型 id_holder_type string 条件选填 1. 主体类型为政府机关、事业单位时选传:
(1)若上传的是法人证件,则不需要上传该字段
(2)若因特殊情况,无法提供法人证件时,可上传经办人。 (经办人:经商户授权办理微信支付业务的人员,授权范围包括但不限于签约,入驻过程需完成账户验证)。
2. 主体类型为企业、个体户、社会组织时,默认为经营者/法人,不需要上传该字段。
LEGAL:法人
SUPER:经办人
示例值:LEGAL
证件类型 id_doc_type string 条件选填 1、当证件持有人类型为法人时,填写。其他情况,无需上传。
2、个体户/企业/事业单位/社会组织:可选择任一证件类型,政府机关仅支持中国大陆居民-身份证类型。
IDENTIFICATION_TYPE_IDCARD:中国大陆居民-身份证
IDENTIFICATION_TYPE_OVERSEA_PASSPORT:其他国家或地区居民-护照
IDENTIFICATION_TYPE_HONGKONG_PASSPORT:中国香港居民-来往内地通行证
IDENTIFICATION_TYPE_MACAO_PASSPORT:中国澳门居民-来往内地通行证
IDENTIFICATION_TYPE_TAIWAN_PASSPORT:中国台湾居民-来往大陆通行证
IDENTIFICATION_TYPE_FOREIGN_RESIDENT:外国人居留证
IDENTIFICATION_TYPE_HONGKONG_MACAO_RESIDENT:港澳居民证
IDENTIFICATION_TYPE_TAIWAN_RESIDENT:台湾居民证
示例值:IDENTIFICATION_TYPE_IDCARD
法定代表人说明函 authorize_letter_copy string 条件选填 1、当证件持有人类型为经办人时,必须上传。其他情况,无需上传。
2、若因特殊情况,无法提供法定代表人证件时,请参照示例图打印法定代表人说明函,全部信息需打印,不支持手写商户信息,并加盖公章。
3、可上传1张图片,请填写通过图片上传APIAPI预先上传图片生成好的MediaID。
示例值:47ZC6GC-vnrbEny_Ie_An5-tCpqxucuxi-vByf3Gjm7KEIUv0OF4wFNIO4kqg05InE4d2I6_H7I4
+ 身份证信息 id_card_info object

条件选填

当证件持有人类型为经营者/法人且证件类型为“身份证”时填写。
参数名 变量 类型[长度限制] 必填 描述
身份证人像面照片 id_card_copy string 1、请上传个体户经营者/法人的身份证人像面照片
2、正面拍摄、清晰、四角完整、无反光或遮挡;不得翻拍、截图、镜像、PS。
3、请上传彩色照片or彩色扫描件,复印件需加盖公章鲜章,可添加“微信支付”相关水印(如微信支付认证),见【指引文档
4、可上传1张图片,请填写通过图片上传API接口预先上传图片生成好的MediaID
示例值:jTpGmxUX3FBWVQ5NJTZvlKX_gdU4cRz7z5NxpnFuAxhBTEO_PvWkfSCJ3zVIn001D8daLC-ehEuo0BJqRTvDujqhThn4ReFxikqJ5YW6zFQ
身份证国徽面照片 id_card_national string 1、请上传个体户经营者/法定代表人的身份证国徽面照片
2、正面拍摄、清晰、四角完整、无反光或遮挡;不得翻拍、截图、镜像、PS。
3、请上传彩色照片or彩色扫描件,复印件需加盖公章鲜章,可添加“微信支付”相关水印(如微信支付认证),见【指引文档
4、可上传1张图片,请填写通过图片上传API接口预先上传图片生成好的MediaID
示例值:47ZC6GC-vnrbEny__Ie_An5-tCpqxucuxi-vByf3Gjm7KE53JXvGy9tqZm2XAUf-4KGprrKhpVBDIUv0OF4wFNIO4kqg05InE4d2I6_H7I4
身份证姓名 id_card_name string[2,100] 1、请填写个体户经营者/法定代表人对应身份证的姓名
2、长度为2-100个字符
3、前后不能有空格、制表符、换行符
4、不能仅含数字、特殊字符
5、仅能填写数字、英文字母、汉字及特殊字符
6、该字段需进行加密处理,加密方法详见敏感信息加密说明(提醒:必须在HTTP头中上送Wechatpay-Serial)
示例值:pVd1HJ6zyvPedzGaV+X3qtmrq9bb9tPROvwia4ibL+F6mfjbzQIzfb3HHLEjZ4YiR/cv/69bDnuC4EL5Kz4jBHLiCyOb+tI0m2qhZ9evAM+Jv1z0NVa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg==
身份证号码 id_card_number string 1、请填写个体户经营者/法定代表人对应身份证的号码
2、17位数字+1位数字|X ,该字段需进行加密处理,加密方法详见敏感信息加密说明(提醒:必须在HTTP头中上送Wechatpay-Serial)
示例值:AOZdYGISxo4y44/UgZ69bdu9X+tfMUJ9dl+LetjM45/zMbrYu+wWZ8gn4CTdo+jgKsadIKHXtb3JZKGZjduGdtkRJJp0/0eow96uY1Pk7Rq79Jtt7+I8juwEc4P4TG5xzchG/5IL9DBd+Z0zZXkw==
身份证居住地址 id_card_address string[4,128] 条件选填 1、主体类型为企业时,需要填写。其他主体类型,无需上传。
2、请按照身份证住址填写,如广东省深圳市南山区xx路xx号xx室
3、长度为4-128个字符
4、前后不能有空格、制表符、换行符
5、不能仅含数字、特殊字符
6、仅能填写数字、英文字母、汉字及特殊字符
7、仅支持utf-8格式
8、 该字段需进行加密处理,加密方法详见敏感信息加密说明(提醒:必须在HTTP头中上送Wechatpay-Serial)
示例值:pVd1HJ6zyvPedzGaV+X3qtmrq9bb9tPROvwia4ibL+F6mfjbzQIzfb3HHLEjZ4YiR/cJiCrZxnAqiEL5Kz4jBHLiCyOb+tI0m2qhZ9evAM+Jv1z0NVa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg==
身份证有效期开始时间 card_period_begin string 1、日期格式应满足合法的YYYY-MM-DD格式
2、开始时间不能小于1900-01-01
3、开始时间不能大于等于当前日期
示例值:2026-06-06
身份证有效期结束时间 card_period_end string 1、日期格式应满足合法的YYYY-MM-DD格式或长期
2、结束时间需大于开始时间
示例值:2036-06-06
+ 其他类型证件信息 id_doc_info object

条件选填

当证件持有人类型为经营者/法人且证件类型不为“身份证”时填写。
参数名 变量 类型[长度限制] 必填 描述
证件正面照片 id_doc_copy string 1、证件类型不为“身份证”"时,上传证件正面照片。
2、正面拍摄、清晰、四角完整、无反光或遮挡;不得翻拍、截图、镜像、PS。
3、请上传彩色照片or彩色扫描件,复印件需加盖公章鲜章,可添加“微信支付”相关水印(如微信支付认证),见【指引文档
4、可上传1张图片,请填写通过图片上传API接口预先上传图片生成好的MediaID。
示例值:jTpGmxUX3FBWVQ5NJTZvlKX_gdU4cRz7z5NxpnFuAxhBTEO_PvWkfSCJ3zVIn001D8daLC-ehEuo0BJqRTvDujqhThn4ReFxikqJ5YW6zFQ
证件反面照片 id_doc_copy_back string 条件选填 1、若证件类型为往来通行证、外国人居留证、港澳居住证、台湾居住证时,上传证件反面照片。
2、若证件类型为护照,无需上传反面照片
3、正面拍摄、清晰、四角完整、无反光或遮挡;不得翻拍、截图、镜像、PS
4、请上传彩色照片or彩色扫描件,复印件需加盖公章鲜章,可添加“微信支付”相关水印(如微信支付认证),见【指引文档
5、可上传1张图片,请填写通过图片上传API接口预先上传图片生成好的MediaID。
示例值:jTpGmxUX3FBWVQ5NJTZvvDujqhThn4ReFxikqJ5YW6zFQ
证件姓名 id_doc_name string[2,100] 1、请填写经营者/法定代表人的证件姓名
2、长度为2-100个字符
3、前后不能有空格、制表符、换行符
4、不能仅含数字、特殊字符
5、仅能填写数字、英文字母、汉字及特殊字符
6、该字段需进行加密处理,加密方法详见敏感信息加密说明(提醒:必须在HTTP头中上送Wechatpay-Serial)
示例值:pVd1HJ6zyvPedzGaV+X3qtmrq9bb9tPROvwia4ibL+F6mfjbzQIzfb3HHLEjZ4YiR/cJiCrZxnAqi+pjeKz4jBHLiCyOb+tI0m2qhZ9evAM+Jv1z0NVa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg==
证件号码 id_doc_number string 1、请填写经营者/法定代表人的证件号码
护照(限境外人士):4-15位 数字|字母|连字符
中国香港居民--来往内地通行证:H/h开头+8或10位数字/字母
中国澳门居民--来往内地通行证:M/m开头+8或10位数字/字母
中国台湾居民--来往大陆通行证:8位数字或10位数字
外国人居留证:15位 数字|字母
港澳居住证/台湾居住证:17位数字+1位数字|X
2、该字段需进行加密处理,加密方法详见敏感信息加密说明(提醒:必须在HTTP头中上送Wechatpay-Serial)
示例值:AOZdYGISxo4y44/UgZ69bdu9X+tfMUJ9dl+LetjM45/zMbrYu+wWZ8gn4CTdo+D/m9MrPg+V4smJZKGZjduGdtkRJJp0/0eow96uY1Pk7Rq79Jtt7+I8juwEc4P4TG5xzchG/5IL9DBd+Z0zZXkw==
证件居住地址 id_doc_address string[4,128] 条件选填 1、主体类型为企业时,需要填写。其他主体类型,无需上传。
2、请按照身份证住址填写,如广东省深圳市南山区xx路xx号xx室
3、长度为4-128个字符
4、前后不能有空格、制表符、换行符
5、不能仅含数字、特殊字符
6、仅能填写数字、英文字母、汉字及特殊字符
7、仅支持utf-8格式
8、 该字段需进行加密处理,加密方法详见敏感信息加密说明(提醒:必须在HTTP头中上送Wechatpay-Serial)
示例值:pVd1HJ6zyvPedzGaV+X3qtmrq9bb9tPROvwia4ibL+F6mfjbzQIzfb3HHLEjZ4YiR/cJiCrZxnAqi+pjeKIEdkwzXRAI7FUhrf2qhZ9evAM+Jv1z0NVa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg==
证件有效期开始时间 doc_period_begin string 1、日期格式应满足合法的YYYY-MM-DD格式
2、开始时间不能小于1900-01-01
3、开始时间不能大于等于当前日期
示例值:2019-06-06
证件有效期结束时间 doc_period_end string 1、日期格式应满足合法的YYYY-MM-DD格式或长期
2、结束时间需大于开始时间
示例值:2026-06-06
经营者/法人是否为受益人 owner boolean

条件选填

主体类型为企业时,需要填写:
1、若经营者/法人是最终受益人,则填写:true。
2、若经营者/法人不是最终受益人,则填写:false。
示例值:true
+ 最终受益人信息列表(UBO) ubo_info_list array 条件选填 仅企业需要填写。
若经营者/法人不是最终受益所有人,则需补充受益所有人信息,最多上传4个。
若经营者/法人是最终受益所有人之一,可在此添加其他受益所有人信息,最多上传3个。
根据国家相关法律法规,需要提供公司受益所有人信息,受益所有人需符合至少以下条件之一:
1、直接或者间接拥有超过25%公司股权或者表决权的自然人。
2、通过人事、财务等其他方式对公司进行控制的自然人。
3、公司的高级管理人员,包括公司的经理、副经理、财务负责人、上市公司董事会秘书和公司章程规定的其他人员。
参数名 变量 类型[长度限制] 必填 描述
证件类型 ubo_id_doc_type string 请填写受益人的证件类型。枚举值:
IDENTIFICATION_TYPE_IDCARD:中国大陆居民-身份证
IDENTIFICATION_TYPE_OVERSEA_PASSPORT:其他国家或地区居民-护照
IDENTIFICATION_TYPE_HONGKONG_PASSPORT:中国香港居民-来往内地通行证
IDENTIFICATION_TYPE_MACAO_PASSPORT:中国澳门居民-来往内地通行证
IDENTIFICATION_TYPE_TAIWAN_PASSPORT:中国台湾居民-来往大陆通行证
IDENTIFICATION_TYPE_FOREIGN_RESIDENT:外国人居留证
IDENTIFICATION_TYPE_HONGKONG_MACAO_RESIDENT:港澳居民证
IDENTIFICATION_TYPE_TAIWAN_RESIDENT:台湾居民证
示例值:IDENTIFICATION_TYPE_IDCARD
证件正面照片 ubo_id_doc_copy string 1、请上传受益人证件的正面照片。
2、若证件类型为身份证,请上传人像面照片。
3、正面拍摄、清晰、四角完整、无反光或遮挡;不得翻拍、截图、镜像、PS
4、请上传彩色照片or彩色扫描件,复印件需加盖公章鲜章,可添加“微信支付”相关水印(如微信支付认证),见【指引文档
5、可上传1张图片,请填写通过图片上传API接口预先上传图片生成好的MediaID。
示例值:jTpGmxUXqRTvDujqhThn4ReFxikqJ5YW6zFQ
证件反面照片 ubo_id_doc_copy_back string 条件选填 1、请上传受益人证件的反面照片。
2、若证件类型为身份证,请上传国徽面照片。
3、若证件类型为护照,无需上传反面照片。
4、正面拍摄、清晰、四角完整、无反光或遮挡;不得翻拍、截图、镜像、PS
5、请上传彩色照片or彩色扫描件,复印件需加盖公章鲜章,可添加“微信支付”相关水印(如微信支付认证),见【指引文档
6、可上传1张图片,请填写通过图片上传API接口预先上传图片生成好的MediaID。
示例值:jTpGmxUX3FBWVQ5NJTZvvDujqhThn4ReFxikqJ5YW6zFQ
证件姓名 ubo_id_doc_name string 1、长度为2-100个字符
2、前后不能有空格、制表符、换行符
3、不能仅含数字、特殊字符
4、仅能填写数字、英文字母、汉字及特殊字符
5、该字段需进行加密处理,加密方法详见敏感信息加密说明(提醒:必须在HTTP头中上送Wechatpay-Serial)
示例值:AOZdYGISxo4y44/Ug4P4TG5xzchG/5IL9DBd+Z0zZXkw==
证件号码 ubo_id_doc_number string 1、可传身份证、来往内地通行证、来往大陆通行证、护照等证件号码,号码规范如下:
身份证(限中国大陆居民):17位数字+1位数字|X
护照(限境外人士):4-15位 数字|字母|连字符
中国香港居民--来往内地通行证:H/h开头+8或10位数字/字母
中国澳门居民--来往内地通行证:M/m开头+8或10位数字/字母
中国台湾居民--来往大陆通行证:8位数字或10位数字
外国人居留证:15位 数字|字母
港澳居住证/台湾居住证:17位数字+1位数字|X
2、该字段需进行加密处理,加密方法详见敏感信息加密说明(提醒:必须在HTTP头中上送Wechatpay-Serial)
示例值:AOZdYGISxo4y44/Ug4P4TG5xzchG/5IL9DBd+Z0zZXkw==
证件居住地址 ubo_id_doc_address string[4,128] 1、请按照身份证住址填写,如广东省深圳市南山区xx路xx号xx室
2、长度为4-128个字符
3、前后不能有空格、制表符、换行符
4、不能仅含数字、特殊字符
5、仅能填写数字、英文字母、汉字及特殊字符
6、仅支持utf-8格式
7、 该字段需进行加密处理,加密方法详见敏感信息加密说明(提醒:必须在HTTP头中上送Wechatpay-Serial)
示例值:pVd1HJ6zyvPedzGaV+X3qtmrq9bb9tPROvwia4ibL+F6mfevAM+Jv1z0NVa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg==
证件有效期开始时间 ubo_period_begin string 1、日期格式应满足合法的YYYY-MM-DD格式
2、开始时间不能小于1900-01-01
3、开始时间不能大于等于当前日期
示例值:2019-06-06
证件有效期结束时间 ubo_period_end string 1、日期格式应满足合法的YYYY-MM-DD格式或长期
2、结束时间需大于开始时间
示例值:2026-06-06
+ 经营资料 business_info object body请填写商家的经营业务信息、售卖商品/提供服务场景信息
参数名 变量 类型[长度限制] 必填 描述
商户简称 merchant_shortname string[1, 64] 在支付完成页向买家展示,需与微信经营类目相关
1、请输入1-64个字符
2、前后不能有空格、制表符、换行符
3、不能仅含特殊字符
4、仅能填写数字、英文字母、汉字及特殊字符
5、仅支持utf-8格式
6、简称要求
    (1)不支持单纯以人名来命名,若为个体户经营,可用“个体户+经营者名称”或“经营者名称+业务”命名,如“个体户张三”或“张三餐饮店”;
    (2)不支持无实际意义的文案,如“XX特约商户”、“800”、“XX客服电话XXX”;
示例值:张三餐饮店
客服电话 service_phone string 将在交易记录中向买家展示,请确保电话畅通以便平台回拨确认
1、前后不能有空格、制表符、换行符
2、需满足以下任一条件
- 11位数字的手机号码
- 5-20位数字、连字符“-”、加号“+”
示例值:0758XXXXX
+ 经营场景 sales_info object 请根据实际经营情况,填写经营场景
参数名 变量 类型[长度限制] 必填 描述
经营场景类型 sales_scenes_type array 1、请勾选实际售卖商品/提供服务场景(至少一项),以便为你开通需要的支付权限。
2、建议只勾选目前必须的场景,以便尽快通过入驻审核,其他支付权限可在入驻后再根据实际需要发起申请。
SALES_SCENES_STORE:线下场所
SALES_SCENES_MP:公众号
SALES_SCENES_MINI_PROGRAM:小程序
SALES_SCENES_WEB:互联网网站
SALES_SCENES_APP:APP
SALES_SCENES_WEWORK:企业微信
示例值:SALES_SCENES_STORE
+ 线下场所场景 biz_store_info object 条件选填 1、审核通过后,服务商可帮商户发起付款码支付、JSAPI支付。
2、当"经营场景类型"选择"SALES_SCENES_STORE",该场景资料必填。
参数名 变量 类型[长度限制] 必填 描述
线下场所名称 biz_store_name string[1, 50] 请填写门店名称
1、长度为1-50个字符
2、前后不能有空格、制表符、换行符
3、不能仅含数字、特殊字符
4、仅能填写数字、英文字母、汉字及特殊字符
5、仅支持utf-8格式
示例值:大郎烧饼
线下场所省市编码 biz_address_code string[1, 128] 1、只能由数字组成
2、详细参见微信支付提供的省市对照表
示例值:440305
线下场所地址 biz_store_address string[4, 512] 请填写详细的经营场所信息,如有多个场所,选择一个主要场所填写即可。
1、长度为4-512个字符
2、前后不能有空格、制表符、换行符
3、不能仅含数字、特殊字符
4、仅能填写数字、英文字母、汉字及特殊字符
5、仅支持utf-8格式
示例值:南山区xx大厦x层xxxx室
线下场所门头照片 store_entrance_pic array 1、请上传门头正面照片(要求门店招牌、门框完整、清晰、可辨识);若为停车场等无固定门头照片的经营场所,可上传岗亭/出入闸口。具体参考【指引文档
2、请填写通过图片上传API接口预先上传图片生成好的MediaID。
示例值:0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV-4BBgVwtNkCHO_XXqK5dE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo
线下场所内部照片 indoor_pic array 1、请上传门店内部环境照片(可辨识经营内容)。若为停车场等无固定门头的经营场所,可上传停车场内部照片。具体参考【指引文档
2、请填写通过图片上传API接口预先上传图片生成好的MediaID。
示例值:0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV-4BBgVwtNkCHO_XXqK5dE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo
线下场所对应的商家AppID biz_sub_appid string[1, 256] 1、可填写与商家主体一致且已认证的公众号、小程序、APP的AppID,其中公众号AppID需是已认证的服务号、政府或媒体类型的订阅号;
2、审核通过后,系统将额外为商家开通付款码支付、JSAPI支付的自有交易权限,并完成商家商户号与该AppID的绑定;
示例值:wx1234567890123456
+ 公众号场景 mp_info object 条件选填 1、审核通过后,服务商可帮商家发起JSAPI支付
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、审核通过后,服务商可帮商家发起JSAPI支付
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、审核通过后,服务商可帮商家发起App支付
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、审核通过后,服务商可帮商家发起JSAPI支付、Native支付
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、审核通过后,服务商可帮商家发起企业微信支付
2、当"经营场景类型"选择"SALES_SCENES_WEWORK",该场景资料必填。
参数名 变量 类型[长度限制] 必填 描述
商家企业微信CorpID sub_corp_id string[1,256] 1、可填写与商家主体一致且已认证的企业微信CorpID。
2、审核通过后,系统将为商家开通企业微信专区的自有交易权限,并完成商家商户号与该APPID的绑定,商家可自行发起交易。
示例值:wx1234567890123456
企业微信页面截图 wework_pics array 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、仅当商户选择了必需提交特殊资质的行业时,需要提供该项资料;若商户选择了无需特殊资质的行业,或未选择行业时,无需提交该项资料,详情查看《费率结算规则对照表》
2、最多可上传5张照片,请填写通过图片上传API接口预先上传图片生成好的MediaID
示例值:0P3ng6KTIW4-Q_l2FjmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo
优惠费率活动ID activities_id string[1,32] 条件选填 选择指定活动ID,如果商户有意向报名优惠费率活动,该字段必填。详细参见优惠费率活动对照表
示例值:20191030111cff5b5e
优惠费率活动值 activities_rate string 条件选填 根据优惠费率活动规则,由合作伙伴自定义填写,支持两个小数点,需在优惠费率活动ID指定费率范围内
(1)2023年7月17日-9月17日,各合作伙伴平台可选择只传入“活动费率值”,或分别传入“信用卡优惠活动费率值” 与 “非信用卡优惠活动费率值”,只传入“活动费率值”的情况下,平台将协助将申请单中的 “优惠活动费率值” 回填入新增的 “信用卡优惠活动费率值” 与 “非信用卡优惠活动费率值”中 。
(2)2023年9月18日起,平台将不再提供如上兼容能力,届时仅能分别传入“信用卡优惠活动费率值” 与 “非信用卡优惠活动费率值”,否则接口将会报错。为避免影响正常进件,请在兼容期间完成相关调整。
示例值:0.6
非信用卡活动费率值 debit_activities_rate string 条件选填 用户支付方式为借记卡时收取的手续费费率:
1、若填写了优惠费率活动ID,则该字段必填
2、仅能填入2位以内小数,且在优惠费率活动ID指定费率范围内
示例值:0.6
信用卡活动费率值 credit_activities_rate string 条件选填 用户支付方式为信用卡时收取的手续费费率:
1、若填写了优惠费率活动ID,则该字段必填
2、仅能填入2位以内小数,且在优惠费率活动ID指定费率范围内
示例值:0.6
优惠费率活动补充材料 activities_additions array 1、根据所选优惠费率活动,提供相关材料,详细参见优惠费率活动对照表
2、最多可上传5张照片,请填写通过图片上传API接口预先上传图片生成好的MediaID
示例值:0P3ng6KTIW4-Q_l2FjmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo
+ 结算银行账户 bank_account_info object body请填写商家提现收款的银行账户信息
参数名 变量 类型[长度限制] 必填 描述
账户类型 bank_account_type string 1、若主体为企业/政府机关/事业单位/社会组织,可填写:对公银行账户。
2、若主体为个体户,可选择填写:对公银行账户或经营者个人银行卡。
BANK_ACCOUNT_TYPE_CORPORATE:对公银行账户
BANK_ACCOUNT_TYPE_PERSONAL:经营者个人银行卡
示例值:BANK_ACCOUNT_TYPE_CORPORATE
开户名称 account_name string[1, 2048] 1、选择“经营者个人银行卡”时,开户名称必须与“经营者证件姓名”一致,
2、选择“对公银行账户”时,开户名称必须与营业执照上的“商户名称”一致
3、该字段需进行加密处理,加密方法详见敏感信息加密说明(提醒:必须在HTTP头中上送Wechatpay-Serial)
示例值:AOZdYGISxo4y44/UgZ69bdu9X+tfMUJ9dl+LetjM45/zMbrYu+wWZ8gn4CTdo+D/m9MrPg+V4sm73oxqdQu/hj7aWyDl4GQtPXVdaztB9jVbVZh3QFzV+BEmytMNQp9dt1uWJktlfdDdLR3AMWyMB377xd+m9bSr/ioDTzagEcGe+vLYiKrzcroQv3OR0p3ppFYoQ3IfYeU/04S4t9rNFL+kyblK2FCCqQ11NdbbHoCrJc7NV4oASq6ZFonjTtgjjgKsadIKHXtb3JZKGZjduGdtkRJJp0/0eow96uY1Pk7Rq79Jtt7+I8juwEc4P4TG5xzchG/5IL9DBd+Z0zZXkw==
开户银行 account_bank string[1,128] 开户银行,传参规则如下:
1、17家直连银行,请根据开户银行对照表直接填写银行名 ;
2、非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-vnrbEny__Ie_An5-tCpqxucuxi-vByf3Gjm7KE53JXvGy9tqZm2XAUf-4KGprrKhpVBDIUv0OF4wFNIO4kqg05InE4d2I6_H7I4
补充材料 business_addition_pics array 1、最多可上传5张照片
2、请填写通过图片上传API预先上传图片生成好的MediaID。
示例值:47ZC6GC-NIO4kqg05InE4d2I6_H7I4
补充说明 business_addition_msg string[1,512] 512字以内
示例值:特殊情况,说明原因

请求示例


{
	"business_code": "1900013511_10000",
	"contact_info": {
		"business_authorization_letter": "47ZC6GC-vnrbEny_Ie_An5-tCpqxucuxi-vByf3Gjm7KEIUv0OF4wFNIO4kqg05InE4d2I6_H7I4",
		"contact_email": "pVd1HJ6zyvPedzGaV+X3qtmrq9bb9tPROvwia4ibL+F6mfjbzQIzfb3HHLEjZ4YiR/cJiCrZxnAqi+pjeKIEdkwzXRAI7FUhrfPK3SNjaBTEu9GmsugMIA9r3x887Q+ODuC8HH2nzAn7NGpE/e3yiHgWhk0ps5k5DP/2qIdGdONoDzZelrxCl/NWWNUyB93K9F+jC1JX2IMttdY+aQ6zBlw0xnOiNW6Hzy7UtC+xriudjD5APomty7/mYNxLMpRSvWKIjOv/69bDnuC4EL5Kz4jBHLiCyOb+tI0m2qhZ9evAM+Jv1z0NVa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg==",
		"contact_id_doc_copy": "jTpGmxUXqRTvDujqhThn4ReFxikqJ5YW6zFQ",
		"contact_id_doc_copy_back": "jTpGmxUX3FBWVQ5NJTZvvDujqhThn4ReFxikqJ5YW6zFQ",
		"contact_id_doc_type": "IDENTIFICATION_TYPE_IDCARD",
		"contact_id_number": "pVd1HJ6zyvPedzGaV+X3qtmrq9bb9tPROvwia4ibL+F6mfjbzQIzfb3HHLEjZ4YiR/cJiCrZxnAqi+pjeKIEdkwzXRAI7FUhrfPK3SNjaBTEu9GmsugMIA9r3x887Q+ODuC8HH2nzAn7NGpE/e3yiHgWhk0ps5k5DP/2qIdGdONoDzZelrxCl/NWWNUyB93K9F+jC1JX2IMttdY+aQ6zBlw0xnOiNW6Hzy7UtC+xriudjD5APomty7/mYNxLMpRSvWKIjOv/69bDnuC4EL5Kz4jBHLiCyOb+tI0m2qhZ9evAM+Jv1z0NVa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg==",
		"contact_name": "pVd1HJ6zyvPedzGaV+X3qtmrq9bb9tPROvwia4ibL+F6mfjbzQIzfb3HHLEjZ4YiR/cJiCrZxnAqi+pjeKIEdkwzXRAI7FUhrfPK3SNjaBTEu9GmsugMIA9r3x887Q+ODuC8HH2nzAn7NGpE/e3yiHgWhk0ps5k5DP/2qIdGdONoDzZelrxCl/NWWNUyB93K9F+jC1JX2IMttdY+aQ6zBlw0xnOiNW6Hzy7UtC+xriudjD5APomty7/mYNxLMpRSvWKIjOv/69bDnuC4EL5Kz4jBHLiCyOb+tI0m2qhZ9evAM+Jv1z0NVa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg==",
		"contact_period_begin": "2019-06-06",
		"contact_period_end": "2026-06-06",
		"contact_type": "LEGAL",
		"mobile_phone": "pVd1HJ6zyvPedzGaV+X3qtmrq9bb9tPROvwia4ibL+F6mfjbzQIzfb3HHLEjZ4YiR/cJiCrZxnAqi+pjeKIEdkwzXRAI7FUhrfPK3SNjaBTEu9GmsugMIA9r3x887Q+ODuC8HH2nzAn7NGpE/e3yiHgWhk0ps5k5DP/2qIdGdONoDzZelrxCl/NWWNUyB93K9F+jC1JX2IMttdY+aQ6zBlw0xnOiNW6Hzy7UtC+xriudjD5APomty7/mYNxLMpRSvWKIjOv/69bDnuC4EL5Kz4jBHLiCyOb+tI0m2qhZ9evAM+Jv1z0NVa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg==",
		"openid": 123456789
	},
	"subject_info": {
		"subject_type": "SUBJECT_TYPE_ENTERPRISE",
		"finance_institution": true,
		"business_license_info": {
			"legal_person": "张三",
			"license_address": "广东省深圳市南山区xx路xx号",
			"license_copy": "47ZC6GC-vnrbEny__Ie_An5-tCpqxucuxi-vByf3Gjm7KE53JXvGy9tqZm2XAUf-4KGprrKhpVBDIUv0OF4wFNIO4kqg05InE4d2I6_H7I4",
			"license_number": "123456789012345678",
			"merchant_name": "腾讯科技有限公司",
			"period_begin": "2019-08-01",
			"period_end": "2029-08-01"
		},
		"certificate_letter_copy": "47ZC6GC-vnrbEny__Ie_An5-tCpqxucuxi-vByf3Gjm7KE53JXvGy9tqZm2XAUf-4KGprrKhpVBDIUv0OF4wFNIO4kqg05InE4d2I6_H7I4",
		"finance_institution_info": {
			"finance_license_pics": ["0P3ng6KTIW4-Q_l2FjmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo"],
			"finance_type": "BANK_AGENT"
		},
		"identity_info": {
			"authorize_letter_copy": "47ZC6GC-vnrbEny_Ie_An5-tCpqxucuxi-vByf3Gjm7KEIUv0OF4wFNIO4kqg05InE4d2I6_H7I4",
			"id_card_info": {
				"card_period_begin": "2026-06-06",
				"card_period_end": "2026-06-06",
				"id_card_address": "pVd1HJ6zyvPedzGaV+X3qtmrq9bb9tPROvwia4ibL+F6mfjbzQIzfb3HHLEjZ4YiR/cJiCrZxnAqi+pjeKIEdkwzXRAI7FUhrfPK3SNjaBTEu9GmsugMIA9r3x887Q+ODuC8HH2nzAn7NGpE/e3yiHgWhk0ps5k5DP/2qIdGdONoDzZelrxCl/NWWNUyB93K9F+jC1JX2IMttdY+aQ6zBlw0xnOiNW6Hzy7UtC+xriudjD5APomty7/mYNxLMpRSvWKIjOv/69bDnuC4EL5Kz4jBHLiCyOb+tI0m2qhZ9evAM+Jv1z0NVa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg==",
				"id_card_copy": "jTpGmxUX3FBWVQ5NJTZvlKX_gdU4cRz7z5NxpnFuAxhBTEO_PvWkfSCJ3zVIn001D8daLC-ehEuo0BJqRTvDujqhThn4ReFxikqJ5YW6zFQ",
				"id_card_name": "pVd1HJ6zyvPedzGaV+X3qtmrq9bb9tPROvwia4ibL+F6mfjbzQIzfb3HHLEjZ4YiR/cJiCrZxnAqi+pjeKIEdkwzXRAI7FUhrfPK3SNjaBTEu9GmsugMIA9r3x887Q+ODuC8HH2nzAn7NGpE/e3yiHgWhk0ps5k5DP/2qIdGdONoDzZelrxCl/NWWNUyB93K9F+jC1JX2IMttdY+aQ6zBlw0xnOiNW6Hzy7UtC+xriudjD5APomty7/mYNxLMpRSvWKIjOv/69bDnuC4EL5Kz4jBHLiCyOb+tI0m2qhZ9evAM+Jv1z0NVa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg==",
				"id_card_national": "47ZC6GC-vnrbEny__Ie_An5-tCpqxucuxi-vByf3Gjm7KE53JXvGy9tqZm2XAUf-4KGprrKhpVBDIUv0OF4wFNIO4kqg05InE4d2I6_H7I4",
				"id_card_number": "AOZdYGISxo4y44/UgZ69bdu9X+tfMUJ9dl+LetjM45/zMbrYu+wWZ8gn4CTdo+D/m9MrPg+V4sm73oxqdQu/hj7aWyDl4GQtPXVdaztB9jVbVZh3QFzV+BEmytMNQp9dt1uWJktlfdDdLR3AMWyMB377xd+m9bSr/ioDTzagEcGe+vLYiKrzcroQv3OR0p3ppFYoQ3IfYeU/04S4t9rNFL+kyblK2FCCqQ11NdbbHoCrJc7NV4oASq6ZFonjTtgjjgKsadIKHXtb3JZKGZjduGdtkRJJp0/0eow96uY1Pk7Rq79Jtt7+I8juwEc4P4TG5xzchG/5IL9DBd+Z0zZXkw=="
			},
			"id_doc_type": "IDENTIFICATION_TYPE_IDCARD",
			"id_holder_type": "LEGAL",
			"owner": true
		},
		"ubo_info_list": [{
			"ubo_id_doc_address": "pVd1HJ6zyvPedzGaV+X3qtmrq9bb9tPROvwia4ibL+F6mfjbzQIzfb3HHLEjZ4YiR/cJiCrZxnAqi+pjeKIEdkwzXRAI7FUhrfPK3SNjaBTEu9GmsugMIA9r3x887Q+ODuC8HH2nzAn7NGpE/e3yiHgWhk0ps5k5DP/2qIdGdONoDzZelrxCl/NWWNUyB93K9F+jC1JX2IMttdY+aQ6zBlw0xnOiNW6Hzy7UtC+xriudjD5APomty7/mYNxLMpRSvWKIjOv/69bDnuC4EL5Kz4jBHLiCyOb+tI0m2qhZ9evAM+Jv1z0NVa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg==",
			"ubo_id_doc_copy": "jTpGmxUXqRTvDujqhThn4ReFxikqJ5YW6zFQ",
			"ubo_id_doc_copy_back": "jTpGmxUX3FBWVQ5NJTZvvDujqhThn4ReFxikqJ5YW6zFQ",
			"ubo_id_doc_name": "AOZdYGISxo4y44/Ug4P4TG5xzchG/5IL9DBd+Z0zZXkw==",
			"ubo_id_doc_number": "AOZdYGISxo4y44/Ug4P4TG5xzchG/5IL9DBd+Z0zZXkw==",
			"ubo_id_doc_type": "IDENTIFICATION_TYPE_IDCARD",
			"ubo_period_begin": "2019-06-06",
			"ubo_period_end": "2026-06-06"
		}]
	},
	"business_info": {
		"merchant_shortname": "张三餐饮店",
		"sales_info": {
			"app_info": {
				"app_appid": "wx1234567890123456",
				"app_pics": ["0P3ng6KTIW4-Q_l2FjmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo"]
			},
			"biz_store_info": {
				"biz_address_code": "440305",
				"biz_store_address": "南山区xx大厦x层xxxx室",
				"biz_store_name": "大郎烧饼",
				"biz_sub_appid": "wx1234567890123456",
				"indoor_pic": ["0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV-4BBgVwtNkCHO_XXqK5dE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo"],
				"store_entrance_pic": ["0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV-4BBgVwtNkCHO_XXqK5dE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo"]
			},
			"mini_program_info": {
				"mini_program_appid": "wx1234567890123456",
				"mini_program_pics": ["0P3ng6KTIW4-Q_l2FjmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo"]
			},
			"mp_info": {
				"mp_appid": "wx1234567890123456",
				"mp_pics": ["0P3ng6KTIW4-Q_l2FjmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo"]
			},
			"sales_scenes_type": [
				"SALES_SCENES_STORE",
				"SALES_SCENES_MP",
				"SALES_SCENES_MINI_PROGRAM",
				"SALES_SCENES_WEB",
				"SALES_SCENES_APP",
				"SALES_SCENES_WEWORK"
			],
			"web_info": {
				"domain": "http://www.qq.com",
				"web_appid": "wx1234567890123456",
				"web_authorisation": "47ZC6GC-vnrbEny__Ie_An5-tCpqxucuxi-vByf3Gjm7KE53JXvGy9tqZm2XAUf-4KGprrKhpVBDIUv0OF4wFNIO4kqg05InE4d2I6_H7I4"
			},
			"wework_info": {
				"corp_id": "wx1234567890123456",
				"sub_corp_id": "wx1234567890123456",
				"wework_pics": ["0P3ng6KTIW4-Q_l2FjmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo"]
			}
		},
		"service_phone": "0758XXXXX"
	},
	"settlement_info": {
		"activities_additions": ["0P3ng6KTIW4-Q_l2FjmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo"],
		"activities_id": "20191030111cff5b5e",
		"activities_rate": "0.6",
		"debit_activities_rate ": "0.6",
		"credit_activities_rate ": "0.6",
		"qualification_type": "餐饮",
		"qualifications": "0P3ng6KTIW4-Q_l2FjmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo",
		"settlement_id": "719"
	},
	"bank_account_info": {
		"account_bank": "工商银行",
		"account_name": "AOZdYGISxo4y44/UgZ69bdu9X+tfMUJ9dl+LetjM45/zMbrYu+wWZ8gn4CTdo+D/m9MrPg+V4sm73oxqdQu/hj7aWyDl4GQtPXVdaztB9jVbVZh3QFzV+BEmytMNQp9dt1uWJktlfdDdLR3AMWyMB377xd+m9bSr/ioDTzagEcGe+vLYiKrzcroQv3OR0p3ppFYoQ3IfYeU/04S4t9rNFL+kyblK2FCCqQ11NdbbHoCrJc7NV4oASq6ZFonjTtgjjgKsadIKHXtb3JZKGZjduGdtkRJJp0/0eow96uY1Pk7Rq79Jtt7+I8juwEc4P4TG5xzchG/5IL9DBd+Z0zZXkw==",
		"account_number": "d+xT+MQCvrLHUVDWv/8MR/dB7TkXM2YYZlokmXzFsWs35NXUot7C0NcxIrUF5FnxqCJHkNgKtxa6RxEYyba1+VBRLnqKG2fSy/Y5qDN08Ej9zHCwJjq52Wg1VG8MRugli9YMI1fI83KGBxhuXyemgS/hqFKsfYGiOkJqjTUpgY5VqjtL2N4l4z11T0ECB/aSyVXUysOFGLVfSrUxMPZy6jWWYGvT1+4P633f+R+ki1gT4WF/2KxZOYmli385ZgVhcR30mr4/G3HBcxi13zp7FnEeOsLlvBmI1PHN4C7Rsu3WL8sPndjXTd75kPkyjqnoMRrEEaYQE8ZRGYoeorwC+w==",
		"bank_account_type": "BANK_ACCOUNT_TYPE_CORPORATE",
		"bank_address_code": "110000",
		"bank_branch_id": "402713354941"
	}
}

{
JAVA示例代码
}

返回参数

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

返回示例


{
  "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信息是否正确
签名信息不匹配 请检查签名信息



技术咨询

文档反馈