标准绑卡·预绑

商户自有页面收集卡要素，发起标准绑卡预绑；须与标准绑卡·确认成对调用。商户自有页面收集卡要素，发起标准绑卡预绑；须与标准绑卡·确认成对调用。

接口说明

请求方式：【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`；银行卡类型，`101` 借记卡 / `102` 贷记卡
bank_card_no	string(20)	true	银行卡号（敏感字段，须数字信封加密）
real_name	string(128)	true	持卡人姓名（敏感字段，须数字信封加密）
identity_document_no	string(64)	true	证件号（敏感字段，须数字信封加密）
mobile	string(20)	true	手机号（敏感字段，须数字信封加密）
identity_document_type	string	false	默认 `01`；证件类型，默认身份证
credit_card_security_code	string(4)	false	【信用卡 CVV】`bank_card_type=102` 时必填（敏感字段，须数字信封加密）
credit_card_expire_date	string(7)	false	【有效期】格式 `MM/YY`；`bank_card_type=102` 时必填（敏感字段，须数字信封加密）
merchant_user_id	string(50)	false	商户用户 ID
risk_control_info	object	false	风控参数，键值对；按开通行业传真实交易信息，禁止占位值

请求示例

加密前明文

{
  "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	true	如「预绑成功」
sign_unique_code	string	true	预签约唯一码；确认绑卡时回传

应答示例

200 OK

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

错误码

公共错误码

状态码	错误码	描述	解决方案
400	PARAM_ERROR	参数校验失败	必填参数缺失或格式不合法
401	SIGN_ERROR	验证不通过	请参阅【开发指引-整体说明】排查签名
500	SYSTEM_ERROR	系统异常	内部系统错误

业务错误码

状态码	错误码	描述	解决方案
402	TRADE_ERROR	业务失败	预绑失败（如银行卡信息校验未通过）