微信支付-开发者文档

返回上一层文档首页 / 提交申请单

提交申请单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、服务商自定义的唯一编号。
2、每个编号对应一个申请单，每个申请单审核通过后会生成一个微信支付商户号。
3、若申请单被驳回，可填写相同的“业务申请编号”，即可覆盖修改原申请单信息。

示例值：APPLYMENT_00000000001

+超级管理员信息

contact_info

object

是

body 特约商户的超级管理员，超级管理员需在开户后进行签约，并接收日常重要管理信息和进行资金操作，请确定其为商户法定代表人或负责人。

参数名	变量	类型[长度限制]	必填	描述
超级管理员姓名	contact_name	string[2,2048]	是	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]

是

个体户/企业/党政、机关及事业单位/其他组织：可选择任一证件类型。

枚举值：

IDENTIFICATION_TYPE_IDCARD：中国大陆居民-身份证
IDENTIFICATION_TYPE_OVERSEA_PASSPORT：其他国家或地区居民-护照
IDENTIFICATION_TYPE_HONGKONG_PASSPORT：中国香港居民-来往内地通行证
IDENTIFICATION_TYPE_MACAO_PASSPORT：中国澳门居民-来往内地通行证
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]	是	填写受益人的证件类型。枚举值： IDENTIFICATION_TYPE_IDCARD：中国大陆居民-身份证 IDENTIFICATION_TYPE_OVERSEA_PASSPORT：其他国家或地区居民-护照 IDENTIFICATION_TYPE_HONGKONG_PASSPORT：中国香港居民-来往内地通行证 IDENTIFICATION_TYPE_MACAO_PASSPORT：中国澳门居民-来往内地通行证 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、请勾选实际售卖商品/提供服务场景（至少一项），以便为你开通需要的支付权限。
2、建议只勾选目前必须的场景，以便尽快通过入驻审核，其他支付权限可在入驻后再根据实际需要发起申请。

枚举值：

SALES_SCENES_STORE：线下门店
SALES_SCENES_MP：公众号
SALES_SCENES_MINI_PROGRAM：小程序
SALES_SCENES_WEB：PC网站
SALES_SCENES_APP：APP
SALES_SCENES_WEWORK：企业微信

示例值： “SALES_SCENES_STORE”,“SALES_SCENES_MP”

+线下门店场景

biz_store_info

object

条件选填

1、审核通过后，服务商可帮商户发起付款码支付、JSAPI支付。
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、审核通过后，服务商可帮商家发起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, 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、若主体为企业/党政、机关及事业单位/其他组织，可填写：对公银行账户。 2、若主体为个体户，可选择填写：对公银行账户或经营者个人银行卡。枚举值： BANK_ACCOUNT_TYPE_CORPORATE：对公银行账户 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]	否	根据驳回要求提供额外信息，如：业务模式不清晰时，请详细描述支付场景。示例值：特殊情况，说明原因

请求示例

JSON


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

微信支付服务商平台

提交申请单API

注意：

接口说明

请求参数

请求示例

返回参数

返回示例

错误码公共错误码