Skip to content

退款订单通知

提示

消息通知的接收和处理方式请参考回调和订阅消息接收

通知时机

当退款订单状态发生变化时,系统会主动将退款订单状态变化通知到商户的接收地址上。注意:发起退款时,出现退款失败时不会触发通知

支付状态描述是否通知
退款中退款中不会推送通知
退款成功退款成功后会推送通知
退款失败退款失败时会推送通知,但发起退款时返回的失败不会推送通知

注意事项

  1. 回调地址必须可被支付网关访问
  2. 回调地址仅支持http与https协议
  3. 如果要对回调消息验签,参照数据验签文档进行验签

通知参数

数据格式见回调和订阅消息接收, 业务数据格式与查询退款订单中的数据格式一致

通知示例

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"
}
本文档内容版权属于济南易杯光年软件技术有限公司