标准绑卡·确认

标准绑卡第二步，使用预绑返回的 sign_unique_code 及短信验证码（若商户开通短信验证）完成绑卡，成功后返回 payment_protocol_no 用于后续协议支付。payment_protocol_no 为敏感字段，响应由统一网关数字信封加密、商户解密。

接口说明

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

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

请求参数

Header 参数

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

Body 参数

参数名	类型	必填	描述
sign_unique_code	string	true	预绑返回的 sign_unique_code，1～64 字符
sms_code	string	false	短信验证码，4～16 字符；若商户开通短信验证则必填，未开通可不传

请求示例

{
  "sign_unique_code": "202606091430220001234567",
  "sms_code": "123456"
}

应答参数

200 OK

参数名	类型	必填	描述
trade_status	string	true	一般为 SUCCESS
trade_status_desc	string	false	如「绑卡成功」
payment_protocol_no	string	true	支付协议号，用于协议支付；敏感字段，响应由统一网关数字信封加密、商户解密
bank_code	string	false	银行编号
bank_name	string	false	银行名称

应答示例

200 OK

{
  "trade_status": "SUCCESS",
  "trade_status_desc": "绑卡成功",
  "payment_protocol_no": "20250608143022000123456789012345",
  "bank_code": "ICBC",
  "bank_name": "中国工商银行"
}

错误码

公共错误码

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