跳到主要内容

商户入网(企业/个体)


请求接口

openapi/v2/apply/apply

公共参数

接口协议 - 公共参数

请求参数

参数必填类型说明
channelString(32)入网渠道。易宝:YEEPAY
channel_codeString(32)指定渠道 code,酷点分配;仅当服务商申请了多个渠道配置时需要
mch_idString(32)商家 id,如果未传入,会根据手机号和营业执照编号依次查询,如都没有,则创建新商家
sp_mch_idString(32)服务商 id,如果未传入,商家归属服务商默认为开发者
apply_formJson进件表单信息
notify_urlString(1024)回调地址,用于接收进件结果通知

进件表单信息 apply_form

参数必填类型说明
apply_typeString(32)进件类型。 ENTERPRISE:企业, PRIVATELY:个体工商户
business_infoJson商户主体信息
business_imagesJsonArray商户店铺图片,经营场景有线下门店必填
nameString(128)商户名称,与商户证件主体一致
short_nameString(32)商户简称,即签约名称、用户端看到的商户名称
legal_personJson商户法人信息,见人员信息
contact_personJson商户联系人信息,法人作为联系人传入一样的信息
bank_accountJson商户银行账户,见银行帐户信息
product_rateJsonArray产品配置,见产品配置信息
compliant_paymentJson根据开通不同的产品传入材料,见合规支付
benefitsJsonArray资金类业务专用,受益人信息,最多填 4 个。见人员信息
shareholdersJsonArray资金类业务专用,股东/实际控股人信息,最多填 4 个。见人员信息
ca_auth_fileString(128)资金类业务专用,企业 CA 证书及电子签名授权委托书
legal_auth_fileString(128)资金类业务专用,法人委托授权书
contact_auth_fileString(128)资金类业务专用,联系人委托授权书

::: tip 提示

  1. 如果提交进件时未配置产品表,为了保证商户交易,您可以后续通过产品变更配置产品表。
  2. 联系人手机号作为后续短信通知,登录验证等场景使用

商户主体信息 business_info

参数必填类型说明
nameString(64)企业名称,与证件名称一致
cert_infoJson企业证件,见证件信息
emailString(32)联系邮箱
phoneString(32)联系电话
address_infoJson联系地址,见地址信息
post_codeString(32)邮政编码

商户店铺图片 business_image

参数必填类型说明
file_idString(64)图片 id
typeString(64)图片类型。FRONT_IMAGE:门头照,INSIDE_IMAGE:店内环境,CASHIER_IMAGE:收银台照片

响应参数

名称必填类型说明
order_noString(32)进件单号
mch_idString(16)商户 id

::: tip 提示 公共返回值 code=0 时,表示请求提交成功;