标准绑卡·预绑

标准绑卡第一步，提交银行卡与持卡人信息获取预签约唯一码 sign_unique_code，须与标准绑卡·确认成对调用。bank_card_no、real_name、identity_document_no、mobile 及贷记卡 CVV/有效期等为敏感字段，请求须数字信封加密。risk_control_info 非必填，有值时须传真实交易信息。

接口说明

请求方式：【POST】/v1/protocol/bind-card

请求域名：【主域名】https://api.baofu.com

请求参数

Header 参数

参数名 类型 必填 描述
Authorization string true 请参考【开发指引-整体说明】生成认证信息
Accept string true 请设置为 application/json
Content-Type string true 请设置为 application/json

Body 参数

参数名 类型 必填 描述
bank_card_type string true 银行卡类型，101 借记 / 102 贷记，见 bank_card_type 枚举
bank_card_no string true 银行卡号，13～20 字符；敏感字段，请求由商户数字信封加密
real_name string true 持卡人姓名，1～128 字符；敏感字段，请求由商户数字信封加密
identity_document_no string true 证件号，15～64 字符；敏感字段，请求由商户数字信封加密
mobile string true 手机号，≤20 字符；敏感字段，请求由商户数字信封加密
identity_document_type string false 证件类型，默认 01（身份证）
credit_card_security_code string false 信用卡 CVV，3～4 字符；bank_card_type=102 时必填；敏感字段，请求由商户数字信封加密
credit_card_expire_date string false 有效期 MM/YY，≤7 字符；bank_card_type=102 时必填；敏感字段，请求由商户数字信封加密
merchant_user_id string false 商户用户 ID，≤50 字符，选填
risk_control_info object false 风控参数，键值对结构；按商户开通行业传真实交易信息，禁止固定占位值

risk_control_info 为键值对对象，标准绑卡预绑非必填；须按商户开通行业传真实交易信息，禁止固定占位值。

请求示例

{
  "bank_card_type": "101",
  "identity_document_type": "01",
  "bank_card_no": "6222021234567890123",
  "real_name": "张三",
  "identity_document_no": "110101199001011234",
  "mobile": "13800138000",
  "merchant_user_id": "U998877",
  "risk_control_info": {
    "goodsCategory": "06",
    "userLoginId": "U998877",
    "userMobile": "13800138000",
    "chPayIp": "203.0.113.10"
  }
}

应答参数

200 OK

参数名 类型 必填 描述
trade_status string true 一般为 SUCCESS
trade_status_desc string false 如「预绑成功」
sign_unique_code string true 预签约唯一码；确认绑卡时回传

应答示例

200 OK

{
  "trade_status": "SUCCESS",
  "trade_status_desc": "预绑成功",
  "sign_unique_code": "202606091430220001234567"
}

错误码

公共错误码

状态码 错误码 描述 解决方案
401 SIGN_ERROR 验证不通过 请参阅【开发指引-整体说明】排查签名
400 PARAM_ERROR 参数错误 请根据错误提示正确传入参数
500 SYSTEM_ERROR 系统异常，请稍后重试 请稍后重试