D13-04开放 API1 分钟更新于 2026-11
回调设计
一句话
验签、重试、容忍乱序,三件事缺一不可。
回调设计
它解决什么
回调要满足三件事:验签、重试、容忍乱序。验签防伪造,重试防丢单,容忍乱序防状态回退。回调还是「通知」不是「事实来源」——最终状态以主动查询为准。很多开放平台回调只发一次,商户侧一次网络抖动就永久掉单,只能靠人工补。回调设计的三个要点,缺一个就会掉单。
怎么用
- 验签
- 递增间隔重试
- 按版本容忍乱序
- 最终以查询为准
一个判断
某开放平台回调只发一次,商户一次网络抖动就永久掉单,月底对账差 200 笔。
边界
回调的边界是「可控」:回调到达时间不受你控制,业务不能依赖回调的实时性。
一个反例
某开放平台回调只发一次,商户一次网络抖动就永久掉单,月底对账差 200 笔。现在回调重试 5 次,并提供查单接口。
常见误判
- 回调只发一次。
自查清单
- 知道这个模块的边界在哪
- 知道它的状态机有哪几个状态
- 知道它出错时的兜底路径
- 知道它的数据存在哪张表
依据
- 开放接口的回调规范。
相关阅读