Códigos de error y excepciones
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Respuestas de error de la API
En la siguiente tabla, se explican los códigos de error que la API de la Billetera de Google puede mostrar, sus posibles causas y sus soluciones.
| Excepción |
Mensaje de ejemplo |
Sugerencia |
| 400 - BadRequestException. |
La solicitud contiene un argumento no válido. ID de recurso no válido: {1234567891234567899 - ABCD1234567}. |
Verifica el tipo, el formato y la longitud de la estructura de datos, y pasa el argumento correcto. |
| 403: PermissionDeniedException |
Permiso denegado |
Asegúrate de que el correo electrónico correcto de la cuenta de servicio sea un usuario autorizado en Business Pay y en la Consola de la Billetera. |
| 404: NotFoundException |
No se encontró el objeto de Wallet {1234567891234567899.SampleClubCardxf6a8edf-87ca-4022-a813-694cc57e9fd3}. |
Realiza una operación GET en el ID de objeto antes de intentarlo antes de una solicitud PATCH o PUT para asegurarte de que tienes un objeto para actualizar y que es el más reciente. |
| 404 - IssuerClassNotFoundException |
No se encontró la clase de objeto de Wallet {1234567891234567899.ABCD.1234567}. |
Cuando realices una actualización , asegúrate de realizar una solicitud GET antes de una solicitud PATCH o PUT para asegurarte de tener una clase que haga referencia a que es la más reciente. Además, asegúrate de que se use correctamente la carga útil correcta (objeto y clase) en la solicitud. |
| 409: AlreadyExistsException |
La clase de objeto de Billetera {1234567891234567899.ABCD.1234567} ya existe. |
Realiza un comando GET en el ID de clase antes de intentar crear el mismo ID de clase. Si el recurso existe, te recomendamos que uses PATCH o PUT. |
Mensajes de error basados en la Web
Si se produce un error cuando intentes guardar un pase con un vínculo “Agregar a la Billetera de Google”, verás un mensaje de error informativo para ayudarte a realizar la depuración. Estos mensajes solo se muestran a los usuarios que tienen el rol “Desarrollador” o “Administrador” en la cuenta de entidad emisora asociada.
Este es un ejemplo del tipo de mensaje de error que se puede mostrar:
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-08-29 (UTC)
[null,null,["Última actualización: 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:"]]
