提交申请单

更新时间:2025.01.09

渠道商可以通过该接口向微信支付提交商户的联系人、主体等信息,根据指引完成商户开户意愿确认。

功能接入可看产品流程指引

接口频率: 5QPS(商户号维度)

是否支持幂等: 是

注意:

  1. 商户上送敏感信息时需要使用微信支付公钥加密(推荐),请参考获取微信支付公钥ID说明以及微信支付公钥加密敏感信息指引,也可以使用微信支付平台证书公钥加密,参考获取平台证书序列号平台证书加密敏感信息指引

接口说明

支持商户:【渠道商】 【从业机构(银行)】 【从业机构(支付机构)】

请求方式:【POST】/v3/apply4subject/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  包体参数

 channel_id  选填   string(9)

【渠道商户号】 1、微信支付分配的渠道商户唯一标识
2、当从业机构调用时,该字段必填,需填写从业机构下的渠道商户号
3、当渠道商户调用时,该字段无需填写


 business_code  必填   string(128)

【业务申请编号】 1、只能由数字、字母或下划线组成
2、服务商自定义的唯一编号。每个编号对应一个申请单
3、建议前缀带上服务商商户号,参看示例值


 contact_info  必填   object

【联系人信息】 联系人信息,联系人是商户的联系人,将接收开户信息及日常重要管理信息,请确定联系人为商户法定代表人或经营者再进行操作。如联系人非商户法定代表人或经营者,请提交经办人身份证件和业务办理授权函。

属性

 name  必填   string(1024)

【联系人姓名】 1、若联系人类型为“法定代表人”,则该姓名需与法定代表人姓名一致。
2、若联系人类型为“经办人”,则可填写实际经办人的姓名。
3、长度为2-100个字符
4、前后不能有空格、制表符、换行符
5、不能仅含数字、特殊字符
6、仅能填写数字、英文字母、汉字及特殊字符
7、该字段需要使用微信支付公钥加密(推荐),请参考获取微信支付公钥ID说明以及微信支付公钥加密敏感信息指引,也可以使用微信支付平台证书公钥加密,参考获取平台证书序列号平台证书加密敏感信息指引


 mobile  必填   string(1024)

【联系人手机号】 1、前后不能有空格、制表符、换行符
2、需满足以下任一条件

  • 11位数字的手机号码

  • 5-20位数字、连字符“-”、加号“+”

3、用于接收微信支付的重要管理信息及日常操作验证码
4、该字段需要使用微信支付公钥加密(推荐),请参考获取微信支付公钥ID说明以及微信支付公钥加密敏感信息指引,也可以使用微信支付平台证书公钥加密,参考获取平台证书序列号平台证书加密敏感信息指引


 id_card_number  选填   string(1024)

【联系人证件号码】 1、若联系人类型为法定代表人,则该身份证号码需与法定代表人身份证号码一致。若联系人类型为经办人,则可填写实际经办人的身份证号码。
2、可传身份证、来往内地通行证、来往大陆通行证、护照等证件号码,规范如下:
身份证(限中国大陆居民):17位数字+1位数字|X
护照(限境外人士):4-15位 数字|字母|连字符
中国香港居民--来往内地通行证:H/h开头+8或10位数字/字母
中国澳门居民--来往内地通行证:M/m开头+8或10位数字/字母
中国台湾居民--来往大陆通行证:8位数字或10位数字
外国人居留证:15位 数字


 contact_type  必填   string

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


 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:  台湾居民居住证


 contact_id_doc_copy  选填   string(256)

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


 contact_id_doc_copy_back  选填   string(256)

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


 contact_period_begin  选填   string(128)

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


 contact_period_end  选填   string(128)

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


 subject_info  必填   object

【主体信息】 主体信息

属性

 subject_type  必填   string

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

可选取值

  • SUBJECT_TYPE_ENTERPRISE:  企业,营业执照上的主体类型一般为有限公司、有限责任公司

  • SUBJECT_TYPE_INSTITUTIONS_CLONED:  事业单位,包括国内各类事业单位,如:医疗、教育、学校等单位

  • SUBJECT_TYPE_INDIVIDUAL:  个体工商户,营业执照上的主体类型一般为个体户、个体工商户、个体经营

  • SUBJECT_TYPE_OTHERS:  社会组织,包括社会团体、民办非企业、基金会、基层群众性自治组织、农村集体经济组织等组织

  • SUBJECT_TYPE_MICRO:  小微商户,无营业执照、免办理工商注册登记的实体商户

  • SUBJECT_TYPE_GOVERNMENT:  政府机关,包括各级、各类政府机关,如机关党委、税务、民政、人社、工商、商务、市监等


 is_finance_institution  选填   boolean

【是否金融机构】 选填,请根据申请主体的实际情况填写,可参考选择金融机构指引: 

1、若商户主体是金融机构,则填写:true。

2、若商户主体不是金融机构,则填写:false。 

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


 business_licence_info  选填   object

【营业执照信息】 主体类型为企业/个体户时,营业执照信息必填

属性

 licence_number  必填   string(32)

【营业执照注册号】 1、主体为“个体工商户”时,请填写营业执照上的注册号/统一社会信用代码,格式需满足以下任一条件:

  • 15位数字

  • 18位阿拉伯数字或大写英文字母(不得包含英文字母I/O/Z/S/V),并且以9开头

2、主体为“企业”时,请填写营业执照上的注册号/统一社会信用代码,格式如下:

  • 18位阿拉伯数字或大写英文字母(不得包含英文字母I/O/Z/S/V),并且以9开头


 licence_copy  必填   string(255)

【营业执照照片】 1、照片应正面拍摄、清晰、四角完整、无反光或遮挡;不得翻拍、截图、镜像、PS;
2、上传彩色照片、彩色扫描件,复印件需加盖公章鲜章。
3、水印仅限于微信支付业务相关。
4、指引与示例可参考【指引文档
5、请填写通过《图片上传API》预先上传图片生成好的MediaID


 merchant_name  必填   string(128)

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


 legal_person  必填   string(100)

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


 company_address  必填   string(128)

【注册地址】 建议填写营业执照的注册地址
1、长度为4-128个字符
2、前后不能有空格、制表符、换行符
3、不能仅含数字、特殊字符
4、仅能填写数字、英文字母、汉字及特殊字符
5、仅支持utf-8格式


 licence_valid_date  必填   string(64)

【营业执照有效日期】 1、日期格式应满足合法的YYYY-MM-DD格式,参见示例值
2、开始时间不能小于1900-01-01
3、若证件有效期为长期,请填写:长期。
4、开始时间不能大于等于当前日期,结束时间需大于开始时间。
示例值:[\"2017-10-28\",\"长期\"]


 certificate_info  选填   object

【登记证书信息】 主体为政府机关/事业单位/社会组织时,必填。

属性

 cert_type  必填   string

【证书类型】 登记证书的类型。

1、主体为“政府机关/事业单位/社会组织”时,请上传登记证书类型。

当主体为事业单位时,选择此枚举值:
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:政府部门下发的其他有效证明文件


 cert_number  必填   string(50)

【证书编号】 请输入与所选证书类型相匹配且符合国家标准规范的证书号,其中除政府证明文件外,需满足18位阿拉伯数字或大写英文字母(不得包含英文字母I/O/Z/S/V)


 cert_copy  必填   string(255)

【证书照片】 1、照片应正面拍摄、清晰、四角完整、无反光或遮挡;不得翻拍、截图、镜像、PS;
2、上传彩色照片、彩色扫描件,复印件需加盖公章鲜章。
3、水印仅限于微信支付业务相关。
4、指引与示例可参考【指引文档
5、请填写通过《图片上传API》预先上传图片生成好的MediaID


 merchant_name  必填   string(128)

【商户名称】 请填写登记证书上的商户名称
1、长度为2-128个字符
2、前后不能有空格、制表符、换行符
3、不能仅含数字、特殊字符
4、仅能填写数字、英文字母、汉字及特殊字符
5、仅支持utf-8格式


 legal_person  必填   string(100)

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


 company_address  必填   string(128)

【注册地址】 请填写登记证书的注册地址
1、长度为4-128个字符
2、前后不能有空格、制表符、换行符
3、不能仅含数字、特殊字符
4、仅能填写数字、英文字母、汉字及特殊字符
5、仅支持utf-8格式


 cert_valid_date  必填   string(64)

【证书有效日期】 1、日期格式应满足合法的YYYY-MM-DD格式,参见示例值
2、若证件有效期为长期,请填写:长期。
3、开始时间不能大于等于当前日期,结束时间需大于开始时间。
示例值:[\"2017-10-28\",\"长期\"]


 company_prove_copy  选填   string(255)

【单位证明函照片】 1、主体类型为政府机关/事业单位时,单位证明函照片必填。
2、单位证明函格式参考示例
3、请填写通过《图片上传API》预先上传图片生成好的MediaID


 assist_prove_info  选填   object

【辅助证明材料信息】 主体类型为小微商户时,辅助证明材料信息必填

属性

 micro_biz_type  必填   string

【小微经营类型】 

可选取值

  • MICRO_TYPE_STORE:  门店场所

  • MICRO_TYPE_MOBILE:  流动经营/便民服务

  • MICRO_TYPE_ONLINE:  线上商品/服务交易


 store_name  必填   string(50)

【门店名称】 1、填写规范:
门店场所:填写门店名称
流动经营/便民服务:填写经营/服务名称
线上商品/服务交易:填写线上店铺名称
2、格式规范:
长度为1-50个字符
前后不能有空格、制表符、换行符
不能仅含数字、特殊字符
仅能填写数字、英文字母、汉字及特殊字符


 store_address_code  必填   string(16)

【门店省市编码】 1、只能由数字组成
2、详细参见微信支付提供的省市对照表
3、填写规范:
门店场所:填写门店省市编码
流动经营/便民服务:填写经营/服务所在地省市编码
线上商品/服务交易:填写卖家所在地省市编码


 store_address  必填   string(512)

【门店地址】 1、填写规范:
门店场所:填写店铺详细地址,具体区/县及街道门牌号或大厦楼层
流动经营/便民服务:填写“无”
线上商品/服务交易:填写电商平台名称
2、格式规范:
长度为4-512个字符
前后不能有空格、制表符、换行符
不能仅含数字、特殊字符
仅能填写数字、英文字母、汉字及特殊字符
仅支持utf-8格式


 store_header_copy  必填   string(255)

【门店门头照片】 1、请上传门头正面照片(要求门店招牌、门框完整、清晰、可辨识);若为停车场等无固定门头照片的经营场所,可上传岗亭/出入闸口。具体参考【指引文档】;

2、请填写通过《图片上传API》预先上传图片生成好的MediaID


 store_indoor_copy  必填   string(255)

【店内环境照片】 1、请上传门头正面照片(要求门店招牌、门框完整、清晰、可辨识);若为停车场等无固定门头照片的经营场所,可上传岗亭/出入闸口。具体参考【指引文档】;

2、请填写通过《图片上传API》预先上传图片生成好的MediaID


 special_operation_list  选填   array[object]

【经营许可证】 1、填写特殊行业的经营许可证信息

2、最多填写支持5个行业

属性

 category_id  必填   integer

【行业类目id】 参看微信支付提供的特殊行业id对照表


 operation_copy_list  选填   array[string(255)]

【行业经营许可证资质照片】 1、请根据特殊行业ID对照表内指引,仅当所选择的行业为【必填经营许可证】的行业时,才需上传该项资料
2、请填写通过《图片上传API》预先上传图片生成好的MediaID
3、每个行业最多支持5张资质照片


 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。


 identification_info  必填   object

【法定代表人身份信息】 法定代表人身份信息

属性

 id_holder_type  选填   string

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

可选取值

  • LEGAL:  经营者/法定代表人

  • SUPER:  经办人


 identification_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_name  选填   string(1024)

【证件姓名】 1、当证件持有人类型为法定代表人时,请填写法定代表人证件上的姓名。其他情况,无需上传。
2、长度为2-100个字符
3、前后不能有空格、制表符、换行符
4、不能仅含数字、特殊字符
5、仅能填写数字、英文字母、汉字及特殊字符
6、该字段需要使用微信支付公钥加密(推荐),请参考获取微信支付公钥ID说明以及微信支付公钥加密敏感信息指引,也可以使用微信支付平台证书公钥加密,参考获取平台证书序列号平台证书加密敏感信息指引


 identification_number  选填   string(1024)

【证件号码】 1、当证件持有人类型为法定代表人时,请填写法定代表人证件上的证件号码。其他情况,无需上传。
2、可传身份证、来往内地通行证、来往大陆通行证、护照等证件号码,号码规范如下:
身份证(限中国大陆居民):17位数字+1位数字|X
护照(限境外人士):4-15位 数字|字母|连字符
中国香港居民--来往内地通行证:H/h开头+8或10位数字/字母
中国澳门居民--来往内地通行证:M/m开头+8或10位数字/字母
中国台湾居民--来往大陆通行证:8位数字或10位数字
外国人居留证:15位 数字|字母
台湾居民居住证/港澳居民居住证:17位数字+1位数字|X
3、该字段需要使用微信支付公钥加密(推荐),请参考获取微信支付公钥ID说明以及微信支付公钥加密敏感信息指引,也可以使用微信支付平台证书公钥加密,参考获取平台证书序列号平台证书加密敏感信息指引


 identification_valid_date  选填   string(64)

【证件有效日期】 1、日期格式应满足合法的YYYY-MM-DD格式,参见示例值
2、若证件有效期为长期,请填写:长期。
3、开始时间不能大于等于当前日期,结束时间需大于开始时间。
示例值:[\"2017-10-28\",\"长期\"]


 identification_front_copy  选填   string(255)

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


 identification_back_copy  选填   string(255)

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


 authorize_letter_copy  选填   string(255)

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


 owner  选填   boolean

【经营者/法定代表人是否为受益人】该字段即将下线处理,无需传入

主体类型为企业时,需要填写:
1、若经营者/法定代表人是最终受益人,则填写:true。
2、若经营者/法定代表人不是最终受益人,则填写:false。


 identification_address  选填   string(512)

【证件居住地址】 1、主体类型为企业时,需要填写。其他主体类型,无需上传。
2、请按照身份证住址填写,如广东省深圳市南山区xx路xx号xx室
3、长度为4-128个字符
4、前后不能有空格、制表符、换行符
5、不能仅含数字、特殊字符
6、仅能填写数字、英文字母、汉字及特殊字符
7、仅支持utf-8格式
8、该字段需要使用微信支付公钥加密(推荐),请参考获取微信支付公钥ID说明以及微信支付公钥加密敏感信息指引,也可以使用微信支付平台证书公钥加密,参考获取平台证书序列号平台证书加密敏感信息指引


 addition_info  选填   object

【补充材料】 根据实际审核情况,额外要求商家提供指定的补充资料。

属性

 confirm_mchid_list  选填   array[string]

【待确认商户号列表】 1、若有填写,创建申请单后,商家可扫码打开申请单的二维码,提前完成授权商户号; 详细流程请看产品指引
2、商户号填写要求如下:
(1)请确保商户号全称与申请单主体名称一致;
(2)如特殊行业商户,请确保商户号结算规则ID与经营许可证匹配;
(3)一个申请单最多可以提交20个商户号。
3、校验报错说明
(1)提交申请单不满足上述要求,则无法创建申请单,返回报错格式参考如下。
"123456789:待确认商户号不存在,请检查待确认商户号是否正确;1234567:查询待确认商户信息发生系统失败,请稍后再试[269795842];999990017:待确认商户号不是当前从业机构的特约商户"
(2)若服务商需实现剔除报错商户号逻辑,建议根据格式(如标点符号)筛选商户号,不根据报错文案筛选(因后续可能调整文案)。


 ubo_info_list  选填   array[UBOInfoList]

【最终受益人信息列表(UBO)】 该字段即将下线处理,无需传入

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

属性

 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:  台湾居民居住证


 ubo_id_doc_copy  选填   string(256)

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


 ubo_id_doc_copy_back  选填   string(256)

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


 ubo_id_doc_name  选填   string(1024)

【证件姓名】 1、长度为2-100个字符
2、前后不能有空格、制表符、换行符
3、不能仅含数字、特殊字符
4、仅能填写数字、英文字母、汉字及特殊字符
5、该字段需要使用微信支付公钥加密(推荐),请参考获取微信支付公钥ID说明以及微信支付公钥加密敏感信息指引,也可以使用微信支付平台证书公钥加密,参考获取平台证书序列号平台证书加密敏感信息指引


 ubo_id_doc_number  选填   string(1024)

【证件号码】 1、可传身份证、来往内地通行证、来往大陆通行证、护照等证件号码,号码规范如下:
身份证(限中国大陆居民):17位数字+1位数字|X
护照(限境外人士):4-15位 数字|字母|连字符
中国香港居民--来往内地通行证:H/h开头+8或10位数字/字母
中国澳门居民--来往内地通行证:M/m开头+8或10位数字/字母
中国台湾居民--来往大陆通行证:8位数字或10位数字
外国人居留证:15位 数字|字母
台湾居民居住证/港澳居民居住证:17位数字+1位数字|X
2、该字段需要使用微信支付公钥加密(推荐),请参考获取微信支付公钥ID说明以及微信支付公钥加密敏感信息指引,也可以使用微信支付平台证书公钥加密,参考获取平台证书序列号平台证书加密敏感信息指引


 ubo_id_doc_address  选填   string(1024)

【证件居住地址】 1、请按照身份证住址填写,如广东省深圳市南山区xx路xx号xx室
2、长度为4-128个字符
3、前后不能有空格、制表符、换行符
4、不能仅含数字、特殊字符
5、仅能填写数字、英文字母、汉字及特殊字符
6、仅支持utf-8格式
7、该字段需要使用微信支付公钥加密(推荐),请参考获取微信支付公钥ID说明以及微信支付公钥加密敏感信息指引,也可以使用微信支付平台证书公钥加密,参考获取平台证书序列号平台证书加密敏感信息指引


 ubo_period_begin  选填   string(128)

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


 ubo_period_end  选填   string(128)

【证件有效期结束时间】 1、请按照示例值填写,若证件有效期为长期,请填写:长期。
2、结束时间大于开始时间。

请求示例

curl
Java
Go

POST

1curl -X POST \
2  https://api.mch.weixin.qq.com/v3/apply4subject/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    "channel_id" : "20001111",
9    "business_code" : "1900013511_10000",
10    "contact_info" : {
11      "name" : "pVd1HJ6zyvPedzGaV+X3IdGdbDnuC4Eelw/wDa4SzfeespQO/0kjiwfqdfg==",
12      "mobile" : "Oiw4DS+QVyZKC3eTd7CGvGQ1/sidmLm8mdsohkuR9jSiwXyHyVQD1OA1t+6Pb+Xn0q2HAJYLsNjh8O4S1iQgMrFohyaNms4IlDxJzujb9VA==",
13      "id_card_number" : "pVd1HJ6zmty7/mYNxLMpRSvMRtelw/wDa4SzfeespQO/0kjiwfqdfg==",
14      "contact_type" : "LEGAL",
15      "contact_id_doc_type" : "IDENTIFICATION_TYPE_IDCARD",
16      "contact_id_doc_copy" : "jTpGmxUXqRTvDujqhThn4ReFxikqJ5YW6zFQ",
17      "contact_id_doc_copy_back" : "jTpGmxUX3FBWVQ5NJTZvvDujqhThn4ReFxikqJ5YW6zFQ",
18      "contact_period_begin" : "2019-06-06",
19      "contact_period_end" : "2026-06-06"
20    },
21    "subject_info" : {
22      "subject_type" : "SUBJECT_TYPE_ENTERPRISE",
23      "is_finance_institution" : false,
24      "business_licence_info" : {
25        "licence_number" : "914201123033363296",
26        "licence_copy" : "0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV-4BBgVwtNkCHO_XXqK5dE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo",
27        "merchant_name" : "李四网络有限公司",
28        "legal_person" : "李四",
29        "company_address" : "广东省深圳市南山区xx路xx号",
30        "licence_valid_date" : "[\\\"2017-10-28\\\",\\\"2037-10-28\\\"]"
31      },
32      "certificate_info" : {
33        "cert_type" : "CERTIFICATE_TYPE_2388",
34        "cert_number" : "111111111111",
35        "cert_copy" : "0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV-4BBgVwtNkCHO_XXqK5dE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo",
36        "merchant_name" : "xx公益团体",
37        "legal_person" : "李四",
38        "company_address" : "广东省深圳市南山区xx路xx号",
39        "cert_valid_date" : "[\\\"2017-10-28\\\",\\\"2037-10-28\\\"]"
40      },
41      "company_prove_copy" : "0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV-4BBgVwtNkCHO_XXqK5dE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo",
42      "assist_prove_info" : {
43        "micro_biz_type" : "MICRO_TYPE_STORE",
44        "store_name" : "大郎烧饼",
45        "store_address_code" : "440305",
46        "store_address" : "广东省深圳市南山区xx大厦x层xxxx室",
47        "store_header_copy" : "0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV-4BBgVwtNkCHO_XXqK5dE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo",
48        "store_indoor_copy" : "0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV-4BBgVwtNkCHO_XXqK5dE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo"
49      },
50      "special_operation_list" : [
51        {
52          "category_id" : 100,
53          "operation_copy_list" : [
54            "0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV-4BBgVwtNkCHO_XXqK5dE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo"
55          ]
56        }
57      ],
58      "finance_institution_info" : {
59        "finance_type" : "BANK_AGENT",
60        "finance_license_pics" : [
61          "0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV-4BBgVwtNkCHO_XXqK5dE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo"
62        ]
63      }
64    },
65    "identification_info" : {
66      "id_holder_type" : "LEGAL",
67      "identification_type" : "IDENTIFICATION_TYPE_IDCARD",
68      "identification_name" : "MZnwEx6zotwIz6ctW2/iQL5z94odwP9sKiF74RPCPztcJOScaXsaGs82HJNU3K+46ndk7pMrENiPDw==",
69      "identification_number" : "ZTnn5dKGCvP4csw4XTLug/+VLB+4R6nxSPQwqSpmPVZtXmye+/3s9O+y32w==",
70      "identification_valid_date" : "[\\\"2017-10-28\\\",\\\"2037-10-28\\\"]",
71      "identification_front_copy" : "0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV-4BBgVwtNkCHO_XXqK5dE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo",
72      "identification_back_copy" : "0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV-4BBgVwtNkCHO_XXqK5dE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo",
73      "authorize_letter_copy" : "0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV-4BBgVwtNkCHO_XXqK5dE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo",
74      "owner" : false,
75      "identification_address" : "pVd1HJ6zyvPedzGaV+X3qtmrq9bb9tPROvwia4ibL+F6mfjbzQIzfb3HHLEjZ4YiR/cJiCrZxnAqi+pjeKIEdkwzXRAI7FUhrfPK3SNjaBTEu9GmsugMIA9r3x887Q+ODuC8HH2nzAn7NGpE/e3yiHgWhk0ps5k5DP/2qIdGdONoDzZelrxCl/NWWNUyB93K9F+jC1JX2IMttdY+aQ6zBlw0xnOiNW6Hzy7UtC+xriudjD5APomty7/mYNxLMpRSvWKIjOv/69bDnuC4EL5Kz4jBHLiCyOb+tI0m2qhZ9evAM+Jv1z0NVa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg=="
76    },
77    "ubo_info" : {
78      "ubo_id_type" : "IDENTIFICATION_TYPE_IDCARD",
79      "ubo_id_card_copy" : "jTpGmxUX3FBWVQ5NJTZvlKX_gdU4cRz7z5NxpnFuAxhBTEO_PvWkfSCJ3zVIn001D8daLC-ehEuo0BJqRTvDujqhThn4ReFxikqJ5YW6zFQ",
80      "ubo_id_card_national" : "jTpGmxUX3FBWVQ5NJTZvlKX_gdU4cRz7z5NxpnFuAxhBTEO_PvWkfSCJ3zVIn001D8daLC-ehEuo0BJqRTvDujqhThn4ReFxikqJ5YW6zFQ",
81      "ubo_id_doc_copy" : "jTpGmxUX3FBWVQ5NJTZvlKX_gdU4cRz7z5NxpnFuAxhBTEO_PvWkfSCJ3zVIn001D8daLC-ehEuo0BJqRTvDujqhThn4ReFxikqJ5YW6zFQ",
82      "ubo_name" : "AOZdYGISxo4y44/Ug4P4TG5xzchG/5IL9DBd+Z0zZXkw==",
83      "ubo_id_number" : "AOZdYGISxo4y44/Ug4P4TG5xzchG/5IL9DBd+Z0zZXkw==",
84      "ubo_id_card_valid_date" : "[\\\"2017-10-28\\\",\\\"2037-10-28\\\"]"
85    },
86    "addition_info" : {
87      "confirm_mchid_list" : [
88        "example_confirm_mchid_list"
89      ]
90    },
91    "ubo_info_list" : [
92      {
93        "ubo_id_doc_type" : "IDENTIFICATION_TYPE_IDCARD",
94        "ubo_id_doc_copy" : "jTpGmxUXqRTvDujqhThn4ReFxikqJ5YW6zFQ",
95        "ubo_id_doc_copy_back" : "jTpGmxUX3FBWVQ5NJTZvvDujqhThn4ReFxikqJ5YW6zFQ",
96        "ubo_id_doc_name" : "AOZdYGISxo4y44/Ug4P4TG5xzchG/5IL9DBd+Z0zZXkw==",
97        "ubo_id_doc_number" : "AOZdYGISxo4y44/Ug4P4TG5xzchG/5IL9DBd+Z0zZXkw==",
98        "ubo_id_doc_address" : "pVd1HJ6zyvPedzGaV+X3qtmrq9bb9tPROvwia4ibL+F6mfjbzQIzfb3HHLEjZ4YiR/cJiCrZxnAqi+pjeKIEdkwzXRAI7FUhrfPK3SNjaBTEu9GmsugMIA9r3x887Q+ODuC8HH2nzAn7NGpE/e3yiHgWhk0ps5k5DP/2qIdGdONoDzZelrxCl/NWWNUyB93K9F+jC1JX2IMttdY+aQ6zBlw0xnOiNW6Hzy7UtC+xriudjD5APomty7/mYNxLMpRSvWKIjOv/69bDnuC4EL5Kz4jBHLiCyOb+tI0m2qhZ9evAM+Jv1z0NVa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg==",
99        "ubo_period_begin" : "2019-06-06",
100        "ubo_period_end" : "2026-06-06"
101      }
102    ]
103  }'
104

应答参数

200 OK

 applyment_id  必填   integer

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

应答示例

200 OK

1{
2  "applyment_id" : 20000000011111
3}
4

 

错误码

公共错误码

状态码

错误码

描述

解决方案

400

PARAM_ERROR

参数错误

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

400

INVALID_REQUEST

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

请参阅 接口规则

401

SIGN_ERROR

验证不通过

请参阅 签名常见问题

500

SYSTEM_ERROR

系统异常,请稍后重试

请稍后重试

业务错误码

状态码

错误码

描述

解决方案

400

INVALID_REQUEST

无效请求

请查看返回的错误信息,根据错误信息进行操作

403

NO_AUTH

商户权限异常

请确认是否已经开通相关权限

 

 

元宝AI
反馈
目录
置顶