商户入网(企业/个体)
请求接口
openapi/v2/apply/apply
公共参数
请求参数
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| channel | 是 | String(32) | 入网渠道。易宝:YEEPAY |
| channel_code | 否 | String(32) | 指定渠道 code,酷点分配;仅当服务商申请了多个渠道配置时需要 |
| mch_id | 否 | String(32) | 商家 id,如果未传入,会根据手机号和营业执照编号依次查询,如都没有,则创建新商家 |
| sp_mch_id | 否 | String(32) | 服务商 id,如果未传入,商家归属服务商默认为开发者 |
| apply_form | 是 | Json | 进件表单信息 |
| notify_url | 否 | String(1024) | 回调地址,用于接收进件结果通知 |
进件表单信息 apply_form
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| apply_type | 是 | String(32) | 进件类型。 ENTERPRISE:企业, PRIVATELY:个体工商户 |
| business_info | 是 | Json | 商户主体信息 |
| business_images | 否 | JsonArray | 商户店铺图片,经营场景有线下门店必填 |
| name | 是 | String(128) | 商户名称,与商户证件主体一致 |
| short_name | 是 | String(32) | 商户简称,即签约名称、用户端看到的商户名称 |
| legal_person | 是 | Json | 商户法人信息,见人员信息 |
| contact_person | 是 | Json | 商户联系人信息,法人作为联系人传入一样的信息 |
| bank_account | 是 | Json | 商户银行账户,见银行帐户信息 |
| product_rate | 否 | JsonArray | 产品配置,见产品配置信息 |
| compliant_payment | 否 | Json | 根据开通不同的产品传入材料,见合规支付 |
| benefits | 否 | JsonArray | 资金类业务专用,受益人信息,最多填 4 个。见人员信息 |
| shareholders | 否 | JsonArray | 资金类业务专用,股东/实际控股人信息,最多填 4 个。见人员信息 |
| ca_auth_file | 否 | String(128) | 资金类业务专用,企业 CA 证书及电子签名授权委托书 |
| legal_auth_file | 否 | String(128) | 资金类业务专用,法人委托授权书 |
| contact_auth_file | 否 | String(128) | 资金类业务专用,联系人委托授权书 |
::: tip 提示
- 如果提交进件时未配置产品表,为了保证商户交易,您可以后续通过产品变更配置产品表。
- 联系人手机号作为后续短信通知,登录验证等场景使用
商户主体信息 business_info
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| name | 是 | String(64) | 企业名称,与证件名称一致 |
| cert_info | 是 | Json | 企业证件,见证件信息 |
| 是 | String(32) | 联系邮箱 | |
| phone | 是 | String(32) | 联系电话 |
| address_info | 是 | Json | 联系地址,见地址信息 |
| post_code | 否 | String(32) | 邮政编码 |
商户店铺图片 business_image
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| file_id | 是 | String(64) | 图片 id |
| type | 是 | String(64) | 图片类型。FRONT_IMAGE:门头照,INSIDE_IMAGE:店内环境,CASHIER_IMAGE:收银台照片 |
响应参数
| 名称 | 必填 | 类型 | 说明 |
|---|---|---|---|
| order_no | 是 | String(32) | 进件单号 |
| mch_id | 是 | String(16) | 商户 id |
::: tip 提示 公共返回值 code=0 时,表示请求提交成功;