API 事件 / API 參考

Webhook 事件

接收非同步審查和交換更新，而不會遺失簽名、重試、排序或證據上下文。

狀態私有預覽

適用對象後端工程、平台運營

負責團隊UWAY 工程團隊

審核日期2026-08-02

交付模式

當同步回應後審查、證據狀態或合作夥伴交換發生變化時，Webhook 事件會通知租戶。僅在持久性儲存事件後才會返回成功狀態。

在私有預覽期間，確切的簽名標頭、重試計劃、事件目錄和來源網路控制是特定於租用戶的。

事件範例

{
  "event_id": "evt_a81c29f4",
  "event_type": "screening.review_completed",
  "created_at": "2026-08-02T10:15:30Z",
  "data": {
    "transaction_id": "txn_8f72b1c4e5d9",
    "uway_reference": "scr_7d3a91c2",
    "status": "approved",
    "reason_codes": ["ANALYST_REVIEW_COMPLETE"]
  }
}

接收器控制

在簽名驗證所需的 JSON 轉換之前讀取原始請求正文。
驗證配置的簽章和時間戳容差。
拒絕無效簽章而不處理事件。
持久性儲存事件 ID 和負載。
在儲存後返回成功，而不是在每個下游工作流程完成後返回。
使用事件 ID 冪等處理事件。

排序和重複

不要假設事件一次到達或嚴格按照業務順序到達。在套用變更之前比較事件時間和目前物件狀態。保留重複的運輸證據，同時防止重複的業務操作。

失敗和重播

監控交付失敗並提供操作重播流程。重播事件必須使用原始事件標識或明確重播引用，以便接收方可以區分傳輸重試和新業務狀態。