提交申请单

更新时间:2025.07.17

接口适用场景:电商平台,可使用该接口,帮助其二级商户进件成为微信支付商户。

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

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

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

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

接口说明

支持商户:【平台商户】

请求方式:【POST】/v3/ecommerce/applyments/submit-account-hosting-applyment

请求域名:【主域名】https://api.mch.weixin.qq.com 使用该域名将访问就近的接入点

     【备域名】https://api2.mch.weixin.qq.com 使用该域名将访问异地的接入点 ,指引点击查看

请求参数
折叠全部参数

Header  HTTP头参数

 Authorization  必填 string

请参考签名认证生成认证信息


 Accept  必填 string

请设置为application/json


 Content-Type  必填 string

请设置为application/json


 Wechatpay-Serial  必填 string

【微信支付公钥ID】或【微信支付平台证书序列号】  请求参数中的敏感字段,需要使用微信支付公钥加密(推荐),请参考获取微信支付公钥ID说明以及微信支付公钥加密敏感信息指引;也可以使用微信支付平台证书公钥加密,参考获取平台证书序列号平台证书加密敏感信息指引


body  包体参数

 out_request_no  必填   string

【业务申请编号】 1、服务商自定义的商户唯一编号。
2、每个编号对应一个申请单,每个申请单审核通过后会生成一个微信支付商户号。
3、若申请单被驳回,可填写相同的“业务申请编号”,即可覆盖修改原申请单信息 。


 organization_type  必填   string

【主体类型】 非小微的主体类型需与营业执照/登记证书上一致,可参考选择主体指引,枚举值如下。
2401:小微商户,指无营业执照的个人商家。
2500:个人卖家,指无营业执照,已持续从事电子商务经营活动满6个月,且期间经营收入累计超过20万元的个人商家。(若选择该主体,请在“补充说明”填写相关描述)。
4:个体工商户,营业执照上的主体类型一般为个体户、个体工商户、个体经营。
2:企业,营业执照上的主体类型一般为有限公司、有限责任公司。
3:事业单位,包括国内各类事业单位,如:医疗、教育、学校等单位。
2502:政府机关,包括各级、各类政府机关,如机关党委、税务、民政、人社、工商、商务、市监等。
1708:社会组织,包括社会团体、民办非企业、基金会、基层群众性自治组织、农村集体经济组织等组织。


 finance_institution  选填   boolean

【是否金融机构】 选填,请根据申请主体的实际情况填写,可参考选择金融机构指引
1、若商户主体是金融机构,则填写:true。
2、若商户主体不是金融机构,则填写:false。

若未传入将默认填写:false。


 business_license_info  选填   object

【营业执照/登记证书信息】 1、主体为“小微/个人卖家”时,不填。
2、主体为“个体工商户/企业”时,请上传营业执照。
3、主体为“政府机关/事业单位/社会组织”时,请上传登记证书。

属性

 cert_type  选填   string

【证书类型】 1、主体为“政府机关/事业单位/社会组织”时,请上传登记证书类型。
2、主体为“个体工商户/企业”时,不填。

可选取值

  • CERTIFICATE_TYPE_2388:  事业单位法人证书;当主体为“事业单位”时选择此枚举值

  • CERTIFICATE_TYPE_2389:  统一社会信用代码证书;当主体为“政府机关”或者“社会组织”时选择此枚举值

  • CERTIFICATE_TYPE_2394:  社会团体法人登记证书;当主体为“社会组织”时可选择此枚举值

  • CERTIFICATE_TYPE_2395:  民办非企业单位登记证书;当主体为“社会组织”时可选择此枚举值

  • CERTIFICATE_TYPE_2396:  基金会法人登记证书;当主体为“社会组织”时可选择此枚举值

  • CERTIFICATE_TYPE_2399:  宗教活动场所登记证;当主体为“社会组织”时可选择此枚举值

  • CERTIFICATE_TYPE_2400:  政府部门下发的其他有效证明文件;当主体为“社会组织”时可选择此枚举值

  • CERTIFICATE_TYPE_2520:  执业许可证/执业证;当主体为“社会组织”时可选择此枚举值

  • CERTIFICATE_TYPE_2521:  基层群众性自治组织特别法人统一社会信用代码证;当主体为“社会组织”时可选择此枚举值

  • CERTIFICATE_TYPE_2522:  农村集体经济组织登记证;当主体为“社会组织”时可选择此枚举值


 business_license_copy  选填   string

【营业执照扫描件】 1、主体为“个体工商户/企业”时,请上传营业执照的证件图片。
2、主体为“政府机关/事业单位/社会组织”时,请上传登记证书的证件图片。
3、可上传1张图片,请填写通过图片上传API预先上传图片生成好的MediaID。
4、图片要求:
(1)请上传证件的彩色扫描件或彩色数码拍摄件,黑白复印件需加盖公章(公章信息需完整) 。
(2)不得添加无关水印(非微信支付商户申请用途的其他水印)。
(3)需提供证件的正面拍摄件,完整、照面信息清晰可见。信息不清晰、扭曲、压缩变形、反光、不完整均不接受。
(4)不接受二次剪裁、翻拍、PS的证件照片。


 business_license_number  选填   string

【营业执照注册号】 1、主体为“个体工商户”时,请填写营业执照上的注册号/统一社会信用代码,格式需满足以下任一条件:
-15位数字
-18位阿拉伯数字或大写英文字母(不得包含英文字母I/O/Z/S/V),并且以9开头
2、主体为“企业”时,请填写营业执照上的注册号/统一社会信用代码,格式如下:
-18位阿拉伯数字或大写英文字母(不得包含英文字母I/O/Z/S/V),并且以9开头


 merchant_name  选填   string

【商户名称】 请填写登记证书上的商户名称
1、长度为2-128个字符
2、前后不能有空格、制表符、换行符
3、不能仅含数字、特殊字符
4、仅能填写数字、英文字母、汉字及特殊字符
5、仅支持utf-8格式
6、个体户证件为以下情况时,按照个体户XXX命名(XXX是营业执照经营人姓名):营业执照登记名称为空、仅含数字、仅含特殊字符、“无”、“无字号”
7、个体户不能使用“企业”“公司”或“农民专业合作社”结尾


 legal_person  选填   string

【经营者/法定代表人姓名】 请填写证件的经营者/法定代表人姓名
1、长度为2-100个字符
2、前后不能有空格、制表符、换行符
3、不能仅含特殊字符
4、仅能填写数字、英文字母、汉字及特殊字符


 company_address  选填   string

【注册地址】 1、 主体为“政府机关/事业单位/社会组织”时必填,请填写登记证书的注册地址。
2、主体为“企业/个体户”时建议填写营业执照的注册地址,若该字段未填写,系统将会查询国家工商信息填入。需注意若工商信息查询不到,则会被审核驳回。
3、长度为4-128个字符
4、前后不能有空格、制表符、换行符
5、不能仅含数字、特殊字符
6、仅能填写数字、英文字母、汉字及特殊字符
7、仅支持utf-8格式


 business_time  选填   string

【营业期限】 1、主体为“政府机关/事业单位/社会组织”时必填,请填写证件有效期。
2、主体为“企业/个体户”时建议填写,若该字段未填写,系统将会查询国家工商信息填入,需注意若工商信息查询不到,则会被审核驳回;若该字段填写且证件有效期结束时间大于等于2099-01-01,系统将默认处理为“长期”。
3、日期格式应满足合法的YYYY-MM-DD格式。
4、开始时间不能小于1900-01-01。
5、若证件有效期为长期,请填写:长期。
6、开始时间不能大于等于当前日期,结束时间需大于开始时间。


 finance_institution_info  选填   object

【金融机构许可证信息】 当主体是金融机构时,必填

属性

 finance_type  必填   string

【金融机构类型】 金融机构类型需与营业执照/登记证书上一致,可参考选择金融机构指引

可选取值

  • BANK_AGENT:  银行业,适用于商业银行、政策性银行、农村合作银行、村镇银行、开发性金融机构等

  • PAYMENT_AGENT:  支付机构,适用于非银行类支付机构

  • INSURANCE:  保险业,适用于保险、保险中介、保险代理、保险经纪等保险类业务

  • TRADE_AND_SETTLE:  交易及结算类金融机构,适用于交易所、登记结算类机构、银行卡清算机构、资金清算中心等

  • OTHER:  其他金融机构,适用于财务公司、信托公司、金融资产管理公司、金融租赁公司、汽车金融公司、贷款公司、货币经纪公司、消费金融公司、证券业、金融控股公司、股票、期货、货币兑换、小额贷款公司、金融资产管理、担保公司、商业保理公司、典当行、融资租赁公司、财经咨询等其他金融业务


 finance_license_pics  选填   array[string]

【金融机构许可证图片】 1、照片应正面拍摄、清晰、四角完整、无反光或遮挡;不得翻拍、截图、镜像、PS。
2、上传彩色照片、彩色扫描件,复印件需加盖公章鲜章。
3、水印仅限于微信支付业务相关。
4、根据所属金融机构类型的许可证要求提供,详情查看金融机构指引
5、请提供为“申请商家主体”所属的许可证,可授权使用总公司/分公司的特殊资质。
6、最多可上传5张照片,请填写通过图片上传API预先上传图片生成好的MediaID。


 id_holder_type  选填   string

【证件持有人类型】 1. 主体类型为政府机关/事业单位时选传:
  (1)若上传的是法人证件,则不需要上传该字段。
  (2)若因政策保密等原因,无法提供法人证件时,可上传经办人。 (经办人:经商户授权办理微信支付业务的人员,授权范围包括但不限于签约,入驻过程需完成账户验证)。
2. 主体类型为企业/个体户/社会组织时,默认为经营者/法人,不需要上传该字段。

可选取值

  • LEGAL:  法定代表人

  • SUPER:  经办人


 id_doc_type  选填   string

【经营者/法人证件类型】 1、当证件持有人类型为经营者/法人时,需要填写。其他情况,无需上传。
2、主体为“小微/个人卖家”,可选择:身份证。
3、主体为“个体户/企业/事业单位/社会组织”:可选择任一证件类型,主体为“政府机关”仅支持中国大陆居民-身份证类型。
4、若没有填写,系统默认选择:身份证。

可选取值

  • IDENTIFICATION_TYPE_MAINLAND_IDCARD:  中国大陆居民-身份证

  • IDENTIFICATION_TYPE_OVERSEA_PASSPORT:  其他国家或地区居民-护照

  • IDENTIFICATION_TYPE_HONGKONG:  中国香港居民--来往内地通行证

  • IDENTIFICATION_TYPE_MACAO:  中国澳门居民--来往内地通行证

  • IDENTIFICATION_TYPE_TAIWAN:  中国台湾居民--来往大陆通行证

  • IDENTIFICATION_TYPE_FOREIGN_RESIDENT:  外国人居留证

  • IDENTIFICATION_TYPE_HONGKONG_MACAO_RESIDENT:  港澳居民居住证

  • IDENTIFICATION_TYPE_TAIWAN_RESIDENT:  台湾居民居住证


 authorize_letter_copy  选填   string

【法定代表人说明函】 1、当证件持有人类型为经办人时,必须上传。其他情况,无需上传。
2、因政策保密等原因,无法提供法定代表人证件时,请参照示例图打印法定代表人说明函,全部信息需打印,不支持手写商户信息,并加盖公章。
3、可上传1张图片,请填写通过图片上传API预先上传图片生成好的MediaID。


 id_card_complete_statement  选填   string

【法人影印件信息辅助填写的平台声明】 1、当主体为“个体户/企业/事业单位/社会组织/政府机关”且填写的法人影印件为空时,该值必填,且传入固定值“客户确认你公司用已留存的法人影印件做主体归集和关联管理”
2、当主体为“小微/个人卖家”,经营者影印件必须填写,该值无需填写


 id_card_info  选填   object

【经营者/法人身份证信息】 当证件持有人类型为经营者/法人且证件类型为“身份证”时填写。

属性

 id_card_copy  选填   string

【身份证人像面照片】 1、请上传个体户经营者/法人的身份证人像面照片
2、正面拍摄、清晰、四角完整、无反光或遮挡;不得翻拍、截图、镜像、PS。
3、请上传彩色照片or彩色扫描件,复印件需加盖公章鲜章,可添加“微信支付”相关水印(如微信支付认证),见【指引文档
4、可上传1张图片,请填写通过图片上传API预先上传图片生成好的MediaID 。


 id_card_national  选填   string

【身份证国徽面照片】 1、请上传个体户经营者/法定代表人的身份证国徽面照片
2、正面拍摄、清晰、四角完整、无反光或遮挡;不得翻拍、截图、镜像、PS。
3、请上传彩色照片or彩色扫描件,复印件需加盖公章鲜章,可添加“微信支付”相关水印(如微信支付认证),见【指引文档
4、可上传1张图片,请填写通过图片上传API预先上传图片生成好的MediaID 。


 id_card_name  必填   string

【身份证姓名】 1、请填写个体户经营者/法定代表人对应身份证的姓名
2、长度为2-100个字符
3、前后不能有空格、制表符、换行符
4、不能仅含数字、特殊字符
5、仅能填写数字、英文字母、汉字及特殊字符
6、该字段需进行加密处理,加密方法详见敏感信息加密说明。(提醒:必须在HTTP头中上送Wechatpay-Serial)


 id_card_number  必填   string

【身份证号码】 1、请填写经营者/法定代表人对应身份证的号码。
2、7位数字+1位数字|X,该字段需进行加密处理,加密方法详见敏感信息加密说明。(提醒:必须在HTTP头中上送Wechatpay-Serial)


 id_card_valid_time_begin  必填   string

【身份证开始时间】 1、日期格式应满足合法的YYYY-MM-DD格式
2、开始时间不能小于1900-01-01
3、开始时间不能大于等于当前日期


 id_card_valid_time  必填   string

【身份证结束时间】 1、日期格式应满足合法的YYYY-MM-DD格式或长期
2、结束时间大于开始时间


 id_doc_info  选填   object

【经营者/法人其他类型证件信息】 当证件持有人类型为经营者/法人且证件类型不为“身份证”时填写。

属性

 id_doc_copy  选填   string

【证件正面照片】 1、证件类型不为“身份证”时,上传证件正面照片。
2、正面拍摄、清晰、四角完整、无反光或遮挡;不得翻拍、截图、镜像、PS。
3、请上传彩色照片or彩色扫描件,复印件需加盖公章鲜章,可添加“微信支付”相关水印(如微信支付认证),见【指引文档
4、可上传1张图片,请填写通过图片上传API预先上传图片生成好的MediaID 。


 id_doc_copy_back  选填   string

【证件反面照片】 1、若证件类型为来往通行证、外国人居留证、港澳居住证、台湾居住证时,上传证件反面照片。
2、若证件类型为护照,无需上传反面照片。
3、正面拍摄、清晰、四角完整、无反光或遮挡;不得翻拍、截图、镜像、PS。
4、请上传彩色照片or彩色扫描件,复印件需加盖公章鲜章,可添加“微信支付”相关水印(如微信支付认证),见【指引文档
5、可上传1张图片,请填写通过图片上传API预先上传图片生成好的MediaID 。


 id_doc_name  必填   string

【证件姓名】 1、请填写经营者/法定代表人的证件姓名
2、长度为2-100个字符
3、前后不能有空格、制表符、换行符
4、不能仅含数字、特殊字符
5、仅能填写数字、英文字母、汉字及特殊字符
6、该字段需进行加密处理,加密方法详见敏感信息加密说明。(提醒:必须在HTTP头中上送Wechatpay-Serial)


 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)


 doc_period_begin  必填   string

【证件开始日期】 1、日期格式应满足合法的YYYY-MM-DD格式
2、开始时间不能小于1900-01-01
3、开始时间不能大于等于当前日期


 doc_period_end  必填   string

【证件结束日期】 1、日期格式应满足合法的YYYY-MM-DD格式或长期
2、结束时间大于开始时间


 ubo_info_list  选填   array[object]

【最终受益人信息列表】 1、主体类型为小微/个人卖家/个体户/政府机关/事业单位时,无需填写
2、主体类型为企业或社会组织时,按照下述要求填写
1)若最终受益所有人有且仅有经营者/法定代表人1人,则无需填写,平台会自动帮你进行回填;否则需要在此填写完整的受益人所有人信息(最多上传4人,如包含经营者/法定代表人,则需要一起填写)。
2)根据国家相关法律法规,需要提供的受益所有人信息需符合至少以下条件之一:
▪️直接或者间接拥有超过25%公司股权或者表决权的自然人。
▪️通过人事、财务等其他方式对公司进行控制的自然人。
▪️公司的高级管理人员,包括公司的经理、副经理、财务负责人、上市公司董事会秘书和公司章程规定的其他人员。

属性

 ubo_id_doc_type  选填   string

【证件类型】 请填写受益人的证件类型。
枚举值:

可选取值

  • IDENTIFICATION_TYPE_MAINLAND_IDCARD:  中国大陆居民-身份证

  • IDENTIFICATION_TYPE_OVERSEA_PASSPORT:  其他国家或地区居民-护照

  • IDENTIFICATION_TYPE_HONGKONG:  中国香港居民--来往内地通行证

  • IDENTIFICATION_TYPE_MACAO:  中国澳门居民--来往内地通行证

  • IDENTIFICATION_TYPE_TAIWAN:  中国台湾居民--来往大陆通行证

  • IDENTIFICATION_TYPE_FOREIGN_RESIDENT:  外国人居留证

  • IDENTIFICATION_TYPE_HONGKONG_MACAO_RESIDENT:  港澳居民居住证

  • IDENTIFICATION_TYPE_TAIWAN_RESIDENT:  台湾居民居住证


 ubo_id_doc_copy  选填   string

【证件正面照片】 1、请上传受益人证件的正面照片。
2、若证件类型为身份证,请上传人像面照片。
3、正面拍摄、清晰、四角完整、无反光或遮挡;不得翻拍、截图、镜像、PS。
4、请上传彩色照片or彩色扫描件,复印件需加盖公章鲜章,可添加“微信支付”相关水印(如微信支付认证),见【指引文档
5、可上传1张图片,请填写通过图片上传API预先上传图片生成好的MediaID 。


 ubo_id_doc_copy_back  选填   string

【证件反面照片】 1、请上传受益人证件的反面照片。
2、若证件类型为身份证,请上传国徽面照片。
3、若证件类型为护照,无需上传反面照片。
4、正面拍摄、清晰、四角完整、无反光或遮挡;不得翻拍、截图、镜像、PS。
5、请上传彩色照片or彩色扫描件,复印件需加盖公章鲜章,可添加“微信支付”相关水印(如微信支付认证),见【指引文档
6、可上传1张图片,请填写通过图片上传API预先上传图片生成好的MediaID。


 ubo_id_doc_name  选填   string

【证件姓名】 1、长度为2-100个字符
2、前后不能有空格、制表符、换行符
3、不能仅含数字、特殊字符
4、仅能填写数字、英文字母、汉字及特殊字符
5、该字段需进行加密处理,加密方法详见敏感信息加密说明。(提醒:必须在HTTP头中上送Wechatpay-Serial)


 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)


 ubo_id_doc_address  选填   string

【证件居住地址】 1、请按照身份证住址填写,如广东省深圳市南山区xx路xx号xx室
2、长度为4-128个字符
3、前后不能有空格、制表符、换行符
4、不能仅含数字、特殊字符
5、仅能填写数字、英文字母、汉字及特殊字符
6、仅支持utf-8格式
7、 该字段需进行加密处理,加密方法详见敏感信息加密说明。(提醒:必须在HTTP头中上送Wechatpay-Serial)


 ubo_id_doc_period_begin  选填   string

【证件有效期开始时间】 1、日期格式应满足合法的YYYY-MM-DD格式
2、开始时间不能小于1900-01-01
3、开始时间不能大于等于当前日期


 ubo_id_doc_period_end  选填   string

【证件有效期结束时间】 1、日期格式应满足合法的YYYY-MM-DD格式或长期
2、结束时间大于开始时间


 account_info  必填   object

【结算账户信息】 请填写商家提现收款的银行账户信息。

属性

 bank_account_type  必填   string

【账户类型】 1、若主体为企业/政府机关/事业单位/社会组织,可填写:74-对公账户。
2、主体为小微/个人卖家,可选择:75-对私账户。
3、若主体为个体工商户,可填写:74-对公账户、75-对私账户。


 account_bank  必填   string

【开户银行】 对私银行调用:查询支持个人业务的银行列表API
对公银行调用:查询支持对公业务的银行列表API


 account_name  必填   string

【开户名称】 1、选择经营者个人银行卡时,开户名称必须与身份证姓名一致。
2、选择对公账户时,开户名称必须与营业执照上的“商户名称”一致。
3、该字段需进行加密处理,加密方法详见敏感信息加密说明。(提醒:必须在HTTP头中上送Wechatpay-Serial)


 bank_branch_id  选填   string

【开户银行联行号】 1、根据开户银行查询接口中的“是否需要填写支行”判断是否需要填写。如为其他银行,开户银行全称(含支行)和开户银行联行号二选一。
2、详细需调用查询支行列表API查看查询结果。


 bank_name  选填   string

【开户银行全称  (含支行)】 1、根据开户银行查询接口中的“是否需要填写支行”判断是否需要填写。如为其他银行,开户银行全称(含支行)和开户银行联行号二选一。
2、详细需调用查询支行列表API查看查询结果。


 account_number  必填   string

【银行账号】 1、数字,长度遵循系统支持的对公/对私卡号长度要求表。
2、该字段需进行加密处理,加密方法详见敏感信息加密说明。(提醒:必须在HTTP头中上送Wechatpay-Serial)


 contact_info  必填   object

【超级管理员信息】 请填写店铺的超级管理员信息。
超级管理员需在开户后进行签约,并可接收日常重要管理信息和进行资金操作,请确定其为商户法定代表人或负责人。

属性

 contact_type  必填   string

【超级管理员类型】 1、主体为“小微/个人卖家 ”,可选择:65-经营者/法人。
2、主体为“个体工商户/企业/政府机关/事业单位/社会组织”,可选择:65-经营者/法人、66- 经办人。 (经办人:经商户授权办理微信支付业务的人员)。


 contact_name  必填   string

【超级管理员姓名】 1、若管理员类型为“法人”,则该姓名需与法人身份证姓名一致。
2、若管理员类型为“经办人”,则可填写实际负责人的姓名。
3、长度为2-100个字符
4、前后不能有空格、制表符、换行符
5、不能仅含数字、特殊字符
6、仅能填写数字、英文字母、汉字及特殊字符
7、该字段需进行加密处理,加密方法详见敏感信息加密说明。(提醒:必须在HTTP头中上送Wechatpay-Serial)
(后续该管理员需使用实名微信号完成签约)


 contact_id_doc_type  选填   string

【超级管理员证件类型】 当超级管理员类型是经办人时,请上传超级管理员证件类型。

可选取值

  • IDENTIFICATION_TYPE_MAINLAND_IDCARD:  中国大陆居民-身份证

  • IDENTIFICATION_TYPE_OVERSEA_PASSPORT:  其他国家或地区居民-护照

  • IDENTIFICATION_TYPE_HONGKONG:  中国香港居民--来往内地通行证

  • IDENTIFICATION_TYPE_MACAO:  中国澳门居民--来往内地通行证

  • IDENTIFICATION_TYPE_TAIWAN:  中国台湾居民--来往大陆通行证

  • IDENTIFICATION_TYPE_FOREIGN_RESIDENT:  外国人居留证

  • IDENTIFICATION_TYPE_HONGKONG_MACAO_RESIDENT:  港澳居民居住证

  • IDENTIFICATION_TYPE_TAIWAN_RESIDENT:  台湾居民居住证


 contact_id_card_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)


 contact_id_doc_copy  选填   string

【超级管理员证件正面照片】 1、当超级管理员类型是经办人时,请上传超级管理员证件的正面照片。
2、若证件类型为身份证,请上传人像面照片。
3、正面拍摄、清晰、四角完整、无反光或遮挡;不得翻拍、截图、镜像、PS。
4、请上传彩色照片or彩色扫描件,复印件需加盖公章鲜章,可添加“微信支付”相关水印(如微信支付认证),见【指引文档
5、可上传1张图片,请填写通过图片上传API预先上传图片生成好的MediaID。


 contact_id_doc_copy_back  选填   string

【超级管理员证件反面照片】 1、当超级管理员类型是经办人时,请上传超级管理员证件的反面照片。
2、若证件类型为护照,无需上传反面照片。
3、正面拍摄、清晰、四角完整、无反光或遮挡;不得翻拍、截图、镜像、PS。
4、请上传彩色照片or彩色扫描件,复印件需加盖公章鲜章,可添加“微信支付”相关水印(如微信支付认证),见【指引文档
5、可上传1张图片,请填写通过图片上传API预先上传图片生成好的MediaID。


 contact_id_doc_period_begin  选填   string

【超级管理员证件有效期开始时间】 1、当超级管理员类型是经办人时,请上传证件有效期开始时间。
2、请按照示例值填写,日期格式应满足合法的YYYY-MM-DD格式。
3、开始时间不能小于1900-01-01,开始时间不能大于等于当前日期。


 contact_id_doc_period_end  选填   string

【超级管理员证件有效期结束时间】 1、当超级管理员类型是经办人时,请上传证件有效期结束时间。
2、请按照示例值填写,日期格式应满足合法的YYYY-MM-DD格式,若证件有效期为长期,请填写:长期。
3、结束时间大于开始时间。


 mobile_phone  必填   string

【超级管理员手机】 1、前后不能有空格、制表符、换行符
2、需满足以下任一条件
- 11位数字的手机号码
- 5-20位数字、连字符“-”、加号“+”
3、用于接收微信支付的重要管理信息及日常操作验证码
4、该字段需进行加密处理,加密方法详见敏感信息加密说明。(提醒:必须在HTTP头中上送Wechatpay-Serial)


 sales_scene_info  必填   object

【店铺信息】 请填写店铺信息

属性

 store_name  选填   string

【店铺名称】 请填写店铺全称。


 store_url  选填   string

【店铺链接】 1、店铺二维码or店铺链接二选一必填。
2、请填写店铺主页链接,需符合网站规范。


 store_qr_code  选填   string

【店铺二维码】 1、店铺二维码 or 店铺链接二选一必填。
2、若为电商小程序,可上传店铺页面的小程序二维码。
3、请填写通过图片上传API预先上传图片生成好的MediaID,仅能上传1张图片。


 mini_program_sub_appid  选填   string

【商家小程序APPID】 1、商户自定义字段,可填写已认证的小程序AppID,认证主体需与二级商户主体一致;
2、完成入驻后, 系统发起二级商户号与该AppID的绑定(即配置为sub_appid,可在发起支付时传入)


 settlement_info  选填   object

【结算规则】 请填写商家的结算费率规则、所属行业等信息。若电商平台未传入,系统将填写默认值

属性

 settlement_id  选填   integer

【结算规则ID】 1、选填,请选择二级商户的结算规则ID,需匹配电商平台开通工具箱选择的费率档位,详细参见电商二级商户结算规则对照表
2、若电商平台未传入,将默认选择0.6%费率对应的结算规则id;


 qualification_type  选填   string(200)

【所属行业】 1、选填,请填写二级商户所属的行业名称,映射特殊资质要求,详细参见电商二级商户结算规则对照表
2、若电商平台未传入,将默认填写无需特殊资质的行业名称;


 merchant_shortname  必填   string

【商户简称】 UTF-8格式,中文占3个字节,即最多21个汉字长度。将在支付完成页向买家展示,需与商家的实际售卖商品相符 。


 qualifications  选填   string

【特殊资质】 1、仅当商户选择了必需提交特殊资质的行业时,需要提供该项资料;若商户选择了无需特殊资质的行业,或未选择行业时,无需提交该项资料,详情查看《行业对应特殊资质》
2、请提供为“申请商家主体”所属的特殊资质,可授权使用总公司/分公司的特殊资质;
3、最多可上传5张照片,请填写通过图片上传API预先上传图片生成好的MediaID 。


 business_addition_pics  选填   string

【补充材料】 根据实际审核情况,额外要求提供。最多可上传15张照片,请填写通过图片上传API预先上传图片生成好的MediaID 。


 business_addition_desc  选填   string

【补充说明】 1)若主体为“个人卖家”,该字段必传,需填写描述:【个人卖家声明:该商户已持续从事电子商务经营活动满6个月,且期间经营收入累计超过20万元。】
2)若商户资料审核被驳回要求提交【资金来源】和【资金用途】信息,可依次传入这2个值的内容,具体填写指引见资金来源与资金用途填写要求指引
(填写示例:【资金来源:自有资金;经营性收入】【资金用途:经营活动开支】,其中多个值之间使用中文分号隔开)


 proxy_sign_verify_mode  必填   boolean

【是否走平台代理签约和代理核身入驻模式】 1、若走平台代理签约和代理核身入驻模式,则填写:true。
2、若走微信支付签约和核身入驻模式,则填写:false。

请求示例

curl
Java
Go

POST

1curl -X POST \
2  https://api.mch.weixin.qq.com/v3/ecommerce/applyments/submit-account-hosting-applyment \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" \
5  -H "Wechatpay-Serial: 5157F09EFDC096DE15EBE81A47057A7232F1B8E1"  \
6  -H "Content-Type: application/json" \
7  -d '{
8    "out_request_no" : "APPLYMENT_00000000001",
9    "organization_type" : "2",
10    "finance_institution" : true,
11    "business_license_info" : {
12      "cert_type" : "CERTIFICATE_TYPE_2388",
13      "business_license_copy" : "47ZC6GC-vnrbEny__Ie_An5-tCpqxucuxi-vByf3Gjm7KE53JXvGy9tqZm2XAUf-4KGprrKhpVBDIUv0OF4wFNIO4kqg05InE4d2I6_H7I4",
14      "business_license_number" : "123456789012345678",
15      "merchant_name" : "腾讯科技有限公司",
16      "legal_person" : "张三",
17      "company_address" : "深圳南山区科苑路",
18      "business_time" : "[\\\"2014-01-01\\\",\\\"长期\\\"]"
19    },
20    "finance_institution_info" : {
21      "finance_type" : "BANK_AGENT",
22      "finance_license_pics" : [
23        "example_finance_license_pics"
24      ]
25    },
26    "id_holder_type" : "LEGAL",
27    "id_doc_type" : "IDENTIFICATION_TYPE_MACAO",
28    "authorize_letter_copy" : "47ZC6GC-vnrbEny_Ie_An5-tCpqxucuxi-vByf3Gjm7KEIUv0OF4wFNIO4kqg05InE4d2I6_H7I4",
29    "id_card_complete_statement" : "example_id_card_complete_statement",
30    "id_card_info" : {
31      "id_card_copy" : "jTpGmxUX3FBWVQ5NJTZvlKX_gdU4cRz7z5NxpnFuAxhBTEO_PvWkfSCJ3zVIn001D8daLC-ehEuo0BJqRTvDujqhThn4ReFxikqJ5YW6zFQ",
32      "id_card_national" : "47ZC6GC-vnrbEny__Ie_An5-tCpqxucuxi-vByf3Gjm7KE53JXvGy9tqZm2XAUf-4KGprrKhpVBDIUv0OF4wFNIO4kqg05InE4d2I6_H7I4",
33      "id_card_name" : "pVd1HJ6zyvPedzGaV+X3qtmrq9bb9tPROvwia4ibL+F6mfjbzQIzfb3HHLEjZ4YiR/cJiCrZxnAqi+pjeKIEdkwzXRAI7FUhrfPK3SNjaBTEu9GmsugMIA9r3x887Q+ODuC8HH2nzAn7NGpE/e3yiHgWhk0ps5k5DP/2qIdGdONoDzZelrxCl/NWWNUyB93K9F+jC1JX2IMttdY+aQ6zBlw0xnOiNW6Hzy7UtC+xriudjD5APomty7/mYNxLMpRSvWKIjOv/69bDnuC4EL5Kz4jBHLiCyOb+tI0m2qhZ9evAM+Jv1z0NVa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg==",
34      "id_card_number" : "AOZdYGISxo4y44/UgZ69bdu9X+tfMUJ9dl+LetjM45/zMbrYu+wWZ8gn4CTdo+D/m9MrPg+V4sm73oxqdQu/hj7aWyDl4GQtPXVdaztB9jVbVZh3QFzV+BEmytMNQp9dt1uWJktlfdDdLR3AMWyMB377xd+m9bSr/ioDTzagEcGe+vLYiKrzcroQv3OR0p3ppFYoQ3IfYeU/04S4t9rNFL+kyblK2FCCqQ11NdbbHoCrJc7NV4oASq6ZFonjTtgjjgKsadIKHXtb3JZKGZjduGdtkRJJp0/0eow96uY1Pk7Rq79Jtt7+I8juwEc4P4TG5xzchG/5IL9DBd+Z0zZXkw==",
35      "id_card_valid_time_begin" : "2019-06-06",
36      "id_card_valid_time" : "2026-06-06"
37    },
38    "id_doc_info" : {
39      "id_doc_copy" : "47ZC6GC-vnrbEny__Ie_An5-tCpqxucuxi-vByf3Gjm7KE53JXvGy9tqZm2XAUf-4KGprrKhpVBDIUv0OF4wFNIO4kqg05InE4d2I6_H7I4",
40      "id_doc_copy_back" : "47ZC6GC-vnrbEny__Ie_An5-tCpqxucuxi-vByf3Gjm7KE53JXvGy9tqZm2XAUf-4KGprrKhpVBDIUv0OF4wFNIO4kqg05InE4d2I6_H7I4",
41      "id_doc_name" : "jTpGmxUX3FBWVQ5NJTZvlKX_gdU4cRz7z5NxpnFuAxhBTEO_PvWkfSCJ3zVIn001D8daLC-ehEuo0BJqRTvDujqhThn4ReFxikqJ5YW6zFQ",
42      "id_doc_number" : "jTpGmxUX3FBWVQ5NJTZvlKX_gdU4cRz7z5NxpnFuAxhBTEO_PvWkfSCJ3zVIn001D8daLC-ehEuo0BJqRTvDujqhThn4ReFxikqJ5YW6zFQ",
43      "doc_period_begin" : "2019-06-06",
44      "doc_period_end" : "2020-01-02"
45    },
46    "ubo_info_list" : [
47      {
48        "ubo_id_doc_type" : "IDENTIFICATION_TYPE_MAINLAND_IDCARD",
49        "ubo_id_doc_copy" : "jTpGmxUXqRTvDujqhThn4ReFxikqJ5YW6zFQ",
50        "ubo_id_doc_copy_back" : "jTpGmxUX3FBWVQ5NJTZvvDujqhThn4ReFxikqJ5YW6zFQ",
51        "ubo_id_doc_name" : "AOZdYGISxo4y44/Ug4P4TG5xzchG/5IL9DBd+Z0zZXkw==",
52        "ubo_id_doc_number" : "AOZdYGISxo4y44/Ug4P4TG5xzchG/5IL9DBd+Z0zZXkw==",
53        "ubo_id_doc_address" : "pVd1HJ6zyvPedzGaV+X3qtmrq9bb9tPROvwia4ibL+F6mfjbzQIzfb3HHLEjZ4YiR/cJiCrZxnAqi+pjeKIEdkwzXRAI7FUhrfPK3SNjaBTEu9GmsugMIA9r3x887Q+ODuC8HH2nzAn7NGpE/e3yiHgWhk0ps5k5DP/2qIdGdONoDzZelrxCl/NWWNUyB93K9F+jC1JX2IMttdY+aQ6zBlw0xnOiNW6Hzy7UtC+xriudjD5APomty7/mYNxLMpRSvWKIjOv/69bDnuC4EL5Kz4jBHLiCyOb+tI0m2qhZ9evAM+Jv1z0NVa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg==",
54        "ubo_id_doc_period_begin" : "2019-06-06",
55        "ubo_id_doc_period_end" : "2026-06-06"
56      }
57    ],
58    "account_info" : {
59      "bank_account_type" : "75",
60      "account_bank" : "工商银行",
61      "account_name" : "AOZdYGISxo4y44/UgZ69bdu9X+tfMUJ9dl+LetjM45/zMbrYu+wWZ8gn4CTdo+D/m9MrPg+V4sm73oxqdQu/hj7aWyDl4GQtPXVdaztB9jVbVZh3QFzV+BEmytMNQp9dt1uWJktlfdDdLR3AMWyMB377xd+m9bSr/ioDTzagEcGe+vLYiKrzcroQv3OR0p3ppFYoQ3IfYeU/04S4t9rNFL+kyblK2FCCqQ11NdbbHoCrJc7NV4oASq6ZFonjTtgjjgKsadIKHXtb3JZKGZjduGdtkRJJp0/0eow96uY1Pk7Rq79Jtt7+I8juwEc4P4TG5xzchG/5IL9DBd+Z0zZXkw==",
62      "bank_branch_id" : "402713354941",
63      "bank_name" : "施秉县农村信用合作联社城关信用社",
64      "account_number" : "d+xT+MQCvrLHUVDWv/8MR/dB7TkXM2YYZlokmXzFsWs35NXUot7C0NcxIrUF5FnxqCJHkNgKtxa6RxEYyba1+VBRLnqKG2fSy/Y5qDN08Ej9zHCwJjq52Wg1VG8MRugli9YMI1fI83KGBxhuXyemgS/hqFKsfYGiOkJqjTUpgY5VqjtL2N4l4z11T0ECB/aSyVXUysOFGLVfSrUxMPZy6jWWYGvT1+4P633f+R+ki1gT4WF/2KxZOYmli385ZgVhcR30mr4/G3HBcxi13zp7FnEeOsLlvBmI1PHN4C7Rsu3WL8sPndjXTd75kPkyjqnoMRrEEaYQE8ZRGYoeorwC+w=="
65    },
66    "contact_info" : {
67      "contact_type" : "65",
68      "contact_name" : "pVd1HJ6zyvPedzGaV+X3qtmrq9bb9tPROvwia4ibL+F6mfjbzQIzfb3HHLEjZ4YiR/cJiCrZxnAqi+pjeKIEdkwzXRAI7FUhrfPK3SNjaBTEu9GmsugMIA9r3x887Q+ODuC8HH2nzAn7NGpE/e3yiHgWhk0ps5k5DP/2qIdGdONoDzZelrxCl/NWWNUyB93K9F+jC1JX2IMttdY+aQ6zBlw0xnOiNW6Hzy7UtC+xriudjD5APomty7/mYNxLMpRSvWKIjOv/69bDnuC4EL5Kz4jBHLiCyOb+tI0m2qhZ9evAM+Jv1z0NVa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg==",
69      "contact_id_doc_type" : "IDENTIFICATION_TYPE_MACAO",
70      "contact_id_card_number" : "pVd1HJ6zyvPedzGaV+X3qtmrq9bb9tPROvwia4ibL+F6mfjbzQIzfb3HHLEjZ4YiR/cJiCrZxnAqi+pjeKIEdkwzXRAI7FUhrfPK3SNjaBTEu9GmsugMIA9r3x887Q+ODuC8HH2nzAn7NGpE/e3yiHgWhk0ps5k5DP/2qIdGdONoDzZelrxCl/NWWNUyB93K9F+jC1JX2IMttdY+aQ6zBlw0xnOiNW6Hzy7UtC+xriudjD5APomty7/mYNxLMpRSvWKIjOv/69bDnuC4EL5Kz4jBHLiCyOb+tI0m2qhZ9evAM+Jv1z0NVa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg==",
71      "contact_id_doc_copy" : "jTpGmxUX3FBWVQ5NJTZvvDujqhThn4ReFxikqJ5YW6zFQ",
72      "contact_id_doc_copy_back" : "jTpGmxUX3FBWVQ5NJTZvvDujqhThn4ReFxikqJ5YW6zFQ",
73      "contact_id_doc_period_begin" : "2019-06-06",
74      "contact_id_doc_period_end" : "2026-06-06",
75      "mobile_phone" : "pVd1HJ6zyvPedzGaV+X3qtmrq9bb9tPROvwia4ibL+F6mfjbzQIzfb3HHLEjZ4YiR/cJiCrZxnAqi+pjeKIEdkwzXRAI7FUhrfPK3SNjaBTEu9GmsugMIA9r3x887Q+ODuC8HH2nzAn7NGpE/e3yiHgWhk0ps5k5DP/2qIdGdONoDzZelrxCl/NWWNUyB93K9F+jC1JX2IMttdY+aQ6zBlw0xnOiNW6Hzy7UtC+xriudjD5APomty7/mYNxLMpRSvWKIjOv/69bDnuC4EL5Kz4jBHLiCyOb+tI0m2qhZ9evAM+Jv1z0NVa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg=="
76    },
77    "sales_scene_info" : {
78      "store_name" : "爱烧烤",
79      "store_url" : "http://www.qq.com",
80      "store_qr_code" : "jTpGmxUX3FBWVQ5NJTZvlKX_gdU4cRz7z5NxpnFuAxhBTEO_PvWkfSCJ3zVIn001D8daLC-ehEuo0BJqRTvDujqhThn4ReFxikqJ5YW6zFQ",
81      "mini_program_sub_appid" : "wxa123344545577"
82    },
83    "settlement_info" : {
84      "settlement_id" : 719,
85      "qualification_type" : "零售批发/生活娱乐/其他"
86    },
87    "merchant_shortname" : "腾讯",
88    "qualifications" : "[\\\"jTpGmxUX3FBWVQ5NJTZvlKX_gdU4cRz7z5NxpnFuAxhBTEO_PvWkfSCJ3zVIn001D8daLC-ehEuo0BJqRTvDujqhThn4ReFxikqJ5YW6zFQ\\\",\\\"47ZC6GC-vnrbEny__Ie_An5-tCpqxucuxi-vByf3Gjm7KE53JXvGy9tqZm2XAUf-4KGprrKhpVBDIUv0OF4wFNIO4kqg05InE4d2I6_H7I4\\\"]",
89    "business_addition_pics" : "[\\\"jTpGmxUX3FBWVQ5NJTZvlKX_gdU4cRz7z5NxpnFuAxhBTEO_PvWkfSCJ3zVIn001D8daLC-ehEuo0BJqRTvDujqhThn4ReFxikqJ5YW6zFQ\\\",\\\"47ZC6GC-vnrbEny__Ie_An5-tCpqxucuxi-vByf3Gjm7KE53JXvGy9tqZm2XAUf-4KGprrKhpVBDIUv0OF4wFNIO4kqg05InE4d2I6_H7I4\\\"]",
90    "business_addition_desc" : "特殊情况,说明原因",
91    "proxy_sign_verify_mode" : true
92  }'
93

应答参数

200 OK

 applyment_id  必填   integer

【微信支付申请单号】 微信支付分配的申请单号 。


 out_request_no  必填   string

【业务申请编号】 服务商自定义的商户唯一编号。每个编号对应一个申请单,每个申请单审核通过后会生成一个微信支付商户号。

应答示例

200 OK

1{
2  "applyment_id" : 2000002124775691,
3  "out_request_no" : "APPLYMENT_00000000001"
4}
5

 

错误码

以下是本接口返回的错误码列表。详细错误码规则,请参考微信支付接口规则-错误码和错误提示

状态码

错误码

描述

解决方案

400

PARAM_ERROR

参数错误

请根据错误提示正确传入参数

400

INVALID_REQUEST

HTTP 请求不符合微信支付 APIv3 接口规则

请参阅 接口规则

401

SIGN_ERROR

验证不通过

请参阅 签名常见问题

500

SYSTEM_ERROR

系统异常,请稍后重试

请稍后重试

 

元宝AI
反馈
目录
置顶