用户开户[页面接入]

POST/v1/accp/customer/h5-openacct-apply

个人、企业开户申请调用该接口，申请成功返回gateway_url，商户引导用户进入连连提供的开户界面进行开户。用户完成操作后可跳回商户上传的[return_url]处。

请求参数

mch_id

string

商户号

必需

商户编号是商户在平台上开设的商户号码，为18位数字，如：201304121000001004

user_id

string

商户用户唯一编号

必需

用户在商户系统中的唯一编号，要求该编号在商户系统能唯一标识用户

txn_seqno

string

交易流水号

必需

商户系统唯一交易流水号

txn_time

string

商户系统交易时间

必需

商户系统交易时间。格式：yyyyMMddHHmmss。

notify_url

string

异步通知地址

必需

交易结果异步通知接收地址，建议HTTPS协议

return_url

string

支付结果页面返回地址

可选

交易返回地址，支付结果页面返回地址。默认返回方式为post请求。若想更改为get请求，可在返回地址增加jump=page字段，例如:https://open.lianlianpay.com?jump=page

user_type

string

用户类型

必需

用户类型。 INNERUSER：个人用户 INNERCOMPANY：企业用户

cust_trade_serial_type

string

开户类型

可选

开户类型。 OpenActivatedUser：待激活开户 OpenNormalUser：正常开户，默认为正常开户

un_modifiable_field

string

H5固定值不可修改

可选

H5固定值不可修改；可将参数名传入，则下方对应参数名接口字段必传，且页面不可进行修改；若存在多个参数名，则以","间隔，默认为空；目前支持字段：user_name,reg_phone,id_no,reg_email,legalrept_name,legalrept_phone

sync_open_lzt

enum<string>

是否同步开通来账通账户

可选

是否同步开通来账通账户。是：Y 否：N

枚举值:

basic_info

object

开户基本信息

可选

开户基本信息

reg_phone

string

用户开户绑定手机号

可选

用户开户绑定手机号，需要加密

user_name

string

用户名称

可选

用户名称，需要加密

id_type

string

证件类型

可选

证件类型。身份证：IDCARD。统一社会信用代码证： BUSINESS_LICENCE

id_no

string

证件号码

可选

证件号码，需要加密

id_exp

string

证件到期日

可选

证件到期日，格式：yyyyMMdd 长期有效则设置为：99991231

id_std

string

证件签发日

可选

证件签发日，格式：yyyyMMdd

address

string

企业营业地址

可选

企业营业地址

reg_email

string

注册邮箱

可选

注册邮箱

occupation

string

职业

可选

职业。

linked_acct_info

object

开户绑卡信息

可选

开户绑卡信息

linked_acct_type

string

绑定账户类型

可选

BANK_ACCOUNT_CORPORATE ：企业对公卡BANK_ACCOUNT_PERSONAL_LEGAL：法人卡
BANK_ACCOUNT_PERSONAL：个人卡

linked_acct_no

string

绑定银行帐号

可选

企业用户绑定的银行帐号或法人卡号需要加密

linked_bank_code

string

银行编码

可选

绑定账户类型为企业对公户必输

linked_brbank_name

string

对公账户开户行名

可选

企业用户绑定账户开户支行名称绑定账户类型为企业对公户必输

linked_brbank_no

string

对公账户开户行号

可选

企业用户开户行行号，绑定账户类型为企业对公户必输

linked_acct_name

string

对公账户名

可选

绑定账户类型为企业对公户必输需要加密

linked_phone

string

银行预留手机号

可选

绑定账户类型为法人银行卡必输需要加密

legalrept_info

object

企业法定代表人信息

可选

企业法定代表人信息

legalrept_name

string

法定代表人姓名

可选

法定代表人姓名，需要加密

legalrept_phone

string

法定代表人手机号

可选

法定代表人手机号，需要加密

legalrept_id_type

string

法人代表证件类型

可选

参见‘证件类型’ 默认“IDCARD”

legalrept_id_no

string

法定代表人证件号

可选

法定代表人证件号，需要加密

legalrept_id_exp

string

法定代表人证件有效期

可选

法定代表人身份证到期日，格式：yyyyMMdd 长期有效则设置为：99991231

legalrept_id_std

string

法定代表人证件签发日

可选

法定代表人身份证签发日，格式：yyyyMMdd

contacts_info

object

企业联系人信息

可选

企业联系人信息

contacts_name

string

联系人姓名

可选

联系人/被授权人姓名，需要加密

contacts_phone

string

联系人手机号

可选

联系人/被授权人手机号，需要加密

contacts_id_type

string

联系人证件类型

可选

默认“IDCARD”

contacts_id_no

string

联系人证件号

可选

联系人身份证号，需要加密

contacts_id_emblem

string

身份证国徽面

可选

联系人身份证国徽面照片；传入文件上传接口的doc_id；

contacts_id_portrait

string

身份证人像面

可选

企业用户法人身份证人像面照片；传入文件上传接口的doc_id；

contacts_id_exp

string

联系人身份证到期日

可选

联系人身份证到期日，格式：yyyyMMdd 长期有效则设置为：99991231

contacts_id_std

string

联系人身份证签发日

可选

联系人身份证签发日，格式：yyyyMMdd

business_info

object

企业经营信息

可选

企业经营信息

scale

string

企业规模

可选

企业规模 BIGGER 大规模 MIDDLE 中等规模 SMALL 小规模

industry_code

string

行业代码

可选

行业代码

registered_capital

string

注册资本

可选

注册资本，单位：万元

business_scope

string

经营范围

可选

经营范围

account_info

object

开户账户申请信息

可选

开户账户申请信息

account_type

enum<string>

账户属性

必需

账户属性。若该字段未上传，默认账户类型为账簿。账簿不能余额消费、代发。

枚举值:

ACCOUNT_BOOKPERSONAL_PAYMENT_ACCOUNTENTERPRISE_PAYMENT_ACCOUNT

account_level

enum<string>

需求等级

可选

需求等级。当账户属性为个人支付账户时，需要上传账户等级，建议传V3。注：该字段表示商户请求的个人支付账户需求等级，真实开户结果以ACCP返回等级为准。

枚举值:

V1V2V3

lzt_basic_info

object

来账通

可选

来账通

business_type

string

业务类型

可选

业务类型

shop_id

string

门店 id

可选

门店 id

shop_name

string

店铺名称

可选

店铺名称

shop_address

string

店铺地址url

可选

店铺地址url

province

string

省

可选

省

city

string

城市

可选

城市

area

string

区

可选

区

address

string

详细地址

可选

详细地址

memo

string

备注

可选

备注

open_bank

string

开户银行编码

可选

开户银行编码

notify_url

string

来账通开户通知 url

可选

来账通开户通知 url

ext_info

array[string]

补充资料

可选

补充资料

ubo_info

array [object {13}]

受益人

可选

受益人

ubo_type

string

受益所有人类型

可选

受益所有人：ubo 实控人：uac 股东：shareholder

ubo_name

string

受益人名称

可选

受益人名称需要加密

ubo_name_en

string

受益人名称拼音

可选

受益人名称拼音

ubo_id_type

string

证件类型

可选

证件类型。

ubo_id_no

string

证件号码

可选

证件号码需要加密

ubo_phone

string

受益人手机号

可选

受益人手机号需要加密

ubo_id_exp

string

证件有效期

可选

证件到期日，格式：yyyyMMdd 长期有效则设置为：99991231

ubo_id_std

string

证件签发日期

可选

证件签发日，格式：yyyyMMdd

ubo_id_emblem

string

身份证国徽面

可选

证件类型为身份证必输；传入文件上传接口的doc_id

ubo_id_portrait

string

身份证人像面

可选

证件类型为身份证必输；传入文件上传接口的doc_id

ubo_address

string

地址

可选

地址

ubo_evidence

string

证明文件

可选

受益所有人其他证明文件,开启跨境业务时这个字段必填

ubo_unified_code

string

统一社会信用代码证三证合一证件照

可选

统一社会信用代码证三证合一证件照

theme

object

页面模板定制

可选

页面模板定制

primary

string

基础色

可选

基础色。默认值为#1976D2 wap端有效产品类型。

secondary

string

间色

可选

间色。默认值为#424242 wap端有效。

accent

string

强调色

可选

强调色。默认值为#82B1FF wap端有效。

error

string

错误色

可选

错误色。默认值为#FF5252 wap端有效。

info

string

信息色

可选

信息色。默认值为#2196F3 wap端有效。

success

string

成功色

可选

成功色。默认值为#4CAF50 wap端有效。

warning

string

警告色

可选

警告色。默认值为#FFC107 wap端有效。

{
  "mch_id": "string",
  "user_id": "string",
  "txn_seqno": "string",
  "txn_time": "string",
  "notify_url": "string",
  "return_url": "string",
  "user_type": "string",
  "cust_trade_serial_type": "string",
  "un_modifiable_field": "string",
  "sync_open_lzt": "Y",
  "basic_info": {
    "reg_phone": "string",
    "user_name": "string",
    "id_type": "string",
    "id_no": "string",
    "id_exp": "string",
    "id_std": "string",
    "address": "string",
    "reg_email": "string",
    "occupation": "string"
  },
  "linked_acct_info": {
    "linked_acct_type": "string",
    "linked_acct_no": "string",
    "linked_bank_code": "string",
    "linked_brbank_name": "string",
    "linked_brbank_no": "string",
    "linked_acct_name": "string",
    "linked_phone": "string"
  },
  "legalrept_info": {
    "legalrept_name": "string",
    "legalrept_phone": "string",
    "legalrept_id_type": "string",
    "legalrept_id_no": "string",
    "legalrept_id_exp": "string",
    "legalrept_id_std": "string"
  },
  "contacts_info": {
    "contacts_name": "string",
    "contacts_phone": "string",
    "contacts_id_type": "string",
    "contacts_id_no": "string",
    "contacts_id_emblem": "string",
    "contacts_id_portrait": "string",
    "contacts_id_exp": "string",
    "contacts_id_std": "string"
  },
  "business_info": {
    "scale": "string",
    "industry_code": "string",
    "registered_capital": "string",
    "business_scope": "string"
  },
  "account_info": {
    "account_type": "ACCOUNT_BOOK",
    "account_level": "V1"
  },
  "lzt_basic_info": {
    "business_type": "string",
    "shop_id": "string",
    "shop_name": "string",
    "shop_address": "string",
    "province": "string",
    "city": "string",
    "area": "string",
    "address": "string",
    "memo": "string",
    "open_bank": "string",
    "notify_url": "string",
    "ext_info": [
      "string"
    ]
  },
  "ubo_info": [
    {
      "ubo_type": "string",
      "ubo_name": "string",
      "ubo_name_en": "string",
      "ubo_id_type": "string",
      "ubo_id_no": "string",
      "ubo_phone": "string",
      "ubo_id_exp": "string",
      "ubo_id_std": "string",
      "ubo_id_emblem": "string",
      "ubo_id_portrait": "string",
      "ubo_address": "string",
      "ubo_evidence": "string",
      "ubo_unified_code": "string"
    }
  ],
  "theme": {
    "primary": "string",
    "secondary": "string",
    "accent": "string",
    "error": "string",
    "info": "string",
    "success": "string",
    "warning": "string"
  }
}

示例代码

返回响应

成功(200)

HTTP 状态码: 200

内容格式: JSONapplication/json

ret_code

string

交易返回码

必需

交易返回码

ret_msg

string

交易返回描述

必需

交易返回描述

mch_id

string

商户号

必需

商户编号是商户在平台上开设的商户号码，为18位数字，如：201304121000001004

user_id

string

商户用户唯一编号

必需

用户在商户系统中的唯一编号，要求该编号在商户系统能唯一标识用户

txn_seqno

string

交易流水号

必需

商户系统唯一交易流水号

platform_txno

string

系统唯一交易流水号

可选

请求受理成功时返回。系统唯一交易流水号

gateway_url

string

用户开户网关地址

可选

用户开户网关地址，用户跳转至该地址完成开户过程。跳转方式：商户前端Get请求该地址。如果想要显示返回上一页按钮，可以在gateway_url后拼接header=Y，即可带上H5头部示例：https://openweb.lianlianpay.com/accp-open-account/?token=96deb14a22eb4aa2dff2bcf81828fc7b&header=Y

{
  "user_id": "358987985951",
  "txn_seqno": "19598511454741364627",
  "token": "b9a46f119f224bb1b4a4614516519471",
  "ret_code": "0000",
  "ret_msg": "申请成功，短信已下发，请输入短信验证码完成验证",
  "mch_id": "302210180000021525"
}