提交支付资质 | 微信开放文档

# 提交支付资质

2022-06-30日后需要使用新版本提交资质：
新旧版本区别：
1.新版本 applyment_version 需要设为1
2.settle_acct_info 结算账户信息必填
3.id_card_info.address 身份证住址必填
4.若超管为经办人则超管需要补充身份证件, super_administrator_info 结构下 contact_id_doc_type,contact_id_doc_copy,contact_id_doc_copy_back,contact_id_doc_period_begin,contact_id_doc_period_end,business_authorization_letter 必填

# 接口调用请求说明

http请求方式：POST
https://api.weixin.qq.com/product/register/submit_merchantinfo?access_token=xxxxxxxxx

# 请求参数说明

参数	类型	是否必填	说明
appid	string	是
subject_type	string	是	主体类型 "4"：个体工商户，营业执照上的主体类型一般为个体户、个体工商户、个体经营。 "2"：企业，营业执照上的主体类型一般为有限公司、有限责任公司。
busi_license	object	是	营业执照/登记证书信息
organization_code_info	object	否	组织机构代码证信息
id_card_info	object	是	身份证
super_administrator_info	object	是	超级管理员信息请填写店铺的超级管理员信息。超级管理员需在开户后进行签约，并可接收日常重要管理信息和进行资金操作，请确定其为商户法定代表人或负责人。
merchant_shortname	string	是	商户简称 UTF-8格式，中文占3个字节，即最多16个汉字长度。将在支付完成页向买家展示，需与商家的实际售卖商品相符。示例值：腾讯
special_qualification	object	否	特殊资质 1、根据商户经营业务要求提供相关资质，详情查看《行业对应特殊资质》。 2、请提供为“申请商家主体”所属的特殊资质，可授权使用总公司/分公司的特殊资质； 3、最多可上传5张照片，请填写通过图片上传接口预先上传图片生成好的MediaID 。
supplementary_material	object	否	补充材料
supplementary_desc	string	否	补充描述
settle_acct_info	object	是	结算账户信息
applyment_version	number	否	支付资质版本号，默认为0， 2022-06-30 日后必须全部填1

# busi_license

参数	类型	是否必填	说明
license_type	number	是	营业执照类型 1:三证合一 2: 普通营业执照
pic_file	object	是	营业执照图片
registration_num	string	是	请填写营业执照上的注册号/统一社会信用代码，须为15位数字或18位数字大写字母。示例值：123456789012345678 特殊规则：长度最小15个字节
merchant_name	string	是	1、请填写营业执照/登记证书的商家名称，2~110个字符，支持括号 2、个体工商户/党政、机关及事业单位，不能以“公司”结尾。 3、个体工商户，若营业执照上商户名称为空或为“无”，请填写"个体户+经营者姓名"，如“个体户张三” 。示例值：腾讯科技有限公司
legal_representative	string	是	请填写证件的经营者/法定代表人姓名。示例值：张三
registered_addrs	string	否	注册地址
start_date	string	是	注册日期，格式：2014-01-01
end_date	string	是	结束有效期，格式：2014-01-01 1、若证件有效期为长期，请填写：长期。 2、结束时间需大于开始时间。 3、有效期必须大于60天，即结束时间距当前时间需超过60天。

# pic_file

参数	类型	是否必填	说明
media_id	string	是	media_id，此处通过上传图片接口获得传入内容
pay_media_id	string	是	支付media_id，此处通过上传图片接口获得传入内容

# organization_code_info

参数	类型	是否必填	说明
pic_file	object	是	组织结构代码证图片
organization_code	string	是	1、请填写组织机构代码证上的组织机构代码。 2、可填写9或10位数字\字母\连字符。示例值：12345679-A
start_date	string	是	注册日期，格式：2014-01-01
end_date	string	是	结束有效期，格式：2014-01-01 1、若证件有效期为长期，请填写：长期。 2、结束时间需大于开始时间。 3、有效期必须大于60天，即结束时间距当前时间需超过60天。

# id_card_info

参数	类型	是否必填	说明
portrait_pic_file	object	是	人像面照片，格式同pic_file
nation_pic_file	object	是	国徽面照片，格式同pic_file
id_card_name	string	是	请填写经营者/法定代表人对应身份证的姓名，2~30个中文字符、英文字符、符号。
id_card_number	string	是	请填写经营者/法定代表人对应身份证的号码
start_date	string	是	注册日期，格式：2014-01-01
end_date	string	是	结束有效期，格式：2014-01-01 1、若证件有效期为长期，请填写：长期。 2、结束时间需大于开始时间。 3、有效期必须大于60天，即结束时间距当前时间需超过60天。
address	string	是	身份证居住地

# super_administrator_info

参数	类型	是否必填	说明
type	string	是	个体工商户/企业/党政、机关及事业单位/其他组织，可选择：65-法人/经营者、66- 负责人。（负责人：经商户授权办理微信支付业务的人员，授权范围包括但不限于签约，入驻过程需完成账户验证）。示例值：65
name	string	是	1、若管理员类型为“法人”，则该姓名需与法人身份证姓名一致。 2、若管理员类型为“经办人”，则可填写实际经办人的姓名。
id_card_number	number	是	1、若管理员类型为法人，则该身份证号码需与法人身份证号码一致。若管理员类型为经办人，则可填写实际经办人的身份证号码。 2、可传身份证、来往内地通行证、来往大陆通行证、护照等证件号码。 3、超级管理员签约时，校验微信号绑定的银行卡实名信息，是否与该证件号码一致。
phone	number	是	请填写管理员的手机号，11位数字，用于接收微信支付的重要管理信息及日常操作验证码。
mail	string	是	1、用于接收微信支付的开户邮件及日常业务通知。 2、需要带@，遵循邮箱格式校验。
contact_id_doc_type	string	否	证件类型，type = 66 时必填，目前只支持身份证，填写 "IDENTIFICATION_TYPE_MAINLAND_IDCARD"
contact_id_doc_copy	object	否	证件正面照片， type = 66 时必填
contact_id_doc_copy_back	object	否	证件反面照片, type = 66 时必填
contact_id_doc_period_begin	string	否	证件开始时间,type = 66 时必填
contact_id_doc_period_end	string	否	证件结束时间,type = 66 时必填
business_authorization_letter	object	否	业务办理授权函图片，type = 66 时必填

# special_qualification

参数	类型	是否必填	说明
pic_file_list	Array<string>	是	图片media id数组，每项的格式同pic_file

# supplementary_material

参数	类型	是否必填	说明
pic_file_list	Array<string>	是	图片media id数组，每项的格式同pic_file

# settle_acct_info

参数	类型	是否必填	说明
acct_type	string	是	账户类型：74对公账户；75对私账户
bank	string	是	开户银行开户银行对照表
name	string	是	开户名称,对私需要与身份证一致，对公需要与营业执照上的“商户名称一致”
province_city_code	string	是	省市编码 ,需至少精确到市，详细参见省市区编号对照表
full_name	string	否	开户银行全称（含支行）开户银行全称（含支行）对照表
bank_account_no	string	是	银行账号

# 请求参数示例

{
    "appid": "xxx",
    "subject_type": "营业执照/登记证书信息",
    "busi_license": 
    {
        "license_type": 1,
        "pic_file": 
        {
            "media_id":   "xlvjalsdhgas",
            "pay_media_id": "asdgasvdadfa"
        }, 
        "registration_num": "证件注册号",
        "merchant_name": "商户名称",
        "legal_representative": "法定代表人",
        "registered_addrs": "注册地址",
        "start_date": "注册日期",
        "end_date": "有效期至"
    },
    "organization_code_info": 
    {
        "pic_file": 
        {
            "media_id":   "xlvjalsdhgas",
            "pay_media_id": "asdgasvdadfa"
        }, 
        "organization_code": "组织机构代码",
        "start_date": "注册日期",
        "end_date": "有效期至"
    },
    "id_card_info": 
    {
        "portrait_pic_file"： 
        {
            "media_id":   "xlvjalsdhgas",
            "pay_media_id": "asdgasvdadfa"
        }, 
        "nation_pic_file"： 
        {
            "media_id":   "xlvjalsdhgas",
            "pay_media_id": "asdgasvdadfa"
        }, 
        "id_card_name": "张三",
        "id_card_number": "121321412",
        "start_date": "注册日期",
        "end_date": "有效期至"
    },
    "super_administrator_info":
    {
        "type": "类型",
        "name": "姓名",
        "id_card_number": "身份证件号码",
        "phone": "手机号",
        "mail": "邮箱"
    },
    "merchant_shortname": "商户简称",
    "special_qualification":
    {
        "pic_file_list":
        [
            {
                "media_id":   "xlvjalsdhgas",
                "pay_media_id": "asdgasvdadfa"
            }
        ]
    },
    "supplementary_material":
    {
        "pic_file_list":
        [
            {
                "media_id":   "xlvjalsdhgas",
                "pay_media_id": "asdgasvdadfa"
            }
        ]
    },
    "supplementary_desc": "补充描述"
}

# 回包参数说明

参数	类型	说明
errcode	number	错误码
errmsg	string	错误信息

# 回包示例

{
    "errcode": 0,
    "errmsg":"ok"
}

# 返回码

返回码	错误类型
-1	系统异常
-2	token太长
400	参数错误,请使用正确的参数重新调用
429	请降低调用频率
10005	实名校验失败，身份证、姓名和微信号实名不匹配