微信支付-开发者文档

返回上一层文档首页 / 特约商户进件（提交申请单）

特约商户进件（提交申请单）

最新更新时间：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字以内示例值：特殊情况，说明原因

请求示例

JSON


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

微信支付合作伙伴平台

特约商户进件（提交申请单）

注意：

接口说明

请求参数

请求示例

返回参数

返回示例

错误码公共错误码