大部分接入方只用同步返回,这在小规模下没问题。但一旦出现「核销发生在你的系统之外」—— 比如商家在平台后台直接核了、或顾客在其他终端核了 —— 你就需要一个被动通知的通道。
一、同步返回覆盖不到什么
| 场景 | 同步返回够吗 |
|---|---|
| 你的系统发起核销 | 够,返回值就是结果 |
| 商家在平台后台核销 | 不够,你不知道发生了什么 |
| 顾客在其他系统核销 | 不够 |
| 撤销由平台侧发起 | 不够 |
| 需要与其他系统对账 | 不够,只能靠拉取 |
所以回调/事件推送的价值不在「替代同步返回」,而在「覆盖同步返回看不到的部分」。
二、回调设计必须处理的四件事
1. 重复投递
事件推送通常是「至少一次」语义,同一条事件可能来多次。你的处理必须幂等:用事件ID 或业务唯一键去重,重复的直接忽略。
2. 乱序
核销与撤销的事件可能乱序到达。不要假设「后收到的就是后发生的」—— 用事件里的业务时间或版本号判断,晚到但更早的事件不应覆盖状态。
3. 签名校验
回调地址是公开可访问的,必须验证来源:
- 校验签名或 token,不要只看请求体里的字段像不像
- 校验时间戳,拒绝过旧请求(防重放)
- 使用 HTTPS,回调地址不要带可猜测的路径
- 不要在处理逻辑里做耗时操作,先快速响应再异步处理
4. 失败重试
你的回调接口返回非成功状态时,服务方通常会重试。因此回调必须:
- 先落库再处理,响应要快
- 处理失败不要返回成功 —— 否则这条事件就永久丢了
- 对重试次数有心理准备,重试可能持续较长时间
- 记录每次回调的原始请求体,便于事后排查
三、什么时候该用轮询兜底
回调有丢失可能(地址不可达、连续失败后放弃)。所以稳妥的做法是「回调为主 + 轮询兜底」:
| 方式 | 延迟 | 成本 | 可靠性 |
|---|---|---|---|
| 同步返回 | 即时 | 低 | 仅覆盖自己发起的操作 |
| 事件推送 | 秒级 | 低 | 依赖你的回调可用性 |
| 定时轮询 | 取决于周期 | 较高(请求量固定) | 最稳,但慢 |
常见组合:关键操作同步返回 + 事件推送实时感知 + 每日轮询对账。三者互补,不冲突。
四、实现清单
- 回调接口独立于业务接口,单独限流
- 验签失败返回明确错误,不要静默丢弃
- 按事件ID 去重,去重记录保留足够长时间
- 按业务时间戳处理乱序,维护券状态机
- 原始请求体落库,保留 30 天以上
- 监控回调成功率,异常时告警
- 定期与轮询结果交叉核对
五、用聚合接口时的回调
走聚合接口时,回调的作用略有不同 —— 因为核销大多由你的系统发起,同步返回已足够。回调更有价值的场景是:
- 多终端核销:收银端、自助机、小程序并发操作时的状态同步
- 异步任务完成通知:比如批量核销的处理结果
- 计费与额度提醒:额度将尽、账单生成
- 授权状态变化:门店授权失效的主动通知
如果你的场景是单终端、自己发起自己处理,先不用做回调 —— 同步返回加每日对账就够。别为了架构好看增加一个要维护的异步链路。
常见问题
回调丢了怎么办?
靠轮询兜底。每日对账时把平台侧记录与本地比对,缺失的补录。这是兜底而不是主要手段。
回调能不能只在核销成功时推?
取决于服务方能力。如果只推成功事件,那失败与异常仍需靠同步返回和轮询发现。
回调地址能填内网地址吗?
不能。必须是公网可达的 HTTPS 地址。内网系统需要在外层做转发,并做好鉴权。