支付终态通知

协议支付进线时传入 notify_url，支付到达终态后宝付 POST 裸 JSON（无 success/code/data 信封）至商户；JSON Body + Header 验签。支付/退款终态 Body 通常无敏感字段。

接口说明

请求方式：【POST】商户 notify_url

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

请求参数

Header 参数

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

Body 参数

参数名 类型 必填 描述
trade_status string true 终态，SUCCESS / FAILED
out_trade_no string true 商户订单号
channel_order_no string false 宝付渠道订单号，可空
payment_total_amount integer false 成功金额，单位分
trade_finish_time string false 完成时间 yyyyMMddHHmmss，可空

通知示例

{
  "trade_status": "SUCCESS",
  "out_trade_no": "20260609120001001",
  "channel_order_no": "20251218173125013031185289875340",
  "payment_total_amount": 100,
  "trade_finish_time": "20260609120001"
}

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