Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Risposte agli errori dell'API
La tabella che segue illustra i codici di errore che potrebbero essere restituiti dall'API Google Wallet, nonché le loro possibili cause e soluzioni.
Eccezione
Messaggio di esempio
Suggerimento
400 - BadRequestException
La richiesta contiene un argomento non valido. ID risorsa non valido: {1234567891234567899 - ABCD1234567}.
Verifica il tipo, il formato e la lunghezza della struttura dei dati e trasmetti l'argomento corretto.
403 - Autorizzazione negata
Autorizzazione negata
Assicurati che l'indirizzo email dell'account di servizio corretto sia un utente autorizzato all'interno della tua console Business Pay e Wallet.
404 - Eccezione NotFoundException
Oggetto Wallet {1234567891234567899.SampleClubCardxf6a8edf-87ca-4022-a813-694cc57e9fd3} non trovato.
Esegui una richiesta GET sull'ID oggetto prima di provare prima di una richiesta PATCH o PUT per assicurarti di avere un oggetto da aggiornare e che sia il più recente.
404 - IssuerClassNotFoundException
Classe oggetto Wallet {1234567891234567899.ABCD.1234567} non trovata.
Quando esegui un aggiornamento , assicurati di eseguire una richiesta GET prima di una richiesta PATCH o PUT per assicurarti di avere una classe che faccia riferimento al fatto che è la più recente. Assicurati inoltre che nella richiesta venga utilizzato il payload corretto (oggetto e classe).
409 - AlreadyExistsException
La classe dell'oggetto Wallet {1234567891234567899.ABCD.1234567} esiste già.
Esegui una richiesta GET sull'ID corso prima di provare a creare lo stesso ID corso. Se la risorsa esiste già, puoi usare PATCH o PUT.
Messaggi di errore basati sul web
Se si verifica un problema durante il tentativo di salvare una tessera utilizzando il link "Aggiungi a Google Wallet", ti verrà mostrato un messaggio di errore informativo che ti aiuterà a eseguire il debug. Questi messaggi vengono mostrati solo agli utenti che hanno il ruolo "Sviluppatore" o "Amministratore" per l'account emittente associato.
Ecco un esempio del tipo di messaggio di errore che potrebbe essere visualizzato:
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Mancano le informazioni di cui ho bisogno","missingTheInformationINeed","thumb-down"],["Troppo complicato/troppi passaggi","tooComplicatedTooManySteps","thumb-down"],["Obsoleti","outOfDate","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Problema relativo a esempi/codice","samplesCodeIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-09-04 UTC."],[[["\u003cp\u003eThis page explains the different error codes that may be returned by the Google Wallet API, including BadRequestException, PermissionDeniedException, NotFoundException, IssuerClassNotFoundException, and AlreadyExistsException.\u003c/p\u003e\n"],["\u003cp\u003eEach error code has an explanation for the possible causes and suggestions for troubleshooting and resolving the issue.\u003c/p\u003e\n"],["\u003cp\u003eFor web-based errors, when attempting to save a pass using 'Add to Google Wallet,' informative messages will be displayed to users with 'Developer' or 'Admin' roles for debugging purposes.\u003c/p\u003e\n"]]],["The Google Wallet API returns specific error codes: 400 (BadRequestException) indicates an invalid argument, requiring checks on data structure. 403 (PermissionDeniedException) means the service account lacks authorization. 404 (NotFoundException) signals a missing Wallet Object or Class, needing a GET request before PATCH/PUT actions. 409 (AlreadyExistsException) indicates an existing class, suggesting a GET request and potential PATCH/PUT instead of creating it again. Web errors are displayed to developers and admins.\n"],null,["# Error codes and exceptions\n\nAPI error responses\n-------------------\n\nThe following table explains error codes that mayn be returned by the Google Wallet API, their possible causes, and solutions.\n\n| Exception | Example Message | Suggestion |\n|------------------------------------|---------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| 400 - BadRequestException | Request contains an invalid argument. Invalid resource ID: {1234567891234567899 - ABCD1234567}. | Check the data structure for type, format and length and pass the correct argument. |\n| 403 - PermissionDeniedException | Permission Denied | Ensure the correct [Service Account](https://developers.google.com/wallet/retail/loyalty-cards/web/prerequisites#4.-authorize-the-service-account) email is an authorized user within your Business Pay and Wallet Console. |\n| 404 - NotFoundException | Wallet Object {1234567891234567899.SampleClubCardxf6a8edf-87ca-4022-a813-694cc57e9fd3} not found. | Perform a [GET](https://developers.google.com/wallet/generic/rest/v1/genericclass/get#http-request) on the Object ID before trying before a [PATCH](https://developers.google.com/wallet/generic/rest/v1/genericclass/patch#http-request) or [PUT](https://developers.google.com/wallet/generic/rest/v1/genericclass/update#http-request) request to ensure you have an object to update and that it's the latest. |\n| 404 - IssuerClassNotFoundException | Wallet Object Class {1234567891234567899.ABCD.1234567} not found. | When performing an update , ensure you do a [GET](https://developers.google.com/wallet/generic/rest/v1/genericclass/get#http-request) request before a [PATCH](https://developers.google.com/wallet/generic/rest/v1/genericclass/patch#http-request) or [PUT](https://developers.google.com/wallet/generic/rest/v1/genericclass/update#http-request) request to ensure you have a class to reference that it's the latest class. Also ensure the correct payload (object and class) is being used in the request correctly. |\n| 409 - AlreadyExistsException | Wallet Object Class {1234567891234567899.ABCD.1234567} already exists. | Perform a [GET](https://developers.google.com/wallet/generic/rest/v1/genericclass/get#http-request) on the Class ID before trying to create the same Class ID. If the resource exists you may want to use [PATCH](https://developers.google.com/wallet/generic/rest/v1/genericclass/patch#http-request) or [PUT.](https://developers.google.com/wallet/generic/rest/v1/genericclass/update#http-request) |\n\nWeb-based error messages\n------------------------\n\nIf something goes wrong when you attempt to save a pass using an 'Add to Google Wallet' link, you will be shown an informative error message to help you debug. These messages are only shown to users that have the 'Developer' or 'Admin' role for the associated Issuer account.\n\nHere is an example of the type of error message that might be displayed:"]]
