
本文以假设流程说明设计方法,并非客户案例。
- 保存事件
- 安全处理与重试
- 定期核对
请求超时后,先查对方有没有生成订单
两个系统都正常运行,交接数据时仍可能漏了一次。请求超时尤其难判断:对方可能已写入数据,只是还没有回复;这时重发,就可能生成两张订单。集成记录要分清收到通知、开始处理和确认结果,才有依据决定下一步,也避免因不敢重试而漏单。
集成工具是否支持重试和重新执行?
检查现有集成工具是否有错误日志、重试和重新执行功能。Stripe 的 Webhook 文档也说明了重复通知和到达顺序的问题。自行开发集成时,要按各平台的规则处理,不能假设通知只到达一次,或总是按顺序到达。
记住每个事件处理到哪一步
先处理一条重要流程,验证通知来源并保存事件编号,再排队执行。失败的项目要显示原因,重试前先查动作是否已完成。未能自动恢复的记录,让同事按既定程序跟进,并定期与来源系统核对数据,找出遗漏的部分。
重新执行一次,是否会再次扣款?
把同一事件重新执行一次,确认不会再次扣款或发货,再试通知顺序颠倒、接口限流、对方停机和超时。工作只完成一部分时,也要知道如何接着处理。验收时要找得到真正遗漏的记录、能补回,通知也能让同事判断哪些失败需要跟进。
整理一次失败的处理记录
准备去除个人信息的事件时间线、处理记录、接口文档、错误消息和正常结果的例子。