绑卡查询

按银行卡号（及可选 merchant_user_id）查询有效绑卡协议列表。bank_card_no 为敏感字段，请求须数字信封加密；响应 payment_protocols[].payment_protocol_no 为敏感字段，须解密。无绑卡记录时 success=false，code=TRADE_ERROR。

接口说明

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

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

请求参数

Header 参数

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

Body 参数

参数名	类型	必填	描述
merchant_user_id	string	false	商户用户 ID，≤50 字符，选填；有值时与银行卡号组合查询有效协议
bank_card_no	string	true	银行卡号，13～19 字符；敏感字段，请求由商户数字信封加密

payment_protocols[] 元素字段：payment_protocol_no（敏感，响应加密）、merchant_user_id、bank_code、bank_name、bank_card_type（101 借记 / 102 贷记，integer）

请求示例

{
  "merchant_user_id": "U998877",
  "bank_card_no": "6222021234567890123"
}

应答参数

200 OK

参数名	类型	必填	描述
trade_status	string	true	一般为 SUCCESS
trade_status_desc	string	false	如「查询成功」
payment_protocols	array	false	有效协议列表，元素含 payment_protocol_no、merchant_user_id、bank_code、bank_name、bank_card_type

应答示例

200 OK

{
  "trade_status": "SUCCESS",
  "trade_status_desc": "查询成功",
  "payment_protocols": [
    {
      "payment_protocol_no": "20250608143022000123456789012345",
      "merchant_user_id": "U998877",
      "bank_code": "ICBC",
      "bank_name": "中国工商银行",
      "bank_card_type": 101
    }
  ]
}

错误码

公共错误码

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

应答示例

失败

{
  "code": "TRADE_ERROR",
  "message": "无绑卡记录"
}