Fehlercodes und Ausnahmen
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
API-Fehlerantworten
In der folgenden Tabelle werden Fehlercodes, die möglicherweise von der Google Wallet API zurückgegeben werden, sowie ihre möglichen Ursachen und Lösungen erläutert.
| Ausnahme |
Beispielmeldung |
Vorschlag |
| 400 – BadRequestException |
Die Anfrage enthält ein ungültiges Argument. Ungültige Ressourcen-ID: {1234567891234567899 - ABCD1234567}. |
Überprüfen Sie die Datenstruktur auf Typ, Format und Länge und übergeben Sie das richtige Argument. |
| 403 – PermissionDeniedException |
Berechtigung verweigert |
Achte darauf, dass die richtige Dienstkonto-E-Mail-Adresse ein autorisierter Nutzer in deiner Business Pay and Wallet Console ist. |
| 404 – NotFoundException |
Wallet-Objekt {1234567891234567899.SampleClubCardxf6a8edf-87ca-4022-a813-694cc57e9fd3} nicht gefunden. |
Führe einen GET-Vorgang für die Objekt-ID aus, bevor du es vor einer PATCH- oder PUT-Anfrage versuchst, um sicherzustellen, dass ein Objekt zum Aktualisieren vorhanden ist und dass es das neueste ist. |
| 404 – IssuerClassNotFoundException |
Die Wallet-Objektklasse {1234567891234567899.ABCD.1234567} wurde nicht gefunden. |
Führen Sie bei einer Aktualisierung unbedingt eine GET-Anfrage vor einer PATCH- oder PUT-Anfrage aus, um sicherzustellen, dass Sie auf eine Klasse verweisen können, dass sie die neueste ist. Achten Sie auch darauf, dass die richtige Nutzlast (Objekt und Klasse) in der Anfrage verwendet wird. |
| 409 – AlreadyExistsException |
Die Wallet-Objektklasse {1234567891234567899.ABCD.1234567} ist bereits vorhanden. |
Führe einen GET-Vorgang für die Klassen-ID aus, bevor du versuchst, dieselbe Klassen-ID zu erstellen. Wenn die Ressource vorhanden ist, können Sie PATCH oder PUT verwenden. |
Webbasierte Fehlermeldungen
Wenn beim Speichern einer Karte bzw. eines Tickets über die Option „Zu Google Wallet hinzufügen“ ein Fehler auftritt wird eine informative Fehlermeldung angezeigt, die Sie bei der Fehlerbehebung unterstützt. Diese Nachrichten werden nur Nutzern angezeigt, die den Eintrag „Entwickler“ oder „Admin“ für das verknüpfte Ausstellerkonto.
Hier ist ein Beispiel für die Art von Fehlermeldung, die angezeigt werden könnte:
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-08-29 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-08-29 (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 solutions, focusing on data structure validation, service account authorization, object and class ID verification, and using appropriate HTTP methods like GET, PATCH, or PUT.\u003c/p\u003e\n"],["\u003cp\u003eThe table provides example error messages to help with troubleshooting, along with links to relevant documentation for further assistance.\u003c/p\u003e\n"],["\u003cp\u003eFor 'Add to Google Wallet' links, web-based error messages are displayed for users with 'Developer' or 'Admin' roles to assist with debugging, offering insights into the issue.\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:"]]
