Codici di errore ed eccezioni
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:
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-08-29 UTC.
[null,null,["Ultimo aggiornamento 2025-08-29 UTC."],[[["\u003cp\u003eThis page explains the various error codes returned by the Google Wallet API, including BadRequestException, PermissionDeniedException, NotFoundException, IssuerClassNotFoundException, and AlreadyExistsException.\u003c/p\u003e\n"],["\u003cp\u003eEach error code is accompanied by a description, potential causes, and suggestions for resolution, such as data validation, permission checks, and resource verification.\u003c/p\u003e\n"],["\u003cp\u003eBefore update requests (PATCH or PUT), it's crucial to perform a GET request to ensure the resource exists and you have the latest version to prevent conflicts.\u003c/p\u003e\n"],["\u003cp\u003eFor 'Add to Google Wallet' links, web-based error messages are displayed to developers and admins to aid in debugging issues during pass saving.\u003c/p\u003e\n"],["\u003cp\u003eThese messages provide insights into the problem, helping developers understand and resolve issues effectively.\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:"]]
