首頁/公告與教學/冪等、回調與重複發貨
可靠性

冪等、回調與重複發貨

2026-10-01 · 5 分鐘閱讀

三個必須冪等的地方

  1. 建立訂單:用業務單號 + 行號產生冪等鍵,重複提交回傳同一結果。
  2. 支付回調:先查訂單當前狀態,非待支付狀態直接回傳成功。
  3. 上游回調:按上游單號定位本地訂單,重複推送覆蓋但不重複出庫。

回調之外一定要有輪詢

Webhook 會丟、會被防火牆攔、會因為你的服務重啟而錯過。處理中的訂單必須有一條定時輪詢的兜底路徑。

查不到就別動

上游回傳失敗時,不要把訂單直接改成「失敗」——先標記待確認,留給人工或下一次輪詢。