标准绑卡·确认

预绑成功后，商户上送短信验证码完成绑卡确认，取得支付协议号。

接口说明

请求方式：【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(64)	true	预绑返回的 `sign_unique_code`
sms_code	string(16)	false	【短信验证码】开通短信验证时必填

请求示例

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

应答参数

200 OK

参数名	类型	必填	描述
trade_status	string	true	一般为 `SUCCESS`
trade_status_desc	string	true	如「绑卡成功」
payment_protocol_no	string	true	支付协议号，用于签约扣款路径；敏感字段，响应密文须解密
bank_code	string	true	银行编号
bank_name	string	true	银行名称

应答示例

200 OK

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

错误码

公共错误码

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

业务错误码

状态码	错误码	描述	解决方案
402	TRADE_ERROR	业务失败	确认失败（如短信验证码错误、预绑信息已失效）