支付订单通知

通知方式

参数	说明
请求方式	POST
请求类型	application/json
客户系统应答值	大写 SUCCESS 字符串

通知规则

当满足下列通知时机时，系统会将支付订单状态变化通知到商户的接收地址上。商户需要接收处理该消息并返回应答。

如果收到客户系统的应答不符合规范或超时，支付网关会认为通知失败，并通过一定的策略定期重新发起通知，尽可能提高通知的成功率，但不保证通知最终能成功。 （通知频率为15s/15s/30s/3m/10m/20m/30m/30m/30m/60m/3h/3h/3h/6h/6h- 总计 24h4m）

通知时机

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

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

注意事项

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

通知参数

字段名	变量名	必传	类型	示例值	描述
支付订单号	orderNo	是	String	1753370980523384832	系统生成的订单号

通知示例

通知接收

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

接收

package org.dromara.daxpay.single.demo.controller;

import cn.bootx.platform.common.core.annotation.IgnoreAuth;
import org.dromara.daxpay.single.sdk.model.notice.PayNoticeModel;
import org.dromara.daxpay.single.sdk.model.notice.RefundNoticeModel;
import io.swagger.v3.oas.annotations.Operation;
import io.swagger.v3.oas.annotations.tags.Tag;
import lombok.RequiredArgsConstructor;
import lombok.extern.slf4j.Slf4j;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

import java.util.Map;

/**
 *
 * @author xxm
 * @since 2024/2/24
 */
@Slf4j
@IgnoreAuth
@Tag(name = "回调测试")
@RestController
@RequestMapping("/demo/callback")
@RequiredArgsConstructor
public class ClientNoticeReceiveController {
    private final DaxPayDemoProperties daxPayDemoProperties;
   
    @Operation(summary = "支付消息(map接收)")
    @PostMapping("/pay")
    public String pay(@RequestBody Map<String,Object> map){
        log.info("接收到支付回调消息: {}",map);
        // 转换为对象
        PayNoticeModel bean = BeanUtil.toBean(map, PayNoticeModel.class);
        log.info("验签结果: {}", PaySignUtil.hmacSha256Sign(bean, daxPayDemoProperties.getSignSecret()));
        return "SUCCESS";
    }


    @Operation(summary = "支付消息(对象接收)")
    @PostMapping("/payObject")
    public String pay(@RequestBody PayNoticeModel model){
        log.info("接收到支付回调消息: {}",model);
        log.info("验签结果: {}", PaySignUtil.hmacSha256Sign(model, daxPayDemoProperties.getSignSecret()));
        return "SUCCESS";
    }

}

验签

// MD5方式验签
PaySignUtil.verifyMd5Sign(model, "123456", model.getSign());
// HmacSha256方式验签
PaySignUtil.verifyHmacSha256Sign(model, "123456", model.getSign());