> 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/classic-tokenization/es/comenzar/conceptos-basicos-de-la-api/directrices-de-la-api.md).

# Directrices de la API

### Consideraciones de desarrollo <a href="#development-considerations" id="development-considerations"></a>

Los siguientes cambios se consideran compatibles hacia atrás:

* Agregar una nueva solicitud de API.
* Agregar un nuevo parámetro opcional a una solicitud o respuesta de API existente.
  * Agregarlo en el cuerpo, como parámetro de consulta o como un encabezado HTTP.
* Agregar un nuevo valor de enumeración.
* Hacer opcionales los parámetros obligatorios.
* Ignorar campos o valores desconocidos recibidos en una solicitud o respuesta de API.

### Gestión de errores <a href="#error-management" id="error-management"></a>

#### Respuestas y tipos de error <a href="#responses-and-error-types" id="responses-and-error-types"></a>

Las respuestas se agrupan en categorías. Maneje todas las respuestas en la misma categoría de la misma manera. La siguiente tabla enumera las categorías e indica:

* Los tipos de error en cada categoría.
* Cómo el backend del emisor debe manejar estos errores, incluida la política de reintentos.

| CÓDIGO TIPO | CATEGORÍA          | DESCRIPCIÓN Y POLÍTICA DE REINTENTOS                                                                                                                                                                                                               |
| ----------- | ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| K           | OK, no es un error | N/A                                                                                                                                                                                                                                                |
| D           | Error de datos     | Los parámetros enviados por el solicitante de la función no coinciden con las reglas verificadas por el proveedor de la función.                                                                                                                   |
| S           | Error de sistema   | <p>Este es un error inesperado causado por una falla temporal en una o más partes del sistema.<br>El solicitante de la función puede reintentar la solicitud.<br>Nota: <strong>Los errores HTTP 5xx se consideran errores de sistema</strong>.</p> |
| F           | Error funcional    | <p>Este es un error definitivo. Abortar el procesamiento. No reintentar.<br>El token ya no se puede usar y debe eliminarse.</p>                                                                                                                    |

#### Errores <a href="#errors" id="errors"></a>

La tabla a continuación enumera los errores que pueden ocurrir.

Dependiendo del flujo, un error puede devolverse de forma sincrónica en la respuesta o de forma asincrónica en una devolución de llamada.

| CÓDIGO DE ERROR | CÓDIGO TIPO | DESCRIPCIÓN                                                                                                                                                                                                                                          |
| --------------- | ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 111             | D           | Falta un parámetro obligatorio                                                                                                                                                                                                                       |
| 112             | D           | Formato de parámetro incorrecto                                                                                                                                                                                                                      |
| 113             | D           | Emisor desconocido                                                                                                                                                                                                                                   |
| 114             | D           | Usuario final desconocido                                                                                                                                                                                                                            |
| 115             | D           | Producto desconocido                                                                                                                                                                                                                                 |
| 116             | D           | Tarjeta desconocida                                                                                                                                                                                                                                  |
| 117             | D           | Almacenamiento de tokens desconocido                                                                                                                                                                                                                 |
| 118             | D           | Solicitud desconocida                                                                                                                                                                                                                                |
| 119             | D           | Tarjeta virtual desconocida                                                                                                                                                                                                                          |
| 158             | D           | Parámetros inválidos: tarjeta expirada                                                                                                                                                                                                               |
| 159             | D           | Parámetros inválidos: tarjeta suspendida                                                                                                                                                                                                             |
| 160             | D           | Parámetros inválidos: tarjeta revocada o eliminada                                                                                                                                                                                                   |
| 161             | D           | <p>El valor de autenticación es incorrecto.</p><ul><li>Código de seguridad de la tarjeta (CSC) incorrecto</li><li>OTP criptográfico inválido</li></ul>                                                                                               |
| 163             | D           | Producto no compatible con pago móvil                                                                                                                                                                                                                |
| 164             | D           | Se excedió el recuento de aprovisionamiento FPAN                                                                                                                                                                                                     |
| 166             | D           | Información de la tarjeta inválida (FPAN, fecha de vencimiento) o tarjeta no elegible                                                                                                                                                                |
| 167             | D           | Tarjeta ya inscrita                                                                                                                                                                                                                                  |
| 168             | D           | No hay número de teléfono asociado con el usuario final                                                                                                                                                                                              |
| 221             | S           | El proveedor del dispositivo o de la billetera no es accesible después de reintentos                                                                                                                                                                 |
| 222             | S           | El proveedor del dispositivo o de la billetera está ocupado                                                                                                                                                                                          |
| 231             | F           | Error inesperado del dispositivo                                                                                                                                                                                                                     |
| 232             | F           | Memoria insuficiente en el dispositivo para realizar la operación                                                                                                                                                                                    |
| 321             | S           | La operación sobre un token ya está en curso                                                                                                                                                                                                         |
| 322             | S           | Tiempo de vida de la operación expirado                                                                                                                                                                                                              |
| 323             | S           | Operación parcialmente completada (típicamente cuando una operación apunta a múltiples tarjetas virtuales y una falla)                                                                                                                               |
| 421             | S           | OTP o PIN bloqueado (límite de reintentos excedido)                                                                                                                                                                                                  |
| 422             | S           | OTP expirado                                                                                                                                                                                                                                         |
| 431             | F           | Datos de personalización inválidos                                                                                                                                                                                                                   |
| 432             | F           | El estado actual del token/tarjeta no permite esta operación                                                                                                                                                                                         |
| 501             | D           | El ID del método ID\&V es inválido                                                                                                                                                                                                                   |
| 502             | D           | El canal de comunicación no está disponible para enviar OTP                                                                                                                                                                                          |
| 503             | D           | <p>El método ID\&V seleccionado por el usuario final es <strong>ya no</strong> válido.<br>Esto puede ocurrir si, durante la inscripción, los datos del canal (por ejemplo, un número de teléfono) se vuelven inválidos para el proceso de ID\&V.</p> |
| 510             | F           | Verificación de titular de tarjeta escalada rechazada (solo Visa CTF)                                                                                                                                                                                |
| 520             | F           | Verificación de titular de tarjeta escalada fallida (solo Visa CTF)                                                                                                                                                                                  |
| 521             | S           | Error del servidor de push                                                                                                                                                                                                                           |
| 531             | F           | Token de push ya no válido                                                                                                                                                                                                                           |
| 911             | F           | Operación fallida                                                                                                                                                                                                                                    |
| 920             | F           | Se excedió el límite de generación de OTP                                                                                                                                                                                                            |
| 921             | S           | Error inesperado del servidor                                                                                                                                                                                                                        |


---

# 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/classic-tokenization/es/comenzar/conceptos-basicos-de-la-api/directrices-de-la-api.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.