绑卡成功通知

用户于 H5 收银台、页面签约或一键绑卡完成绑卡后,宝付向绑卡 H5 收银台跳转等进线时上送的 notify_url 发起 HTTP 通知(JSON Body + Header 验签)。payment_protocol_no 为敏感字段,Body 内为密文 hex,须配合 Header 数字信封解密。明文 payment_protocol_no 可用于后续协议支付。

接口说明

请求方式:【POST】商户 notify_url

请求域名:商户在进线请求中上送的回调地址

请求参数

Header 参数

通知请求头与异步通知说明中的 Header 参数相同。

Body 参数

参数名 类型 必填 描述
trade_status string true 绑卡结果,成功为 SUCCESS
out_trade_no string true 商户订单号(进线 out_trade_no / msg_id)
channel_order_no string false 宝付前置单号,可空
payment_protocol_no string true 支付协议号;敏感字段,Body 为密文,须解密
merchant_user_id string false 商户用户 ID
bank_code string false 银行编码
bank_name string false 银行名称
bank_card_type string false 银行卡类型:101 借记 / 102 贷记;有值时返回

通知示例

{
  "trade_status": "SUCCESS",
  "out_trade_no": "MCH20260622001",
  "channel_order_no": "20260622143022000123456789012345",
  "payment_protocol_no": "Y202607041529484460000579682",
  "merchant_user_id": "user_001",
  "bank_code": "ICBC",
  "bank_name": "工商银行",
  "bank_card_type": "101"
}

处理建议:验签通过后处理业务;须应答 HTTP 状态码 200,响应体为字符串 OK;否则系统按固定频率重试。须按 out_trade_no(或约定业务单号)幂等。