退款结果通知

接口说明

请求方式：【POST】商户 notify_url

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

请求参数

Header 参数

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

Body 参数

参数名 类型 必填 描述
event_type string true WALLET_REFUND
refund_no string true 平台退款单号
out_refund_no string true 商户退款单号
original_trade_no string true 原平台扣款单号
original_out_trade_no string true 原商户扣款订单号
refund_amount integer true 金额（分）
refund_status string true SUCCESS / FAIL
error_message string false 仅失败时有值；成功时不下发
create_time string true 通知创建时间，ISO 8601
order_finish_time string false 订单完成时间；成功或失败时有值

通知示例

{
  "event_type": "WALLET_REFUND",
  "refund_no": "5101010120260730120000000001",
  "out_refund_no": "RF202607300001",
  "original_trade_no": "4101010120250525120000000001",
  "original_out_trade_no": "DED202505250001",
  "refund_amount": 1,
  "refund_status": "SUCCESS",
  "create_time": "2026-07-30T12:01:00+08:00",
  "order_finish_time": "2026-07-30T12:01:00+08:00"
}

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