# 提交支付资质
该接口会复用小程序信息用于进件,包括不限于: 营业执照信息
- 营业执照注册号,对应小程序认证的营业执照上的注册号/统一社会信用代码,只支持三证合一
- 商户名称,对应小程序主体名称
超级管理员信息
- 超级管理员身份证件号码,对应小程序管理员身份证
- 超级管理员姓名,对应小程序管理员姓名
店铺信息
- 店铺名称,对应小程序昵称
- 店铺二维码,对应小程序太阳码
- 小程序APPID,对应小程序APPID
如果出现管理员信息或者主体相关的问题,请到MP平台修改小程序信息。 主体修正:小程序主体修正流程可以参考以下指引:请登录公众号后台mp.weixin.qq.com提交申请,操作入口:设置—基本设置—主体信息—名称修正,按照页面提示准备好资料上传提交即可,审核时间为3-7个工作日。 管理员修改:小程序管理员修改参考以下路径:请登录公众号后台mp.weixin.qq.com提交申请,操作入口:成员管理-管理员-修改,按照页面提示提交即可。
# 微信支付进件规则更新
未升级的服务商可以用旧的协议,约定:
- 旧协议:不传
account_info
- 新协议:传
account_info
# 法人证件部分
- 企业身份证证件
id_card_info
、其他证件id_doc_info
新增居住地址,需要跟身份证保持一致 - 身份证证件
id_card_info
、非身份证证件id_doc_info
新增有效期开始时间
# 超管部分
- 非个人店需要让商家选择超级管理员类型,选项一:经营者/法人,选项二:经办人
- 身份证有效期开始和结束时间
- 身份证照片正反面
- 业务办理授权函
# 结算账户部分
- 结算账户信息必填,开户名称默认与非个体工商户的营业执照上的商户名称(或个体工商户经营者姓名)一致
# 接口调用请求说明
http请求方式:POST
https://api.weixin.qq.com/shop/wxpay/apply?access_token=xxxxxxxxx
# 请求参数示例
{
"organization_type": 2,
"business_license_info": {
"legal_person": "于先生",
"wxa_business_license_copy": {
"media_id": "wxashop_7q4XAkTjOdJBzsq2NwTN1LziRMTSlnabAEVD/lVYaan3vT2wzkOEconCrv/nMfo0SEDkD3Q6lvhTB6437AHymw==",
"name": "IwWfGT9fZ7UJMGSxXYld7piyITwdoLJKHow.jpg",
"pay_media_id": "jZe4zIHlHd4W-2hdRc9YJHOWaXLu-jeT_HPQ2pkR7CwW9swozIN_RtibXPsmLtNaiUH0fhrujTjVL4Noiw9PCYq0aSg32p-OwvbzSnK-k-Q"
}
},
"id_card_info": {
"id_card_name": "李先生",
"id_card_number": "xxxxxxxxxxx",
"id_card_valid_time": "yyyy-MM-dd",
"wxa_id_card_copy": {
"media_id": "wxashop_vjw8knXy8qJcbOWkxC3IfJktuHEDhKgnMwEguqzO68ROybm4ul+DVFu8Vrgo3sgjSEDkD3Q6lvhTB6437AHymw==",
"pay_media_id": "jZe4zIHlHd4W-2hdRc9YJO90E_1rLUJioHWZC0vHhO-FjK3zAnTiUnG61cpiYMx9dbzI7NdFIg55nmherZnCrZn3GkEPfCJUpg59A-dW1Ts"
},
"wxa_id_card_national": {
"media_id": "wxashop_ndDiQPgJVT0HMZgCIM+pYe27Wyxg3iuv/yo/2nB9BOtY2aubumDb+Dy7PkCZscCuSEDkD3Q6lvhTB6437AHymw==",
"pay_media_id": "jZe4zIHlHd4W-2hdRc9YJM4gvRIV8V5a4iEc8Oem02ywFfV6Rb4RJhbNvSEYevRaYnkFp0QEoEKA4cMoDvGfBzsM5WDjocZv96ZzFeb0arc"
}
},
"contact_info": {
"contact_type": "65",
"contact_email": "wxg@tencent.com",
"mobile_phone": "15521050856"
},
"merchant_shortname": "交易组件",
"account_info": {
"account_bank": "工商银行",
"account_name": "AOZdYGISxo4y44/UgZ69bdu9X+tfMUJ9dl+LetjM45/zMbrYu+wWZ8gn4CTdo+D/m9MrPg+V4sm73oxqdQu/hj7aWyDl45IL9DBd+Z0zZXkw==",
"account_number": "d+xT+MQCvrLHUVDWv/8MR/dB7TkXM2YYZlokmXzFsWs35NXUot7C0NcxIrUF5FnxqCJHkNgKtxa6RxEYyba1+VBRLnqKGYQE8ZRGYoeorwC+w==",
"bank_account_type": "75",
"bank_address_code": "110000",
"bank_branch_id": "402713354941"
}
}
# 回包示例
{
"errcode": 0,
"errmsg":"ok"
}
# 请求参数说明
参数 | 类型 | 是否必填 | 说明 |
---|---|---|---|
organization_type | string | 是 | 主体类型,只支持两种,4:个体工商户,营业执照上的主体类型一般为个体户、个体工商户、个体经营。 2:企业,营业执照上的主体类型一般为有限公司、有限责任公司。 |
business_license_info | BusinessLicenseInfo | 是 | 营业执照/登记证书信息 |
id_doc_type | enum | 是 | 经营者/法人证件类型,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:台湾居民证 |
id_card_info | IdCardInfo | 否 | 经营者/法人身份证,IDENTIFICATION_TYPE_MAINLAND_IDCARD必填 |
id_doc_info | IdDocInfo | 否 | 经营者/法人其他类型证件信息,证件类型为“来往内地通行证、来往大陆通行证、护照”时填写。 |
contact_info | ContactInfo | 是 | 超级管员信息 请填写店铺的超级管理员信息。超级管理员需在开户后进行签约,并可接收日常重要管理信息和进行资金操作,请确定其为商户法定代表人或负责人。 |
qualifications | Qualifications | 否 | 特殊资质 1、根据商户经营业务要求提供相关资质,详情查看《行业对应特殊资质》。 2、请提供为“申请商家主体”所属的特殊资质,可授权使用总公司/分公司的特殊资质; 3、最多可上传5张照片,请填写通过图片上传接口预先上传图片生成好的MediaID 。 |
business_addition_pics | BusinessAdditionPics | 否 | 补充材料 |
business_addition_desc | string | 否 | 补充描述 |
account_info | AccountInfo | 是 [新增] | 结算账户信息 |
merchant_shortname | string | 是 | 商户简称,UTF-8格式,中文占3个字节,即最多21个汉字长度。将在支付完成页向买家展示,需与商家的实际售卖商品相符 。 示例值:腾讯 |
# BusinessLicenseInfo
参数 | 类型 | 是否必填 | 说明 |
---|---|---|---|
wxa_business_license_copy | PicFile | 是 | 营业执照扫描件,图片要求: (1)请上传证件的彩色扫描件或彩色数码拍摄件,黑白复印件需加盖公章(公章信息需完整) 。 (2)不得添加无关水印(非微信支付商户申请用途的其他水印)。 (3)需提供证件的正面拍摄件,完整、照面信息清晰可见。信息不清晰、扭曲、压缩变形、反光、不完整均不接受。 (4)不接受二次剪裁、翻拍、PS的证件照片。 |
legal_person | string | 是 | 经营者/法定代表人姓名,请填写证件的经营者/法定代表人姓名。示例值:张三 |
# PicFile
参数 | 类型 | 是否必填 | 说明 |
---|---|---|---|
media_id | string | 是 | media_id,此处通过上传图片接口获得传入内容 |
pay_media_id | string | 是 | 支付media_id,此处通过上传图片接口获得传入内容 |
- 注:接口指定resp_type=2,会同时返回media_id和pay_media_id,图片必须2MB以下
# IdCardInfo
参数 | 类型 | 是否必填 | 说明 |
---|---|---|---|
wxa_id_card_copy | PicFile | 是 | 人像面照片,1、证件类型为“身份证”时,上传身份证人像面照片。2、请上传彩色照片or彩色扫描件or复印件(需加盖公章鲜章),可添加“微信支付”相关水印(如微信支付认证)。 |
wxa_id_card_national | PicFile | 是 | 国徽面照片,1、证件类型为“身份证”时,上传身份证国徽面照片。2、请上传彩色照片or彩色扫描件or复印件(需加盖公章鲜章),可添加“微信支付”相关水印(如微信支付认证)。 |
id_card_name | string | 是 | 身份证姓名,请填写经营者/法定代表人对应身份证的姓名,2~30个中文字符、英文字符、符号。 |
id_card_number | string | 是 | 身份证号码,请填写经营者/法定代表人对应身份证的号码 |
id_card_valid_time | string | 是 | 身份证结束时间,1、请填写身份证有效期的结束时间,注意参照示例中的格式。 2、若证件有效期为长期,请填写:长期。 3、证件有效期需大于60天。 示例值:2026-06-06 |
id_card_valid_time_begin | string | 是 [新增] | 身份证开始时间,1、请按照示例值填写,若证件有效期为长期,请填写:长期。 2、结束时间大于开始时间。 示例值:2026-06-06 |
id_card_address | string | 否 [新增] | 身份证居住地址,1、主体类型为企业时,需要填写。其他主体类型,无需上传。 2、请按照身份证住址填写,如广东省深圳市南山区xx路xx号xx室 |
# IdDocInfo
参数 | 类型 | 是否必填 | 说明 |
---|---|---|---|
id_doc_name | string | 是 | 证件姓名,请填写经营者/法人姓名。 |
id_doc_number | string | 是 | 证件号码,7~11位 数字 |
wxa_id_doc_copy | PicFile | 是 | 证件正面照片 1、证件类型不为“身份证”时,上传证件正面照片。 |
wxa_id_doc_copy_back | PicFile | 否 | 证件反面照片 |
id_doc_address | string | 否 [新增] | 证件居住地址,1、主体类型为企业时,需要填写。其他主体类型,无需上传。 2、请按照证件上住址填写,若证件上无住址则按照实际住址填写,如广东省深圳市南山区xx路xx号xx室。 |
doc_period_begin | string | 是 [新增] | 证件开始日期,1、请按照示例值填写 2、结束时间大于开始时间 示例值:2019-06-06 |
doc_period_end | string | 是 | 证件结束日期,1、请按照示例值填写,若证件有效期为长期,请填写:长期。 2、结束时间大于开始时间。 示例值:2020-01-02 |
# ContactInfo
参数 | 类型 | 是否必填 | 说明 |
---|---|---|---|
contact_type | string | 是 | 超级管理员类型,可选择:65-经营者/法人、66- 经办人。 (经办人:经商户授权办理微信支付业务的人员)。 |
contact_email | string | 是 | 超级管理员邮箱,1、用于接收微信支付的开户邮件及日常业务通知。 2、需要带@,遵循邮箱格式校验 。 |
mobile_phone | string | 是 | 超级管理员手机,请填写管理员的手机号,11位数字, 用于接收微信支付的重要管理信息及日常操作验证码 |
contact_id_doc_type | string | 是 [新增] | 超级管理员证件类型,固定 IDENTIFICATION_TYPE_MAINLAND_IDCARD |
wxa_contact_id_doc_copy | PicFile | 否 [新增] | 超级管理员证件正面照片,当超级管理员类型是经办人时,请上传超级管理员证件的正面照片。 |
wxa_contact_id_doc_copy_back | PicFile | 否 [新增] | 超级管理员证件反面照片,当超级管理员类型是经办人时,请上传超级管理员证件的反面照片。 |
contact_id_doc_period_begin | string | 否 [新增] | 超级管理员证件有效期开始时间,1、当超级管理员类型是经办人时,请上传证件有效期开始时间。 2、请按照示例值填写。 3、结束时间大于开始时间。 示例值:2019-06-06 |
contact_id_doc_period_end | string | 否 [新增] | 超级管理员证件有效期开始时间,1、当超级管理员类型是经办人时,请上传证件有效期开始时间。 2、请按照示例值填写。 3、结束时间大于开始时间。 示例值:2019-06-06 |
wxa_business_authorization_letter | PicFile | 否 [新增] | 业务办理授权函,1、当超级管理员类型是经办人时,请上传业务办理授权函。 2、请参照示例图打印业务办理授权函,全部信息需打印,不支持手写商户信息,并加盖公章。 |
# Qualifications
参数 | 类型 | 是否必填 | 说明 |
---|---|---|---|
pic_file_list | PicFile[] | 是 | 图片media id数组,每项的格式同pic_file |
# BusinessAdditionPics
参数 | 类型 | 是否必填 | 说明 |
---|---|---|---|
pic_file_list | PicFile[] | 是 | 图片media id数组,每项的格式同pic_file |
# AccountInfo
参数 | 类型 | 是否必填 | 说明 |
---|---|---|---|
bank_account_type | string | 是 | 账户类型,1、若主体为企业,可填写:74-对公账户。 3、若主体为个体工商户,可填写:74-对公账户、75-对私账户。 示例值:75 |
account_bank | string | 是 | 开户银行,对公银行调用:查询支持对公业务的银行列表API。 示例值:工商银行 |
account_name | string | 是 | 开户名称,1、选择经营者个人银行卡时,开户名称必须与身份证姓名一致。 2、选择对公账户时,开户名称必须与营业执照上的“商户名称”一致。 |
bank_address_code | string | 是 | 开户银行省市编码,至少精确到市,详细参见省编号API市编号API。 |
bank_branch_id | string | 否 | 开户银行联行号,1、根据开户银行查询接口中的“是否需要填写支行”判断是否需要填写。如为其他银行,开户银行全称(含支行)和开户银行联行号二选一。 2、详细需调用查询支行列表API查看查询结果。 示例值:402713354941 |
bank_name | string | 否 | 开户银行全称 (含支行) 1、根据开户银行查询接口中的“是否需要填写支行”判断是否需要填写。如为其他银行,开户银行全称(含支行)和开户银行联行号二选一。 2、详细需调用查询支行列表API查看查询结果。 示例值:中国工商银行股份有限公司北京市分行营业部 |
account_number | string | 是 | 银行账号,数字,长度遵循系统支持的对公/对私卡号长度要求表。 |
# 回包参数说明
参数 | 类型 | 说明 |
---|---|---|
errcode | number | |
errmsg | string |