# 商户号进件

接口应在服务器端调用，不可在前端（小程序、网页、APP等）直接调用，具体可参考接口调用指南。

接口英文名：retailRegisterMch

可以通过 api 方式进行商户号的进件。

# 1. 调用方式

# HTTPS 调用

POST https://api.weixin.qq.com/retail/B2b/retailregistermch?access_token=ACCESS_TOKEN

# 云调用

本接口不支持云调用。

# 第三方调用

本接口支持第三方平台代商家调用。
该接口所属的权限集 id 为：158
服务商获得其中之一权限集授权后，可通过使用 authorizer_access_token 代商家进行调用，具体可查看第三方调用说明文档。

# 2. 请求参数

# 查询参数 `Query String Parameters`

参数名	类型	必填	示例	说明
access_token	string	是	ACCESS_TOKEN	接口调用凭证，可使用 access_token、authorizer_access_token

# 请求体 `Request Payload`

参数名	类型	必填	说明
id_doc_type_num	number	是	法人证件类型。 0-默认即大陆身份证，1-大陆身份证，2-其他国家或地区居民护照，3-中国香港居民来往内地通行证，4-中国澳门居民–来往内地通行证，5-中国台湾居民–来往大陆通行证，6-外国人居留证（仅开通微信支付时支持），7-港澳居民证（仅开通微信支付时支持），8-台湾居民证（仅开通微信支付时支持） [ 注：当前仅微信支付方式支持后三种证件类型，即仅当 open_type = 0 时, id_doc_type_num 可选填 6、7、8 ]
id_card_info	object	否	经营者/法人身份证信息。当id_doc_type_num为0和1时必填
id_doc_info	object	否	经营者/法人其他类型证件信息。当id_doc_type_num不为0和1时必填
account_info	object	是	结算银行账户
contact_info	object	是	超级管理员信息
business_license	object	是	营业执照
merchant_shortname	string	是	商户名缩写
organization_type	boolean	是	主体类型。个体户-0，企业-1
qualification	object	是	行业特殊资质资料。
business_addition_desc	string	否	补充说明。示例值：特殊情况，说明原因
business_addition_pics	string	否	补充材料材料图片id可通过上传商户图片API获取获取。如有多张图片，请拼接成一张后上传。
open_type	number	是	开通支付方式。只开通微信支付-0 同时开通微信支付和银行转账-1
ext_register_info	object	是	补充信息
client_ip	string	是	商户 ip 地址。支持 iPv4 和 iPv6

# Body.id_card_info `Object Payload`

经营者/法人身份证信息。当id_doc_type_num为0和1时必填

参数名	类型	必填	说明
id_card_copy	string	是	身份证人像面照片id, 通过上传商户图片API获取
id_card_national	string	是	身份证国徽面照片id, 通过上传商户图片API获取
id_card_name	string	是	身份证姓名
id_card_number	string	是	身份证号码
id_card_valid_time	string	是	身份证有效期限, 格式如"2026-06-06"、"长期"
id_card_address	string	是	身份证地址
id_card_valid_time_begin	string	是	身份证有效期开始日期, 格式如"2026-06-06"

# Body.id_doc_info `Object Payload`

经营者/法人其他类型证件信息。当id_doc_type_num不为0和1时必填

参数名	类型	必填	说明
id_doc_name	string	是	证件姓名
id_doc_number	string	是	证件号码
id_doc_copy	string	是	证件正面照片，通过上传商户图片API获取
doc_period_end	string	是	证件结束日期，格式如"2022-06-06"、"长期"
doc_period_begin	string	是	证件有效期开始时间，格式如"2022-06-06"
id_doc_address	string	是	证件居住地址
id_doc_copy_back	string	是	证件反面照片，通过上传商户图片API获取

# Body.account_info `Object Payload`

结算银行账户

参数名	类型	必填	说明
bank_account_type	string	是	账户类型，若主体为企业/党政、机关及事业单位/其他组织，可填"74"，表示对公账户；若主体为"小微/个人卖家"，可填"75"，表示对私账户；若主体为个体工商户，可填"74"或"75" 【附】银行信息相关参考：省市区编号对照表开户银行全称对照表开户银行对照表
account_bank	string	是	开户银行，比如"工商银行"
account_name	string	否	开户名称
bank_address_code	string	是	开户银行省市编码，例如"110000"
bank_branch_id	string	否	开户银行联行号，开户银行全称（含支行）和开户银行联行号二选一
bank_name	string	是	开户银行全称（含支行）
account_number	string	是	银行帐号

# Body.contact_info `Object Payload`

超级管理员信息

参数名	类型	必填	说明
contact_type	string	是	主体为"小微/个人卖家"，可填"65"; 主体为"个体工商户/企业/党政、机关及事业单位/其他组织"，可填"65"表示经营者/法人，或者"66"表示经办人。
contact_name	string	是	超级管理员姓名
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	是	超级管理员身份证件号码
contact_id_doc_copy	string	是	超级管理员证件正面照片id，当超级管理员类型是经办人时，请上传超级管理员证件的正面照片。
contact_id_doc_copy_back	string	是	超级管理员证件反面照片,当超级管理员类型是经办人时，请上传超级管理员证件的反面照片。
contact_id_doc_period_begin	string	是	超级管理员证件有效期开始时间当超级管理员类型是经办人时，请上传证件有效期开始时间。
contact_id_doc_period_end	string	是	级管理员证件有效期结束时间当超级管理员类型是经办人时，请上传证件有效期结束时间。
business_authorization_letter	string	是	业务办理授权函。1、当超级管理员类型是经办人时，请上传业务办理授权函。2、请参照示例图打印业务办理授权函，全部信息需打印，不支持手写商户信息，并加盖公章。
mobile_phone	string	是	超级管理员手机,
contact_email	string	是	超级管理员邮箱,主体类型为"小微商户/个人卖家"可选填，其他主体需必填。

# Body.business_license `Object Payload`

营业执照

参数名	类型	必填	说明
business_license_copy	string	是	证件扫描件图片id，可通过上传商户图片API获取
business_license_number	string	是	证件注册号
merchant_name	string	是	商户名称
legal_person	string	是	经营者/法定代表人姓名
company_address	string	否	注册地址，主体为"党政、机关及事业单位/其他组织"时必填，请填写登记证书的注册地址。
business_time	string	否	营业期限，主体为"党政、机关及事业单位/其他组织"时必填。
cert_type	string	否	1、主体为"政府机关/事业单位/社会组织"时，请上传登记证书类型。 2、主体为"个体工商户/企业"时，不填。当主体为事业单位时，填枚举值："CERTIFICATE_TYPE_2388", 表示事业单位法人证书；当主体为政府机关，填枚举值："CERTIFICATE_TYPE_2389"，表示统一社会信用代码证书

# Body.qualification `Object Payload`

行业特殊资质资料。

参数名	类型	必填	说明
qualification_type	string	是	行业特殊资质类型，如"速送", 详情见《行业对应特殊资质》
qualifications	string	否	行业特殊资料, 字符串数组构成的字符串，示例值:"["jTpGmxUX3FBWVQ5NJInE4d2I6_H7I4"]"。详情见《行业对应特殊资质》，在需要上传时必填。

# Body.ext_register_info `Object Payload`

补充信息

参数名	类型	必填	说明	枚举
door_head_file_id	string	是	: string, 企业门头照 id，可通过上传商户资料 api 获取 - : string, - : string, - : string, - : string, - contact_id_doc_address: string, 经办人证件地址，当超级管理员为经办人时补充填写	-
store_file_id	string	是	商城截图 id, 可通过上传商户图片API获取	-
online_pay_file_id	string	是	确认订单付款界面截图 id，可通过上传商户图片API获取	-
merchant_scale	string	是	企业规模，枚举值	枚举值
authorization_letter_file_id	string	否	银行转账授权书图片 id，当同时开通银行转账（open_type = 1）且超级管理员为经办人时填写。授权书见示例，图片 id 可通过上传商户图片API获取。	-

# 3. 返回参数

# 返回体 `Response Payload`

参数名	类型	说明
errcode	number	错误码
errmsg	string	错误信息
order_no	string	进件申请单号可用于查询进件状态

# 4. 枚举信息

# Body.ext_register_info.merchant_scale `Enum`

企业规模，枚举值

枚举值	描述
LARGE	大型企业 2000 人以上
MIDDLE	中型企业 150 至 2000 人
SMALL	小型企业 15 至 150 人
TINY	微型企业 15 人以下

# 5. 注意事项

本接口无特殊注意事项

# 6. 代码示例

请求示例

{
  "id_doc_type_num": 1,
  "id_card_info": {
    "id_card_copy": "V1_xxxxxxx",
    "id_card_national": "V1_xxxxxx",
    "id_card_name": "小明",
    "id_card_number": "440000199001011111",
    "id_card_valid_time": "2041-01-01",
    "id_card_address": "北京市朝阳区等等等",
    "id_card_valid_time_begin": "2021-01-01"
  },
  "account_info": {
    "bank_account_type": "74",
    "account_bank": "招商银行",
    "bank_name": "招商银行xx支行",
    "account_name": "北京食品有限公司",
    "bank_address_code": "123",
    "account_number": "123"
  },
  "contact_info": {
    "contact_type": "65",
    "contact_name": "小明",
    "contact_id_card_number": "440000199001011111",
    "mobile_phone": "12345678911",
    "contact_email": "test@qq.com"
  },
  "business_license": {
    "business_license_copy": "V1_xxxx",
    "business_license_number": "ABC123",
    "merchant_name": "北京食品有限公司",
    "legal_person": "小明"
  },
  "merchant_shortname": "北京食品",
  "organization_type": 1,
  "ignore_same_entity": true,
  "launch_poll_task": true,
  "qualification": {
    "qualification_type": "食品生鲜"
  },
  "open_type": 1,
  "ext_register_info": {
    "door_head_file_id": "V1_xxxxxxx",
    "store_file_id": "V1_xxxxxxx",
    "online_pay_file_id": "V1_xxxxxxx",
    "merchant_scale": "LARGE"
  },
  "client_ip": "127.0.0.0"
}

返回示例

{
  "errcode": 0,
  "errmsg": "OK",
  "order_no": "regorder123"
}

# 7. 错误码

以下是本接口的错误码列表，其他错误码可参考通用错误码；调用接口遇到报错，可使用官方提供的 API 诊断工具辅助定位和分析问题。

错误码	错误描述
90000	商户主体已经处于进件中
90001	主体类型不符要求
90003	提交频繁
90004	证件类型不符
90005	该商户主体进件数目达到上限
222229	进件申请字段填写不完整
9403200	id_doc_type_num字段超出范围

# 8. 适用范围

本接口暂未明确可调用账号类型，或在业务中根据调用传参自行确定是否可调用，请以实际调用情况为准。

# 商户号进件

# 1. 调用方式

# HTTPS 调用

# 云调用

# 第三方调用

# 2. 请求参数

# 查询参数 Query String Parameters

# 请求体 Request Payload

# Body.id_card_info Object Payload

# Body.id_doc_info Object Payload

# Body.account_info Object Payload

# Body.contact_info Object Payload

# Body.business_license Object Payload

# Body.qualification Object Payload

# Body.ext_register_info Object Payload