> For the complete documentation index, see [llms.txt](https://docs.payments.thalescloud.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.payments.thalescloud.io/merchant-tokenization/es/integracion-del-sdk/error-management/sdk-error-codes.md).

# Códigos de error del SDK

La aplicación del comerciante puede encontrarse con los siguientes códigos de error del SDK si no se configuran los prerrequisitos.

## Android

| Código de error                        | Caso de uso                                                                                                                                             | Recomendación                                                                                  |
| -------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- |
| AUTHENTICATION\_FAILURE\_CANCEL        | Este error se devuelve cuando falla la autenticación del dispositivo.                                                                                   | <ul><li>Muestre el mensaje de error al usuario final.</li></ul>                                |
| DEVICE\_AUTHENTICATION\_NOT\_SUPPORTED | Este error se devuelve cuando la autenticación biométrica no está configurada en el dispositivo.                                                        | <ul><li>Muestre el mensaje de error al usuario final.</li></ul>                                |
| CRYPTO\_ERROR                          | Este error se devuelve cuando hay un problema con el almacén de claves (keystore).                                                                      | <ul><li>Muestre el mensaje de error al usuario final.</li></ul>                                |
| INVALID\_PARAMETERS                    | Este error se devuelve cuando los parámetros de configuración no son válidos.                                                                           | <ul><li>Muestre el mensaje de error al usuario final.</li></ul>                                |
| INVALID\_DEVICE\_AUTHENTICATION\_PARAM | Este error se devuelve cuando el `FragmentActivity` parámetro es nulo.                                                                                  | <ul><li>Muestre el mensaje de error al usuario final.</li></ul>                                |
| STORAGE\_ERROR                         | Este error se devuelve cuando el método de autenticación del dispositivo no se encuentra en el almacenamiento.                                          | <ul><li>Muestre el mensaje de error al usuario final.</li></ul>                                |
| TOKEN\_NOT\_BOUNDED                    | Este error se devuelve cuando el token proporcionado no está vinculado al dispositivo.                                                                  | <ul><li>Muestre el mensaje de error al usuario final.</li></ul>                                |
| TOKEN\_ALREADY\_BOUNDED                | Este error se devuelve cuando el token proporcionado ya está vinculado al dispositivo o está pendiente de activación.                                   | <ul><li>Muestre el mensaje de error al usuario final.</li></ul>                                |
| TOKEN\_DEVICE\_BINDING\_PENDING        | Este error se devuelve cuando el proceso de vinculación del dispositivo aún está pendiente.                                                             | <ul><li>Complete el proceso de vinculación del dispositivo.</li></ul>                          |
| TOKEN\_DEVICE\_BINDING\_DECLINED       | Este error se devuelve cuando la vinculación del token al dispositivo es rechazada.                                                                     | <ul><li>Muestre el mensaje de error al usuario final.</li></ul>                                |
| INVALID\_IDV\_METHOD                   | Este error se devuelve cuando el método ID\&V proporcionado no es válido.                                                                               | <ul><li>Muestre el mensaje de error al usuario final.</li></ul>                                |
| ISSUER\_AUTHENTICATION\_REQUIRED       | Este error se devuelve cuando se requiere autenticación del emisor antes de que el usuario final pueda continuar.                                       | <ul><li>Seleccione un método ID\&V usando <code>IDVSession.selectIdvMethod()</code>.</li></ul> |
| INVALID\_OTP                           | Este error se devuelve cuando el OTP introducido tiene un formato no válido.                                                                            | <ul><li>El OTP no debe ser nulo ni vacío, y debe tener 8 dígitos o menos.</li></ul>            |
| JSON\_PARSING\_ERROR                   | Este error se devuelve cuando ocurre un error al analizar JSON.                                                                                         | <ul><li>Muestre el mensaje de error.</li></ul>                                                 |
| INVALID\_TOKEN\_ID                     | Este error se devuelve cuando el ID de Token Provisionado por Visa proporcionado es nulo o está vacío.                                                  | <ul><li>Muestre el mensaje de error.</li></ul>                                                 |
| KEYSTORE\_ERROR                        | Este error se devuelve cuando la clave queda invalidada de forma permanente. Por ejemplo, cuando el usuario final registra una nueva huella biométrica. | <ul><li>Muestre el mensaje de error.</li></ul>                                                 |
| ATTESTATION\_ERROR                     | Este error se devuelve cuando ocurre un problema al generar el objeto de atestación.                                                                    | <ul><li>Muestre el mensaje de error.</li></ul>                                                 |

## iOS

| Código de error                                     | Caso de uso                                                                                                                                                                                                                                                                                                                                     | Recomendación                                                                                             |
| --------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------- |
| `TMGError.tokenNotBound`                            | Este error se devuelve cuando el token proporcionado no está vinculado al dispositivo.                                                                                                                                                                                                                                                          | <ul><li>Muestre el mensaje de error al usuario final.</li></ul>                                           |
| `TMGError.tokenPending`                             | Este error se devuelve cuando el proceso de vinculación del dispositivo aún está pendiente.                                                                                                                                                                                                                                                     | <ul><li>Complete el proceso de vinculación del dispositivo.</li></ul>                                     |
| `TMGError.tokenDeclined`                            | Este error se devuelve cuando la vinculación del token al dispositivo es rechazada.                                                                                                                                                                                                                                                             | <ul><li>Muestre el mensaje de error al usuario final.</li></ul>                                           |
| `TMGError.tokenAlreadyBound`                        | Este error se devuelve cuando el token proporcionado ya está vinculado al dispositivo o está pendiente de activación.                                                                                                                                                                                                                           | <ul><li>Muestre el mensaje de error al usuario final.</li></ul>                                           |
| `TMGError.invalidConfigParams`                      | Este error se devuelve cuando el `TMGClientConfiguration` el parámetro no es válido.                                                                                                                                                                                                                                                            | <ul><li>Verifique los detalles de la implementación.</li></ul>                                            |
| `TMGError.invalidRequiredParams`                    | Este error se devuelve cuando los parámetros obligatorios no son válidos.                                                                                                                                                                                                                                                                       | <ul><li>Verifique los detalles de la implementación.</li></ul>                                            |
| `TMGError.invalidIdvMethod`                         | Este error se devuelve cuando el método ID\&V proporcionado no es válido.                                                                                                                                                                                                                                                                       | <ul><li>Muestre el mensaje de error al usuario final.</li></ul>                                           |
| `TMGError.invalidOTPMessage`                        | Este error se devuelve cuando el OTP introducido tiene un formato no válido.                                                                                                                                                                                                                                                                    | <ul><li>El OTP no debe ser nulo ni vacío, y debe tener 8 dígitos o menos.</li></ul>                       |
| `TMGError.issuerAuthenticationRequired`             | Este error se devuelve cuando se requiere autenticación del emisor antes de que el usuario final pueda continuar.                                                                                                                                                                                                                               | <ul><li>Seleccione un método ID\&V usando <code>PendingBindingSession.selectIdvMethod()</code>.</li></ul> |
| `TMGError.biometricNotSupported`                    | Este error se devuelve cuando la autenticación biométrica no está configurada en el dispositivo.                                                                                                                                                                                                                                                | <ul><li>Muestre el mensaje de error al usuario final.</li></ul>                                           |
| `TMGError.authenticationFailure(reason: String)`    | Este error se devuelve cuando falla la autenticación del dispositivo.                                                                                                                                                                                                                                                                           | <ul><li>Muestre el mensaje de error al usuario final.</li></ul>                                           |
| `TMGError.authenticationKeyInvalidated`             | Este error se devuelve cuando el usuario final cambia los datos biométricos utilizados para la autenticación. Por ejemplo, el usuario final actualiza la configuración de Face ID o de huella dactilar. Cuando se devuelve este error, el par de claves criptográficas deja de ser accesible y todos los tokens se desvinculan automáticamente. | <ul><li>Muestre el mensaje de error al usuario final.</li></ul>                                           |
| `TMGError.internalError(additionalMessage: String)` | Este error se devuelve cuando ocurre un error interno. El `additionalMessage` proporciona más detalles. Este error no es recuperable. Contacte con el soporte de Thales.                                                                                                                                                                        | <ul><li>Muestre el mensaje de error genérico al usuario final.</li></ul>                                  |
| `TMGError.deviceEnvironmentUnsafe(code: Int)`       | Este error se devuelve cuando el entorno del dispositivo es potencialmente inseguro. Verifique el código de error ofuscado con Thales.                                                                                                                                                                                                          | <ul><li>Muestre el mensaje de error al usuario final.</li></ul>                                           |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.payments.thalescloud.io/merchant-tokenization/es/integracion-del-sdk/error-management/sdk-error-codes.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.