錯誤

​

錯誤結構

{
  "errors": [
    {
      "message": "Offer out of stock",
      "extensions": {
        "code": "GC-0009",
        "path": ["purchaseGiftCard"],
        "requestId": "req_01H...Offer out of stock",
      "code": "GC-0009",
      "path": ["purchaseGiftCard"]
    }
  ]
}

• AUTH-* — 驗證與權杖問題
• BS-* — 一般商務 / 驗證錯誤
• GC-* — 禮品卡操作
• VC-* — 虛擬卡操作

​

網域錯誤代碼

​

疑難排解

1. 檢查 AUTH-* 的 scope。這幾乎都表示權杖在簽發時缺少必要的 scope；請重新簽發新的權杖。
2. AUTH-0002重新查詢後再重試 GC-*。優惠與庫存變動頻繁 — 先拉取最新的優惠再重試。
3. 重新查詢後再重試商務錯誤。GC-0009（庫存）與類似情況表示狀態已變更 — 請勿使用過時資料重試。不要重試驗證錯誤。具有類 4xx意圖的 VC-* 與 BS-* 代碼會在未修正輸入或餘額前持續失敗。
4. 以退避與隨機抖動重試暫時性伺服器錯誤。對 5xx / 網路錯誤使用抖動策略重試。金流類變更操作具去重處理；請參見 Idempotency。