Webhooks 异步通知

为了便于客户系统处理交易信息,本系统支持 Webhooks 功能,可以把特定的事件结果推送到指定的地址以便于客户做后续处理。

目前支持的事件包括:

  • 周期性交易汇总信息
  • 支付结果
  • 退款结果
  • 订单关闭

通知类型说明

通知类型 介绍
order.succeeded 订单支付通知
order.closed 订单关闭通知
refund.succeeded 订单退款通知
summary.daily.available 上一天 0 点到 23 点 59 分 59 秒的交易金额和交易量统计
summary.weekly.available 上周一 0 点至上周日 23 点 59 分 59 秒的交易金额和交易量统计,在每周一触发
summary.monthly.available 上月一日 0 点至上月末 23 点 59 分 59 秒的交易金额和交易量统计,在每月一日触发

注意事项

  • 接收通知的服务器请在3秒钟内响应(http状态码200则标记通知成功,其它状态码则标记通知失败,推送结束)
  • 为保障推送到达率,系统可能多次进行通知推送,请做好去重逻辑
  • 推送可能增加参数,请做好冗余处理,勿使用 hard code
  • 商户系统对于支付结果通知的内容一定要验签,并校验返回的订单金额是否与商户侧的订单金额一致

推送频率(秒)

  • 订单相关通知:0,15,30,180,1800,3600。超过1小时后如需推送,可以在后台手动补发
  • 交易汇总信息:相同,暂时不可后台补发

流程示例

$data = $_POST;

if($data['notify_type'] === 'order.succeeded'){
    // 1.验签逻辑

    // 2.验重逻辑

    // 3.自身业务逻辑

    // 4.返回 success 字符串(http状态码为200)
    echo 'success';
}