退款终态通知

退款进线时传入 notify_url，退款到达终态后宝付 POST 裸 JSON 至商户；JSON Body + Header 验签。

接口说明

请求方式：【POST】商户 notify_url

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

请求参数

Header 参数

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

Body 参数

参数名 类型 必填 描述
refund_status string true 终态，SUCCESS / FAILED
out_refund_no string true 商户退款单号
out_trade_no string false 原支付商户订单号，可空
refund_no string false 宝付退款流水号，可空
refund_total_amount integer false 退款金额，单位分
refund_finish_time string false 退款完成时间 yyyyMMddHHmmss，可空；成功且有值时返回

通知示例

{
  "refund_status": "SUCCESS",
  "out_refund_no": "REF20260622001",
  "out_trade_no": "20260609120001001",
  "refund_no": "20251218173125013031185289875340",
  "refund_total_amount": 100,
  "refund_finish_time": "20260720143000"
}

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