跳到正文
D13-04开放 API1 分钟更新于 2026-11

回调设计

一句话

验签、重试、容忍乱序,三件事缺一不可。

本文目录8 节

回调设计

它解决什么

回调要满足三件事:验签、重试、容忍乱序。验签防伪造,重试防丢单,容忍乱序防状态回退。回调还是「通知」不是「事实来源」——最终状态以主动查询为准。很多开放平台回调只发一次,商户侧一次网络抖动就永久掉单,只能靠人工补。回调设计的三个要点,缺一个就会掉单。

怎么用

  • 验签
  • 递增间隔重试
  • 按版本容忍乱序
  • 最终以查询为准

一个判断

某开放平台回调只发一次,商户一次网络抖动就永久掉单,月底对账差 200 笔。

边界

回调的边界是「可控」:回调到达时间不受你控制,业务不能依赖回调的实时性。

一个反例

某开放平台回调只发一次,商户一次网络抖动就永久掉单,月底对账差 200 笔。现在回调重试 5 次,并提供查单接口。

常见误判

  • 回调只发一次。

自查清单

  • 知道这个模块的边界在哪
  • 知道它的状态机有哪几个状态
  • 知道它出错时的兜底路径
  • 知道它的数据存在哪张表

依据

  • 开放接口的回调规范。

相关:开放 API 的四件事要同时成立

相关阅读