
本文以假設流程說明設計方法,並非客戶案例。
- 保存事件
- 安全處理與重試
- 定期核對
請求逾時後,先查對方有沒有開單
兩個系統都正常運作,交接資料時仍可能漏了一次。請求逾時尤其難判斷:對方可能已寫入資料,只是未回覆;這時重送,就可能開出兩張單。接駁記錄要分清收到通知、開始處理和確認結果,才有依據決定下一步,也避免因不敢重試而漏單。
連接工具有沒有重試和補跑?
檢查現有連接工具有沒有錯誤記錄、重試和補跑功能。Stripe 的 Webhook 文件也列出重複及次序問題;自行接駁時,要按各平台規則處理,不能假設每個通知只來一次,或一定依序送達。
記住每個事件處理到哪一步
先處理一條重要流程,驗證通知來源並保存事件編號,再排隊執行。失敗的項目要顯示原因,重試前先查動作是否已完成。未能自動復原的記錄,讓同事按既定程序跟進,並定期與來源系統對數,找出漏掉的部分。
重播一次,會不會再扣款?
把同一事件重播一次,確認不會再次扣款或發貨,再試通知次序顛倒、接口限流、對方停機和逾時。工作只完成一部分時,也要知道如何接着處理。驗收時要找得到真正漏掉的記錄、能補回,通知亦能讓同事判斷哪些失敗需要跟進。
整理一次失敗的處理記錄
準備已刪去個人資料的事件時間及處理記錄、接口文件、錯誤訊息,以及正常結果的例子。