新增绑定银行账户申请

POST/v1/accp/customer/addcard-apply

用于个人、企业用户新增绑定银行账户，作为提现卡。

请求参数

mch_id

string

商户号

必需

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

user_id

string

商户用户唯一编号

必需

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

txn_seqno

string

交易流水号

必需

商户系统唯一交易流水号

txn_time

string

商户系统交易时间

必需

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

notify_url

string

异步通知地址

必需

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

risk_item

string

风险控制参数

可选

风险控制参数。连连风控部门要求商户统一传入风险控制参数字段，字段值为json 字符串的形式。传入示例及要求见风险控制说明。

linked_acct_info

object

开户绑卡信息

必需

开户绑卡信息

linked_acct_type

string

绑定账户类型

必需

个人银行卡：BANK_ACCOUNT_PERSONAL 企业对公户： BANK_ACCOUNT_CORPORATE 法人银行卡：BANK_ACCOUNT_PERSONAL_LEGA 只有当行业代码未400个体工商户时允许法人银行卡。

linked_acct_no

string

绑定银行帐号

必需

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

linked_bank_code

string

银行编码

可选

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

linked_brbank_name

string

对公账户开户行名

可选

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

linked_brbank_no

string

对公账户开户行号

可选

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

linked_phone

string

银行预留手机号

可选

个人用户绑定银行卡时或企业用户绑定账户类型为法人银行卡时必输需要加密

password

string

支付密码

必需

支付密码。6-12位的字母、数字，不可以是连续或者重复的数字和字母，正则：^[a-zA-Z0-9]{6,12}$。通过密码控件加密成密文传输。

random_key

string

密码随机因子key

必需

密码随机因子key。随机因子获取接口返回，或弹框控件回调函数返回。

{
  "mch_id": "string",
  "user_id": "string",
  "txn_seqno": "string",
  "txn_time": "string",
  "notify_url": "string",
  "risk_item": "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_phone": "string"
  },
  "password": "string",
  "random_key": "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

系统唯一交易流水号

可选

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

token

string

授权令牌

可选

请求受理成功时返回。授权令牌。绑定账户类型是法人银行卡时验证使用，有效期30分钟。

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