支付订单通知

提示

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

通知时机

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

支付状态	描述	是否通知
支付创建	创建支付单或者通过修复从其他状态变更为支付中，不会推送通知	否
支付成功	支付完成后会推送通知	是
支付失败	发起支付时，出现支付失败时不会触发通知	是
支付关闭	当支付单被关闭时，会推送通知	是
退款中	会在对应的退款单发起通知	否
部分退款	会在对应的退款单发起通知	否
全部退款	会在对应的退款单发起通知	否

注意事项

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

通知参数

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

通知示例

{
    "noticeType": "pay",
    "mchNo": "M1723635576766",
    "appId": "M8207639754663343",
    "code": 0,
    "msg": "success",
    "data": {
        "bizOrderNo": "PAY_73071205311744540022795",
        "orderNo": "DEV_P2025041318273870000001",
        "outOrderNo": "2025041322001404211433969407",
        "title": "测试支付",
        "allocation": false,
        "autoAllocation": false,
        "channel": "ali_pay",
        "method": "qrcode",
        "amount": 0.01,
        "refundableBalance": 0.01,
        "status": "success",
        "refundStatus": "no_refund",
        "payTime": "2025-04-13 18:28:39",
        "expiredTime": "2025-04-13 22:57:02"
    },
    "sign": "a66d9b81bd3ea9d0b7b83c4ca4152bff",
    "resTime": "2025-04-13 18:30:07",
    "traceId": "lNkIuFbydMUx"
}

通知接收

可以使用SDK对接收到的通知内容进行反序列和验签，简化消息通知的处理流程。可以使用PayNoticeModel支付通知实体类来接收数据，并可以方便的使用SDK进行验签

接收