商户进件申请

接口说明

商户进件申请接口用于提交商户入驻申请，包括商户基本信息、法人信息、结算信息等。证件图片需先通过图片上传接口上传，获取图片 ID 后传入本接口。

请求地址

【POST】/pay/applyment/submit

业务参数

主体信息

参数	必填	类型	说明	示例值
subject_type	是	String	主体类型 `INDIVIDUAL` 个体工商户 `ENTERPRISE` 企业（有限公司） `MICRO` 小微商户（无营业执照）	ENTERPRISE
merchant_name	是	String(128)	商户名称个体工商户如无注册名称，按"个体户+经营者姓名"格式传入	上海XX科技有限公司
merchant_shortname	是	String(64)	商户简称支付完成页向买家展示	XX科技
business_license_pic	条件	String(64)	营业执照照片 ID 主体为个体户/企业时必传	media_id_license
license_number	条件	String(32)	注册号/统一社会信用代码主体为个体户/企业时必传	91310000XXXXXXXXXX
license_address	否	String(128)	营业执照注册地址	上海市XX区XX路XX号
period_begin	条件	String(10)	营业执照有效期开始日期，格式：YYYY-MM-DD	2020-01-01
period_end	条件	String(10)	营业执照有效期结束日期，格式：YYYY-MM-DD，长期请填"长期"	2030-12-31

法人/经营者身份信息

参数	必填	类型	说明	示例值
id_doc_type	是	String	证件类型 `IDCARD` 身份证 `OVERSEA_PASSPORT` 护照 `HONGKONG_PASSPORT` 港澳来往内地通行证 `MACAO_PASSPORT` 澳门来往内地通行证 `TAIWAN_PASSPORT` 台湾来往大陆通行证 `FOREIGN_RESIDENT` 外国人居留证 `HONGKONG_MACAO_RESIDENT` 港澳居民居住证 `TAIWAN_RESIDENT` 台湾居民居住证	IDCARD
legal_person	是	String(100)	经营者/法定代表人姓名	张三
id_doc_front	是	String(64)	证件正面照片 ID 身份证传人像面	media_id_doc_front
id_doc_back	条件	String(64)	证件反面照片 ID 身份证传国徽面；护照/通行证等无反面则不传	media_id_doc_back
id_doc_name	是	String(100)	证件姓名	张三
id_doc_number	是	String(32)	证件号码	310101199001011234
id_doc_address	否	String(128)	证件居住地址	上海市XX区XX路XX号
id_doc_period_begin	是	String(10)	证件有效期开始日期，格式：YYYY-MM-DD	2015-01-01
id_doc_period_end	是	String(10)	证件有效期结束日期，格式：YYYY-MM-DD，长期请填“长期”	2035-01-01

联系人信息

参数	必填	类型	说明	示例值
contact_type	是	String	联系人类型 `LEGAL` 经营者/法定代表人 `SUPER` 经办人	LEGAL
contact_name	是	String(100)	联系人姓名	李四
contact_id_doc_type	条件	String	联系人证件类型，当 contact_type 为 SUPER 时必传，取值同 id_doc_type	IDCARD
contact_id_number	条件	String(32)	联系人证件号码，当 contact_type 为 SUPER 时必传	310101199001011234
mobile_phone	是	String(32)	联系手机号用于接收开户信息及日常业务通知	13800138000

经营信息

参数	必填	类型	说明	示例值
business_code	是	String(124)	业务申请编号商户自定义的唯一编号，仅可由数字、字母或下划线组成，建议带商户号前缀；每个编号对应一个申请单	APPLY_1900013511_10000
service_phone	是	String(32)	客服电话	4001234567
mcc_code	是	String(32)	MCC 行业编码，详见 MCC 行业编码对照表	5411
business_scope	是	String(256)	经营范围	软件开发、技术服务
sales_scenes_type	是	Array[String]	经营场景类型，可多选 `SALES_SCENES_STORE` 线下门店 `SALES_SCENES_MP` 服务号/公众号 `SALES_SCENES_MINI_PROGRAM` 小程序 `SALES_SCENES_WEB` 互联网网站	["SALES_SCENES_STORE"]
biz_store_name	条件	String(50)	线下门店名称 sales_scenes_type 包含 SALES_SCENES_STORE 时必传	XX旗舰店
biz_address_code	条件	String(32)	线下门店省市区编码（六位） sales_scenes_type 包含 SALES_SCENES_STORE 时必传	310101
biz_store_address	条件	String(256)	线下门店详细地址 sales_scenes_type 包含 SALES_SCENES_STORE 时必传	上海市XX区XX路XX号XX大厦10楼
store_entrance_pic	条件	String(64)	门店门头照片 ID sales_scenes_type 包含 SALES_SCENES_STORE 时必传，要求门店招牌、门框完整、清晰、可辨识	media_id_entrance
indoor_pic	条件	String(64)	门店内部照片 ID sales_scenes_type 包含 SALES_SCENES_STORE 时必传	media_id_indoor
cashier_pic	条件	String(64)	收银台照片 ID sales_scenes_type 包含 SALES_SCENES_STORE 时必传，收银台摆放收银物料的照片	media_id_cashier

互联网网站信息（当 sales_scenes_type 包含 SALES_SCENES_WEB 时必传）

参数	必填	类型	说明	示例值
domain	条件	String(256)	网站域名（需 ICP 备案）	https://www.example.com
web_authorisation	否	String(64)	网站授权函照片 ID 备案主体与申请主体不同时必传	media_id_auth
icp_license_pic	条件	String(64)	ICP 许可证或公众号主体信息截图 ID 互联网网站类商户必传	media_id_icp

结算信息

参数	必填	类型	说明	示例值
settlement_type	是	String(16)	结算类型，当前仅支持 `D1` 一种取值	D1
bank_account_type	是	String	账户类型 `CORPORATE` 对公账户 `PERSONAL` 经营者个人银行卡企业/政府/事业单位/社会组织仅可对公；个体户两者皆可	CORPORATE
account_name	是	String(128)	开户名称对公时与商户名称一致；对私时与经营者证件姓名一致	上海XX科技有限公司
account_bank	是	String(32)	开户银行	工商银行
bank_address_code	是	String(32)	开户银行省市编码（精确到市）	310100
bank_branch_id	条件	String(32)	开户银行联行号与 bank_name 二选一	102290026507
bank_name	条件	String(128)	开户银行全称（含支行）与 bank_branch_id 二选一	工行上海分行XX支行
account_number	是	String(32)	银行账号	6222021001122334455
bank_account_pic	条件	String(64)	银行账户证明照片 ID 对公必传（开户许可证/印鉴卡/银行回单/对公证明 4 选 1）；对私必传银行卡正面照	media_id_bank

补充材料（可选）

参数	必填	类型	说明	示例值
legal_person_commitment	否	String(64)	法定代表人开户承诺函照片 ID	media_id_commit
business_addition_pics	否	Array[String]	补充材料照片 ID 数组（最多 5 张）	["media_id_add"]
business_addition_msg	否	String(512)	补充说明	资金来源：自有资金

其他信息

参数	必填	类型	说明	示例值
notify_url	是	String(256)	进件结果异步通知地址	https://example.com/notify
attach	否	String(256)	附加信息（异步通知原样回传）	商户附加备注

请求示例

示例1：企业商户（对公结算）

{
  "business_code": "APPLY_1900013511_10000",
  "subject_type": "ENTERPRISE",
  "merchant_name": "上海XX科技有限公司",
  "merchant_shortname": "XX科技",
  "license_copy": "media_id_license",
  "license_number": "91310000XXXXXXXXXX",
  "license_address": "上海市XX区XX路XX号",
  "period_begin": "2020-01-01",
  "period_end": "2030-12-31",
  "id_doc_type": "IDCARD",
  "legal_person": "张三",
  "id_doc_front": "media_id_doc_front",
  "id_doc_back": "media_id_doc_back",
  "id_doc_name": "张三",
  "id_doc_number": "310101199001011234",
  "id_doc_period_begin": "2015-01-01",
  "id_doc_period_end": "2035-01-01",
  "contact_type": "LEGAL",
  "contact_name": "李四",
  "mobile_phone": "13800138000",
  "service_phone": "4001234567",
  "mcc_code": "5411",
  "business_scope": "软件开发、技术服务",
  "sales_scenes_type": ["SALES_SCENES_STORE"],
  "biz_store_name": "XX旗舰店",
  "biz_address_code": "310101",
  "biz_store_address": "上海市XX区XX路XX号XX大厦10楼",
  "store_entrance_pic": "media_id_entrance",
  "indoor_pic": "media_id_indoor",
  "cashier_pic": "media_id_cashier",
  "settlement_type": "D1",
  "bank_account_type": "CORPORATE",
  "account_name": "上海XX科技有限公司",
  "account_bank": "工商银行",
  "bank_address_code": "310100",
  "bank_branch_id": "102290026507",
  "account_number": "6222021001122334455",
  "bank_account_pic": "media_id_open_license",
  "notify_url": "https://example.com/notify"
}

示例2：个体工商户（对私结算）

{
  "business_code": "APPLY_1900013511_10001",
  "subject_type": "INDIVIDUAL",
  "merchant_name": "个体户+王五",
  "merchant_shortname": "王五便利店",
  "license_copy": "media_id_license_ind",
  "license_number": "92310000XXXXXXXXXX",
  "period_begin": "2019-01-01",
  "period_end": "长期",
  "id_doc_type": "IDCARD",
  "legal_person": "王五",
  "id_doc_front": "media_id_doc_front_ind",
  "id_doc_back": "media_id_doc_back_ind",
  "id_doc_name": "王五",
  "id_doc_number": "310101198501011234",
  "id_doc_period_begin": "2010-01-01",
  "id_doc_period_end": "2030-01-01",
  "contact_type": "LEGAL",
  "contact_name": "王五",
  "mobile_phone": "13800138001",
  "service_phone": "13800138001",
  "mcc_code": "5411",
  "business_scope": "便利店零售",
  "sales_scenes_type": ["SALES_SCENES_STORE"],
  "biz_store_name": "王五便利店",
  "biz_address_code": "310101",
  "biz_store_address": "上海市XX区XX路XX号",
  "store_entrance_pic": "media_id_entrance_ind",
  "indoor_pic": "media_id_indoor_ind",
  "cashier_pic": "media_id_cashier_ind",
  "settlement_type": "D1",
  "bank_account_type": "PERSONAL",
  "account_name": "王五",
  "account_bank": "工商银行",
  "bank_address_code": "310100",
  "bank_name": "工行上海分行XX支行",
  "account_number": "6222021001122334456",
  "bank_account_pic": "media_id_bank_card",
  "notify_url": "https://example.com/notify"
}

返回结果

参数	必填	类型	说明	示例值
code	是	String(32)	返回码，000000 表示成功	000000
message	是	String(128)	返回信息	提交成功
applyment_id	是	String(64)	进件申请单号	2000002124775691
business_code	是	String(124)	业务申请编号（原样回传）	APPLY_1900013511_10000
status	是	String(32)	进件状态 `SUBMITTED` 已提交 `AUDITING` 审核中 `APPROVED` 审核通过 `REJECTED` 审核驳回	SUBMITTED

返回示例

{
  "code": "000000",
  "message": "提交成功",
  "applyment_id": "2000002124775691",
  "business_code": "APPLY_1900013511_10000",
  "status": "SUBMITTED"
}

错误码

错误码	说明
000000	成功
FAIL	失败
PARAM_ERROR	参数错误
INVALID_REQUEST	业务申请编号已存在
MEDIA_ID_INVALID	图片 ID 无效或已过期
MERCHANT_EXISTS	商户已存在
LICENSE_NUMBER_INVALID	营业执照编码格式错误
ID_CARD_INVALID	身份证号码格式错误
MOBILE_INVALID	手机号格式错误
BANK_ACCOUNT_INVALID	银行账号格式错误

注意事项

资料清单

一、个体工商户

个体营业执照（license_copy）
经营者证件正面照（id_doc_front，身份证为人像面）
经营者证件反面照（id_doc_back，身份证为国徽面；护照等无反面可不传）
结算银行卡照片（bank_account_pic，对私时为银行卡正面）
门店门头照片（store_entrance_pic）
门店内部照片（indoor_pic）
收银台照片（cashier_pic）

二、企业（有限公司）

企业营业执照（license_copy）
法定代表人证件正面照（id_doc_front，身份证为人像面）
法定代表人证件反面照（id_doc_back，身份证为国徽面；护照等无反面可不传）
对公开户证明（bank_account_pic），4 选 1：
- 开户许可证
- 对公户印鉴卡
- 银行盖章的回单照片
- 银行出具的对公户证明
门店门头照片、内部照片、收银台照片

三、小微商户（无营业执照）

经营者证件正面照（id_doc_front，身份证为人像面）
经营者证件反面照（id_doc_back，身份证为国徽面；护照等无反面可不传）
经营者银行卡照片（bank_account_pic）
门店门头照片、内部照片、收银台照片

重要说明

所有证件图片必须先通过图片上传接口上传，获取图片 ID 后再调用本接口；建议在 24 小时内完成进件申请。
business_code 由商户自定义生成，需保证唯一性，每个编号对应一个申请单，可用于幂等控制。
个体工商户如无注册名称，merchant_name 按"个体户+经营者姓名"格式传入。
对公结算账户名需与营业执照名称一致；自然人商户只允许对私结算，互联网网站类商户只允许对公结算。
证件、营业执照的有效期，长期有效请传"长期"。
互联网网站类商户必传 icp_license_pic（ICP 许可证或公众号主体信息截图）。
进件结果会通过 notify_url 异步通知，请确保通知地址可正常访问。
审核状态可通过进件状态查询接口查询。