绑卡成功异步通知

用户完成绑卡 H5（或页面签约 / 一键绑卡）后，宝付向 190 绑卡 H5 收银台请求中上送的 notify_url 发 POST。Body 为裸 JSON（无 success/data 信封）。payment_protocol_no 为敏感字段，须配合通知 Header 数字信封解密后再用于签约扣款路径。

验签串与异步通知说明相同（timestamp + nonce + dgtl_envlp + body）。含协议号时数字信封必填。

接口说明

请求方式：【POST】商户 notify_url

请求域名：商户在 190 绑卡 H5 收银台请求中上送的回调地址

请求参数

Header 参数

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

Body 参数

解密后明文；实际上送 payment_protocol_no 为密文

参数名 类型 必填 描述
trade_status string true 成功为 SUCCESS
out_trade_no string true 商户订单号
channel_order_no string false 宝付前置单号，可空
payment_protocol_no string true 支付协议号；敏感字段
merchant_user_id string true 商户用户 ID
bank_code string true 银行编码
bank_name string true 银行名称
bank_card_type string true 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 幂等。