绑卡成功通知
用户于 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(或约定业务单号)幂等。