Codes d'erreur et exceptions
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Réponses d'erreur de l'API
Le tableau suivant décrit les codes d'erreur pouvant être renvoyés par l'API Google Wallet, leurs causes possibles et les solutions correspondantes.
| Exception |
Exemple de message |
Suggestion |
| 400 – BadRequestException |
La requête contient un argument non valide. ID de ressource non valide: {1234567891234567899 - ABCD1234567}. |
Vérifiez la structure des données pour le type, le format et la longueur, puis transmettez le bon argument. |
| 403 – PermissionDeniedException |
Autorisation refusée |
Assurez-vous que l'adresse e-mail du compte de service est correcte et correspond à un utilisateur autorisé dans la Pay & Wallet Console de votre entreprise. |
| 404 – NotFoundException |
Objet Wallet {1234567891234567899.SampleClubCardxf6a8edf-87ca-4022-a813-694cc57e9fd3} introuvable. |
Exécutez une requête GET sur l'ID de l'objet avant d'effectuer une requête PATCH ou PUT pour vous assurer que vous disposez d'un objet à mettre à jour et qu'il est le plus récent. |
| 404 – IssuerClassNotFoundException |
Classe d'objet Wallet {1234567891234567899.ABCD.1234567} introuvable. |
Lorsque vous effectuez une mise à jour, assurez-vous d'exécuter une requête GET avant une requête PATCH ou PUT pour vous assurer de disposer d'une classe à utiliser comme référence, car il s'agit de la classe la plus récente. Assurez-vous également que la charge utile appropriée (objet et classe) est utilisée correctement dans la requête. |
| 409 – alreadyExistsException |
La classe d'objet Wallet {1234567891234567899.ABCD.1234567} existe déjà. |
Exécutez une requête GET sur l'ID de classe avant d'essayer de créer le même ID de classe. Si la ressource existe, vous pouvez utiliser PATCH ou PUT. |
Messages d'erreur Web
En cas de problème lorsque vous essayez d'enregistrer une carte à l'aide de l'option "Ajouter à Google Wallet" un message d'erreur informatif s'affiche pour vous aider au débogage. Ces messages ne s'affichent que pour les utilisateurs disposant du rôle "Développeur". ou "Admin" pour le compte d'émetteur associé.
Voici un exemple du type de message d'erreur qui peut s'afficher:
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/09/04 (UTC).
[null,null,["Dernière mise à jour le 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 is accompanied by an example message, a possible cause, and a suggested solution for resolving the issue.\u003c/p\u003e\n"],["\u003cp\u003eThe table helps developers debug and fix integration issues with the Google Wallet API.\u003c/p\u003e\n"],["\u003cp\u003eWeb-based error messages are also displayed for "Add to Google Wallet" link saving issues, visible to users with Developer or Admin roles, providing debugging information.\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:"]]
