5.1.2.1 快捷绑卡请求 - 汇联开放平台

请求参数

Body 参数application/json

appId

string

应用APPID

必需

商户应用APPID

subSn

string | null

子商户编码

可选

非必传项，目前仅代理商/服务商可传，普通商户和平台商户请勿传入

timestamp

string

时间戳

必需

请求时间戳单位秒，要求timestamp与当前时间间隔在60秒以内

requestId

string

请求id

必需

请求唯一标识，无其他意义，必须每一次请求不允许重复，用于定位问题

signType

string

签名方式

必需

固定值：RSA2

bizContent

object

请求参数

必需

由于工具限制，该字段必须转为JSON 格式字符串，请注意

mchChannelCode

string

子通道code

必需

mchOrderNo

string

商户绑卡订单号

必需

规则英文字符,数字,_

userNo

string

用户标识

必需

必须保证每个支付用户唯一，绑卡的标识性数据。形成绑卡关系后，卡会绑定在这个用户标识下，同一用户不要反复注册

bankCardNo

string

银行卡号

必需

目前仅支持ipv4

userName

string

持卡人姓名

必需

不能超过64个字符

idCardNo

string

持卡人身份证号

必需

必须填写身份证号码，且与开卡信息一致

mobileNo

string

银行卡绑定手机号

可选

必须保证是【银行预留手机号】，联系人电话等信息不一定能通过鉴权

cardType

string

卡类型

必需

1=贷记卡，2=借记卡，3=均支持

certValidityType

integer

证件有效期类型

必需

1：长期有效；0：非长期有效

certBeginDate

string

有效期开始日期

必需

格式为：2024-12-31

certEndDate

string

有效期截止日期

可选

格式为：2024-12-31，非长期有效必传

默认值:

null

示例值:

null

cvv2

string

CVV2

可选

信用卡背面 3 位数字

expiration

string

卡有效期

可选

信用卡必填

sign

string

签名

必需

参照签名方法

示例

{
  "appId": "string",
  "subSn": "string",
  "timestamp": "string",
  "requestId": "string",
  "signType": "string",
  "bizContent": {
    "mchChannelCode": "string",
    "mchOrderNo": "string",
    "userNo": "string",
    "bankCardNo": "string",
    "userName": "string",
    "idCardNo": "string",
    "mobileNo": "string",
    "cardType": "string",
    "certValidityType": 0,
    "certBeginDate": "string",
    "certEndDate": "null",
    "cvv2": "string",
    "expiration": "string"
  },
  "sign": "string"
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

返回响应

🟢200成功

application/json

Body

code

integer

请求状态

必需

返回200=成功，其他状态均为失败

data

object

返回数据体

必需

mchOrderNo

string

商户绑卡订单号

必需

payOrderNo

string

平台绑卡订单号

必需

mchChannelCode

string

子通道code

可选

userNo

string

用户标识

可选

bindId

string

绑卡ID

可选

无短验情况下，直接返回绑卡ID

signStatus

integer

签约状态

可选

目前仅易宝返回，签约状态,若返回空代表签约状态未知。1=已签约，0=未签约

msg

string

返回信息

可选

appId

string

应用APPID

必需

sn

string

商户编码

可选

sign

string

签名

必需

timestamp

string

时间戳

必需

signType

string

签名方式目前仅支持RSA2

必需

示例

{
  "code": 0,
  "data": {
    "mchOrderNo": "string",
    "payOrderNo": "string",
    "mchChannelCode": "string",
    "userNo": "string",
    "bindId": "string",
    "signStatus": 0
  },
  "msg": "string",
  "appId": "string",
  "sn": "string",
  "sign": "string",
  "timestamp": "string",
  "signType": "string"
}