退款通知（REFUND）

退款终态时，向退款发起时上送的 notify_url 投递。未上送 notify_url 时不通知，不回落签约通知地址。

接口说明

请求方式：【POST】商户 notify_url

请求域名：商户在退款发起请求中上送的回调地址

  • event_type 固定为 REFUND

请求参数

Body 参数

参数名 类型 必填 描述
event_type string true 固定 REFUND
refund_no string true 平台退款订单号
out_refund_no string true 商户退款订单号
deduction_no string true 账单号
subscription_no string true 订阅号
out_trade_no string true 商户签约订单号（取自关联订阅）
refund_amount integer true 退款金额（分）
refund_status string true 退款终态：SUCCESS / FAILED（中间态不投递）
error_code string false 不下发（码只认统一网关外层 HTTP；细码仅落库 channel_*）
error_message string false 失败时必有；FI* 与渠道查单话术归一为「退款失败」；成功通知省略本字段
refund_time string false 退款成功时间，ISO 8601（可空）
create_time string false 创建时间，ISO 8601（可空）

通知示例

失败

{
  "event_type": "REFUND",
  "refund_no": "RF01010120260724120000000001",
  "out_refund_no": "MRF202607240001",
  "deduction_no": "DD01010120260319120000000001",
  "subscription_no": "SP01010120260319120000000001",
  "out_trade_no": "MCH202603190001",
  "refund_amount": 100,
  "refund_status": "FAILED",
  "error_message": "退款失败",
  "create_time": "2026-07-24T12:00:00+08:00"
}

通知示例

成功

{
  "event_type": "REFUND",
  "refund_no": "RF01010120260724120000000001",
  "out_refund_no": "MRF202607240001",
  "deduction_no": "DD01010120260319120000000001",
  "subscription_no": "SP01010120260319120000000001",
  "out_trade_no": "MCH202603190001",
  "refund_amount": 100,
  "refund_status": "SUCCESS",
  "refund_time": "2026-07-24T12:01:00+08:00",
  "create_time": "2026-07-24T12:00:00+08:00"
}

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