大部分接入方只用同步返回,这在小规模下没问题。但一旦出现「核销发生在你的系统之外」—— 比如商家在平台后台直接核了、或顾客在其他终端核了 —— 你就需要一个被动通知的通道。

一、同步返回覆盖不到什么

场景同步返回够吗
你的系统发起核销够,返回值就是结果
商家在平台后台核销不够,你不知道发生了什么
顾客在其他系统核销不够
撤销由平台侧发起不够
需要与其他系统对账不够,只能靠拉取

所以回调/事件推送的价值不在「替代同步返回」,而在「覆盖同步返回看不到的部分」。

二、回调设计必须处理的四件事

1. 重复投递

事件推送通常是「至少一次」语义,同一条事件可能来多次。你的处理必须幂等:用事件ID 或业务唯一键去重,重复的直接忽略。

2. 乱序

核销与撤销的事件可能乱序到达。不要假设「后收到的就是后发生的」—— 用事件里的业务时间或版本号判断,晚到但更早的事件不应覆盖状态。

3. 签名校验

回调地址是公开可访问的,必须验证来源:

  • 校验签名或 token,不要只看请求体里的字段像不像
  • 校验时间戳,拒绝过旧请求(防重放)
  • 使用 HTTPS,回调地址不要带可猜测的路径
  • 不要在处理逻辑里做耗时操作,先快速响应再异步处理

4. 失败重试

你的回调接口返回非成功状态时,服务方通常会重试。因此回调必须:

  • 先落库再处理,响应要快
  • 处理失败不要返回成功 —— 否则这条事件就永久丢了
  • 对重试次数有心理准备,重试可能持续较长时间
  • 记录每次回调的原始请求体,便于事后排查

三、什么时候该用轮询兜底

回调有丢失可能(地址不可达、连续失败后放弃)。所以稳妥的做法是「回调为主 + 轮询兜底」:

方式延迟成本可靠性
同步返回即时低仅覆盖自己发起的操作
事件推送秒级低依赖你的回调可用性
定时轮询取决于周期较高(请求量固定)最稳,但慢

常见组合:关键操作同步返回 + 事件推送实时感知 + 每日轮询对账。三者互补,不冲突。

四、实现清单

  • 回调接口独立于业务接口,单独限流
  • 验签失败返回明确错误,不要静默丢弃
  • 按事件ID 去重,去重记录保留足够长时间
  • 按业务时间戳处理乱序,维护券状态机
  • 原始请求体落库,保留 30 天以上
  • 监控回调成功率,异常时告警
  • 定期与轮询结果交叉核对

五、用聚合接口时的回调

走聚合接口时,回调的作用略有不同 —— 因为核销大多由你的系统发起,同步返回已足够。回调更有价值的场景是:

  • 多终端核销:收银端、自助机、小程序并发操作时的状态同步
  • 异步任务完成通知:比如批量核销的处理结果
  • 计费与额度提醒:额度将尽、账单生成
  • 授权状态变化:门店授权失效的主动通知

如果你的场景是单终端、自己发起自己处理,先不用做回调 —— 同步返回加每日对账就够。别为了架构好看增加一个要维护的异步链路。

常见问题

回调丢了怎么办?

靠轮询兜底。每日对账时把平台侧记录与本地比对,缺失的补录。这是兜底而不是主要手段。

回调能不能只在核销成功时推?

取决于服务方能力。如果只推成功事件,那失败与异常仍需靠同步返回和轮询发现。

回调地址能填内网地址吗?

不能。必须是公网可达的 HTTPS 地址。内网系统需要在外层做转发,并做好鉴权。