Appearance
退款订单通知 ¶
提示
消息通知的接收和处理方式请参考回调和订阅消息接收
通知时机 ¶
当退款订单状态发生变化时,系统会主动将退款订单状态变化通知到商户的接收地址上。注意:发起退款时,出现退款失败时不会触发通知
支付状态 | 描述 | 是否通知 |
---|---|---|
退款中 | 退款中不会推送通知 | 否 |
退款成功 | 退款成功后会推送通知 | 是 |
退款失败 | 退款失败时会推送通知,但发起退款时返回的失败不会推送通知 | 是 |
注意事项 ¶
- 回调地址必须可被支付网关访问
- 回调地址仅支持http与https协议
- 如果要对回调消息验签,参照数据验签文档进行验签
通知参数 ¶
通知示例 ¶
json
{
"noticeType": "refund",
"mchNo": "M1723635576766",
"appId": "M8207639754663343",
"code": 0,
"msg": "success",
"data": {
"orderId": "1911366655705894912",
"orderNo": "DEV_P2025041318313670000003",
"outOrderNo": "2025041322001404211436125851",
"bizOrderNo": "PAY_65080159831744540293248",
"title": "测试支付",
"refundNo": "DEV_R2025041318421670000005",
"bizRefundNo": "REFUND_69613599721744540898044",
"channel": "ali_pay",
"orderAmount": 0,
"amount": 0.01,
"reason": "测试退款",
"finishTime": "2025-04-13 18:42:19",
"status": "success",
"clientIp": "127.0.0.1"
},
"sign": "4342ec219baf302dfa8d02c5799b06aa",
"resTime": "2025-04-13 18:42:59",
"traceId": "lX0IF6BL3bBS"
}