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

间连商户开户意愿确认(提交申请单)

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


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

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

注意:

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

接口说明

适用对象:渠道商 从业机构

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

请求方式:POST

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

是否支持幂等:


path 指该参数为路径参数

query 指该参数为URL参数

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


请求参数

参数名 变量 类型[长度限制] 必填 描述
渠道商户号 channel_id string[8, 9] body1、微信支付分配的渠道商户唯一标识
2、当从业机构调用时,该字段必填,需填写从业机构下的渠道商户号
3、当渠道商户调用时,该字段无需填写
示例值:20001111
业务申请编号 business_code string[1, 128] body1、只能由数字、字母或下划线组成
2、服务商自定义的唯一编号。每个编号对应一个申请单
3、建议前缀带上服务商商户号,参看示例值
示例值:1900013511_10000
+ 联系人信息 contact_info object body联系人信息,联系人是商户的联系人,将接收开户信息及日常重要管理信息,请确定联系人为商户法定代表人或经营者再进行操作。如联系人非商户法定代表人或经营者,请提交经办人身份证件和业务办理授权函。
参数名 变量 类型[长度限制] 必填 描述
联系人类型 contact_type string 1、主体为“小微/个人卖家 ”,可选择:
LEGAL:经营者/法人。
2、主体为“个体工商户/企业/政府机关/事业单位/社会组织”,可选择:
LEGAL:经营者/法人、
SUPER:经办人。 (经办人:经商户授权办理微信支付业务的人员)。
示例值:LEGAL
联系人姓名 name string[2,100] 1、若联系人类型为“法人”,则该姓名需与法人姓名一致。
2、若联系人类型为“经办人”,则可填写实际经办人的姓名。
3、长度为2-100个字符
4、前后不能有空格、制表符、换行符
5、不能仅含数字、特殊字符
6、仅能填写数字、英文字母、汉字及特殊字符
7、该字段需进行加密处理,加密方法详见敏感信息加密说明
示例值:pVd1HJ6zyvPedzGaV+X3IdGdbDnuC4Eelw/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
联系人证件号码 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)
示例值:pVd1HJ6zmty7/mYNxLMpRSvMRtelw/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
联系人手机号 mobile string 1、前后不能有空格、制表符、换行符
2、需满足以下任一条件
- 11位数字的手机号码
- 5-20位数字、连字符“-”、加号“+”
3、用于接收微信支付的重要管理信息及日常操作验证码
4、该字段需进行加密处理,加密方法详见敏感信息加密说明
示例值:Oiw4DS+QVyZKC3eTd7CGvGQ1/sidmLm8mdsohkuR9jSiwXyHyVQD1OA1t+6Pb+Xn0q2HAJYLsNjh8O4S1iQgMrFohyaNms4IlDxJzujb9VA==
+ 主体信息 subject_info object body主体信息
参数名 变量 类型[长度限制] 必填 描述
主体类型 subject_type string 主体类型需与营业执照/登记证书上一致,可参考选择主体指引
SUBJECT_TYPE_ENTERPRISE:企业
SUBJECT_TYPE_INSTITUTIONS_CLONED:事业单位
SUBJECT_TYPE_INDIVIDUAL:个体工商户
SUBJECT_TYPE_OTHERS:社会组织
SUBJECT_TYPE_MICRO:小微商户
SUBJECT_TYPE_GOVERNMENT:政府机关
示例值:SUBJECT_TYPE_ENTERPRISE
是否金融机构 is_finance_institution boolean 选填,请根据申请主体的实际情况填写,可参考选择金融机构指引
1、若商户主体是金融机构,则填写:true。
2、若商户主体不是金融机构,则填写:false。
若未传入将默认填写:false。
示例值:true
+ 营业执照信息 business_licence_info object 主体类型为企业/个体户时,营业执照信息必填
参数名 变量 类型[长度限制] 必填 描述
营业执照注册号 licence_number string 1、主体为“个体工商户”时,请填写营业执照上的注册号/统一社会信用代码,格式需满足以下任一条件:
-15位数字
-18位阿拉伯数字或大写英文字母(不得包含英文字母I/O/Z/S/V),并且以9开头
2、主体为“企业”时,请填写营业执照上的注册号/统一社会信用代码,格式如下:
-18位阿拉伯数字或大写英文字母(不得包含英文字母I/O/Z/S/V),并且以9开头
示例值:914201123033363296
营业执照照片 licence_copy string 1、照片应正面拍摄、清晰、四角完整、无反光或遮挡;不得翻拍、截图、镜像、PS;
2、上传彩色照片、彩色扫描件,复印件需加盖公章鲜章。
3、水印仅限于微信支付业务相关。
4、指引与示例可参考【指引文档
5、请填写通过《图片上传API》预先上传图片生成好的MediaID
示例值:0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV-4BBgVwtNkCHO_XXqK5dE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo
商户名称 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、仅能填写数字、英文字母、汉字及特殊字符
示例值:李四
注册地址 company_address string[1, 128] 建议填写营业执照的注册地址
1、长度为4-128个字符
2、前后不能有空格、制表符、换行符
3、不能仅含数字、特殊字符
4、仅能填写数字、英文字母、汉字及特殊字符
5、仅支持utf-8格式
示例值:广东省深圳市南山区xx路xx号
营业执照有效日期 licence_valid_date string 1、日期格式应满足合法的YYYY-MM-DD格式,参见示例值
2、开始时间不能小于1900-01-01
3、若证件有效期为长期,请填写:fovever。
4、开始时间不能大于等于当前日期,结束时间需大于开始时间。
示例值:[\"2017-10-28\",\"2037-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:政府部门下发的其他有效证明文件
示例值:CERTIFICATE_TYPE_2388
证书编号 cert_number string 请输入与所选证书类型相匹配且符合国家标准规范的证书号,其中除政府证明文件外,需满足18位阿拉伯数字或大写英文字母(不得包含英文字母I/O/Z/S/V)
示例值:111111111111
证书照片 cert_copy string 1、照片应正面拍摄、清晰、四角完整、无反光或遮挡;不得翻拍、截图、镜像、PS;
2、上传彩色照片、彩色扫描件,复印件需加盖公章鲜章。
3、水印仅限于微信支付业务相关。
4、指引与示例可参考【指引文档
5、请填写通过《图片上传API》预先上传图片生成好的MediaID
示例值:0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV-4BBgVwtNkCHO_XXqK5dE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo
商户名称 merchant_name string[2,128] 请填写登记证书上的商户名称
1、长度为2-128个字符
2、前后不能有空格、制表符、换行符
3、不能仅含数字、特殊字符
4、仅能填写数字、英文字母、汉字及特殊字符
5、仅支持utf-8格式
示例值:xx公益团体
法人姓名 legal_person string[2,100] 请填写登记证书上的法定代表人姓名
1、长度为2-100个字符
2、前后不能有空格、制表符、换行符
3、不能仅含特殊字符
4、仅能填写数字、英文字母、汉字及特殊字符
示例值:李四
注册地址 company_address string[4, 128] 请填写登记证书的注册地址
1、长度为4-128个字符
2、前后不能有空格、制表符、换行符
3、不能仅含数字、特殊字符
4、仅能填写数字、英文字母、汉字及特殊字符
5、仅支持utf-8格式
示例值:广东省深圳市南山区xx路xx号
证书有效日期 cert_valid_date string 1、日期格式应满足合法的YYYY-MM-DD格式,参见示例值
2、若证件有效期为长期,请填写:fovever。
3、开始时间不能大于等于当前日期,结束时间需大于开始时间。
示例值:["2017-10-28","2037-10-28"]
单位证明函照片 company_prove_copy string 1、主体类型为政府机关/事业单位时,单位证明函照片必填。
2、单位证明函格式参考示例
3、请填写通过《图片上传API》预先上传图片生成好的MediaID
示例值:0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV-4BBgVwtNkCHO_XXqK5dE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo
+ 辅助证明材料信息 assist_prove_info object 主体类型为小微商户时,辅助证明材料信息必填
参数名 变量 类型[长度限制] 必填 描述
小微经营类型 micro_biz_type string
MICRO_TYPE_STORE:门店场所
MICRO_TYPE_MOBILE:流动经营/便民服务
MICRO_TYPE_ONLINE:线上商品/服务交易
示例值:MICRO_TYPE_STORE
门店名称 store_name string[1,50] 1、填写规范:
门店场所:填写门店名称
流动经营/便民服务:填写经营/服务名称
线上商品/服务交易:填写线上店铺名称
2、格式规范:
长度为1-50个字符
前后不能有空格、制表符、换行符
不能仅含数字、特殊字符
仅能填写数字、英文字母、汉字及特殊字符
仅支持utf-8格式
示例值:大郎烧饼
门店省市编码 store_address_code string 1、只能由数字组成
2、详细参见微信支付提供的省市对照表
3、填写规范:
门店场所:填写门店省市编码
流动经营/便民服务:填写经营/服务所在地省市编码
线上商品/服务交易:填写卖家所在地省市编码
示例值:440305
门店地址 store_address string[4,512] 1、填写规范:
门店场所:填写店铺详细地址,具体区/县及街道门牌号或大厦楼层
流动经营/便民服务:填写“无”
线上商品/服务交易:填写电商平台名称
2、格式规范:
长度为4-512个字符
前后不能有空格、制表符、换行符
不能仅含数字、特殊字符
仅能填写数字、英文字母、汉字及特殊字符
仅支持utf-8格式
示例值:广东省深圳市南山区xx大厦x层xxxx室
门店门头照片 store_header_copy string 1、请上传门头正面照片(要求门店招牌、门框完整、清晰、可辨识);若为停车场等无固定门头照片的经营场所,可上传岗亭/出入闸口。具体参考【指引文档】;
2、请填写通过《图片上传API》预先上传图片生成好的MediaID
示例值:0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV-4BBgVwtNkCHO_XXqK5dE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo
店内环境照片 store_indoor_copy string 1、请上传门店内部环境照片(可辨识经营内容)。若为停车场等无固定门头的经营场所,可上传停车场内部照片。具体参考【指引文档】;
2、请填写通过《图片上传API》预先上传图片生成好的MediaID
示例值:0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV-4BBgVwtNkCHO_XXqK5dE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo
+ 经营许可证 special_operation_list array 1、填写特殊行业的经营许可证信息 2、最多填写支持5个行业
参数名 变量 类型[长度限制] 必填 描述
行业类目id category_id int 参看微信支付提供的特殊行业id对照表
示例值:100
行业经营许可证资质照片 operation_copy_list array 1、请根据特殊行业id对照表内指引,仅当所选择的行业为【必填经营许可证】的行业时,才需上传该项资料
2、请填写通过《图片上传API》预先上传图片生成好的MediaID
3、每个行业最多支持5张资质照片
示例值:0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV-4BBgVwtNkCHO_XXqK5dE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo
+ 金融机构许可证 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_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV-4BBgVwtNkCHO_XXqK5dE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo
+ 法人身份信息 identification_info object body法人身份信息
参数名 变量 类型[长度限制] 必填 描述
证件持有人类型 id_holder_type string 条件选填 1. 主体类型为政府机关、事业单位时选传:
(1)若上传的是法人证件,则不需要上传该字段。
(2)若因特殊情况,无法提供法人证件时,可上传经办人。 (经办人:经商户授权办理微信支付业务的人员,授权范围包括但不限于签约,入驻过程需完成账户验证)。
2. 主体类型为企业、个体户、社会组织时,默认为经营者/法人,不需要上传该字段。
LEGAL:经营者/法人
SUPER:经办人
示例值:LEGAL
证件类型 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_TYPE_IDCARD
法定代表人说明函 authorize_letter_copy string 条件选填 1、当证件持有人类型为经办人时,必须上传。其他情况,无需上传。
2、若因特殊情况,无法提供法定代表人证件时,请参照《示例图》打印法定代表人说明函,全部信息需打印,不支持手写商户信息,并加盖公章。
3、可上传1张图片,请填写通过《图片上传API》预先上传图片生成好的MediaID。
示例值:0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV-4BBgVwtNkCHO_XXqK5dE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo
证件姓名 identification_name string[2,100] 条件选填 1、当证件持有人类型为法人时,请填写法人证件上的姓名。其他情况,无需上传。
2、长度为2-100个字符
3、前后不能有空格、制表符、换行符
4、不能仅含数字、特殊字符
5、仅能填写数字、英文字母、汉字及特殊字符
6、该字段需进行加密处理,加密方法详见《敏感信息加密说明》
示例值:pVd1HJ6zyvPedzGaV+X3IdGdbDnuC4Eelw/wDa4SzfeespQO/0kjiwfqdfg==
证件号码 identification_number string 条件选填 1、当证件持有人类型为法人时,请填写法人证件上的证件号码。其他情况,无需上传。
2、可传身份证、来往内地通行证、来往大陆通行证、护照等证件号码,号码规范如下:
身份证(限中国大陆居民):17位数字+1位数字|X
护照(限境外人士):4-15位 数字|字母|连字符
中国香港居民--来往内地通行证:H/h开头+8或10位数字/字母
中国澳门居民--来往内地通行证:M/m开头+8或10位数字/字母
中国台湾居民--来往大陆通行证:8位数字或10位数字
外国人居留证:15位 数字|字母
港澳居住证/台湾居住证:17位数字+1位数字|X
3、该字段需进行加密处理,加密方法详见《敏感信息加密说明》
示例值:pVd1HJ6zmty7/mYNxLMpRSvMRtelw/wDa4SzfeespQO/0kjiwfqdfg==
证件有效日期 identification_valid_date string 条件选填 1、日期格式应满足合法的YYYY-MM-DD格式,参见示例值
2、若证件有效期为长期,请填写:fovever。
3、开始时间不能大于等于当前日期,结束时间需大于开始时间。
示例值:[\"2017-10-28\",\"forever\"]
证件居住地址 identification_address string[4,128] 条件选填 1、主体类型为企业时,需要填写。其他主体类型,无需上传。
2、请按照身份证住址填写,如广东省深圳市南山区xx路xx号xx室
3、长度为4-128个字符
4、前后不能有空格、制表符、换行符
5、不能仅含数字、特殊字符
6、仅能填写数字、英文字母、汉字及特殊字符
7、仅支持utf-8格式
8、该字段需进行加密处理,加密方法详见《敏感信息加密说明》
示例值:pVd1HJ6zyvPedzGaV+X3qtmrq9bb9tPROvwia4ib0NVa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg==
证件正面照片 identification_front_copy string 条件选填 当证件持有人类型为法人时,请上传法人证件的正面照片。其他情况,无需上传。
1、证件类型不为“身份证”"时,上传证件正面照片;若法人证件类型为身份证,请上传人像面照片
2、正面拍摄、清晰、四角完整、无反光或遮挡;不得翻拍、截图、镜像、PS。
3、请上传彩色照片or彩色扫描件,复印件需加盖公章鲜章,可添加“微信支付”相关水印(如微信支付认证),见【指引文档
4、可上传1张图片,请填写通过《图片上传API》预先上传图片生成好的MediaID
示例值:0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV-4BBgVwtNkCHO_XXqK5dE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo
证件反面照片 identification_back_copy string 条件选填 当证件持有人类型为法人时,请上传法人证件的反面照片。其他情况,无需上传。
1、若证件类型为往来通行证、外国人居留证、港澳居住证、台湾居住证时,上传证件反面照片。
2、若证件类型为护照,无需上传反面照片。
3、若法人证件类型为身份证,请上传国徽面照片
4、正面拍摄、清晰、四角完整、无反光或遮挡;不得翻拍、截图、镜像、PS。
5、请上传彩色照片or彩色扫描件,复印件需加盖公章鲜章,可添加“微信支付”相关水印(如微信支付认证),见【指引文档
6、可上传1张图片,请填写通过《图片上传API》预先上传图片生成好的MediaID
示例值:0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV-4BBgVwtNkCHO_XXqK5dE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo
经营者/法人是否为受益人 owner boolean 条件选填 主体类型为企业时,需要填写:
1、若经营者/法人是最终受益人,则填写:true。
2、若经营者/法人不是最终受益人,则填写:false。
示例值:false
+ 最终受益人信息列表(UBO) ubo_info_list array 条件选填 body仅企业需要填写。
若经营者/法人不是最终受益所有人,则需提填写受益所有人信息,最多上传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[2,100] 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+X3qtmrq9bb9tPROvwia4ibL0NVa8MRtelw/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
+ 补充材料 addition_info object body根据实际审核情况,额外要求商家提供指定的补充资料。
参数名 变量 类型[长度限制] 必填 描述
待确认商户号列表 confirm_mchid_list array 1、若有填写,创建申请单后,商家可扫码打开申请单的二维码,提前完成授权商户号; 详细流程请看产品指引
2、商户号填写要求如下:
(1)请确保商户号全称与申请单主体名称一致;
(2)如特殊行业商户,请确保商户号结算规则ID与经营许可证匹配;
(3)一个申请单最多可以提交20个商户号。
3、校验报错说明
(1)提交申请单不满足上述要求,则无法创建申请单,返回报错格式参考如下。
"123456789:待确认商户号不存在,请检查待确认商户号是否正确;1234567:查询待确认商户信息发生系统失败,请稍后再试[269795842];999990017:待确认商户号不是当前从业机构的特约商户"
(2)若服务商需实现剔除报错商户号逻辑,建议根据格式(如标点符号)筛选商户号,不根据报错文案筛选(因后续可能调整文案)。
示例值:20001113

请求示例


{
	"channel_id": "20001111",
	"business_code": "1900013511_10000",
	"contact_info": {
		"name": "X/8KWvNPULFmbdM1oU/w58gd1Jv75z+qStfT018ms25FGlVGMR2An5yGhVEHTp509zscN9PKjhi+Q+VBGpy2ei6HY5DbXU3m74Q96IpHw7w==",
		"mobile": "Oiw4DS+QVyZKC3eTd7CGvGQ1/sidmLm8mdsohkuR9jSiwXyHyVQD1OA1t+6Pb+Xn0q2HAJYLsNjh8O4S1iQgMrFohyaNms4IlDxJzujb9VA==",
		"id_card_number": "rjbq82xBwMixDGAviRajNvdDah00E7jIA/jtnj+Wk5jjM+yyjn9BU8qUBZga+mKqQ==",
		"contact_type": "LEGAL",
		"contact_id_doc_type": "IDENTIFICATION_TYPE_IDCARD",
		"contact_id_doc_copy": "jTpGmxUXqRTvDujqhThn4ReFxikqJ5YW6zFQ",
		"contact_id_doc_copy_back": "jTpGmxUX3FBWVQ5NJTZvvDujqhThn4ReFxikqJ5YW6zFQ",
		"contact_period_begin": "2019-06-06",
		"contact_period_end": "2026-06-06"
	},
	"subject_info": {
		"subject_type": "SUBJECT_TYPE_ENTERPRISE",
		"is_finance_institution": false,
		"business_licence_info": {
			"licence_number": "914201123033363296",
			"licence_copy": "0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV-4BBgVwtNkCHO_XXqK5dE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo",
			"merchant_name": "李四网络有限公司",
			"legal_person": "李四",
			"company_address": "广东省深圳市南山区xx路xx号",
			"licence_valid_date": "[\"2017-10-28\",\"2037-10-28\"]"
		},
		"certificate_info": {
			"cert_type": "CERTIFICATE_TYPE_2388",
			"cert_number": "111111111111",
			"cert_copy": "0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV-4BBgVwtNkCHO_XXqK5dE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo",
			"merchant_name": "xx公益团体",
			"legal_person": "李四",
			"company_address": "广东省深圳市南山区xx路xx号",
			"cert_valid_date": "[\"2017-10-28\",\"2037-10-28\"]"
		},
		"company_prove_copy": "0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV-4BBgVwtNkCHO_XXqK5dE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo",
		"special_operation_list": [{
			"category_id": 100,
			"operation_copy_list": [
				"0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV-4BBgVwtNkCHO_XXqK5dE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo"
			]
		}],
		"finance_institution_info": {
			"finance_type": "BANK_AGENT",
			"finance_license_pics": [
				"0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV-4BBgVwtNkCHO_XXqK5dE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo"
			]
		}
	},
	"identification_info": {
		"id_holder_type": "LEGAL",
		"identification_type": "IDENTIFICATION_TYPE_IDCARD",
		"identification_name": "X/8KWvNPULFmbdM1oU/w58gd1Jv75z+qStfT018ms25FGlVGMR2An5yGhVEHTp509zscN9PKjhi+Q+VBGpy2ei6HY5DbXU3m74Q96IpHw7w==",
		"identification_number": "rjbq82xBwMixDGAviRajNvdDah00E7jIA/jtnj+Wk5jjM+yyjn9BU8qUBZga+mKqQ==",
		"identification_valid_date": "[\"2017-10-28\",\"forever\"]",
		"identification_address": "pVd1HJ6zyvPedzGaV+X3qtmrq9bb9tPROvwia4ib0NVa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg==",
		"identification_front_copy": "0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV-4BBgVwtNkCHO_XXqK5dE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo",
		"identification_back_copy": "0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV-4BBgVwtNkCHO_XXqK5dE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo",
		"owner": false
	},
	"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"
	}]
}

{
JAVA示例代码
}

返回参数

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

返回示例


{
  "applyment_id": 20000000011111
}
                    

http://2323weixin.qq.com
                    

错误码公共错误码

状态码 错误码 描述 解决方案
500 SYSTEMERROR 系统错误 系统异常,请使用相同参数稍后重新调用
400 PARAM_ERROR 参数错误 请使用正确的参数重新调用
400 INVALID_REQUEST 无效请求 请查看返回的错误信息,根据错误信息进行操作
403 NOAUTH 商户权限异常 请确认是否已经开通相关权限


技术咨询

文档反馈