錯誤代碼和例外狀況

API 錯誤回應

下表說明 Google Wallet API 可能會傳回的錯誤代碼、可能的原因以及解決方法。

例外狀況 訊息範例 建議
400 - BadRequestException 要求含有無效引數，資源 ID 無效：{1234567891234567899 - ABCD1234567}。 檢查類型、格式和長度的資料結構，並傳遞正確的引數。
403 - PermissionDeniedException 權限遭拒 確認正確的服務帳戶電子郵件是商家付款和錢包主控台的授權使用者。
404 - NotFoundException 找不到錢包物件 {1234567891234567899.SampleClubCardxf6a8edf-87ca-4022-a813-694cc57e9fd3}。 嘗試提出 PATCH 或 PUT 要求之前，請先對物件 ID 執行 GET，確保您有需要更新的物件且是最新版本。
404 - IssuerClassNotFoundException 找不到錢包物件類別 {1234567891234567899.ABCD.1234567}。 執行更新時，請務必在 PATCH 或 PUT 要求之前執行 GET 要求，確保您的類別可以參照其是最新的類別。此外，也請確認要求中使用的酬載 (物件和類別) 正確無誤。
409 - OnceExistsException 已有電子錢包物件類別 {1234567891234567899.ABCD.1234567}。 請先對類別 ID 執行 GET，再嘗試建立相同的課程 ID。如果該資源存在，建議您使用 PATCH 或 PUT.。

網頁式錯誤訊息

如果您嘗試使用「新增至 Google 錢包」連結儲存票證時發生錯誤，系統會顯示資訊豐富的錯誤訊息，協助您進行偵錯。使用者必須具備相關聯核發者帳戶的「開發人員」或「管理員」角色，才會看到這類訊息。

以下是可能會出現的錯誤訊息類型範例：

錯誤訊息範例