> 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/protocolo-de-la-api.md).

# Protocolo de la API

### Protocolo y formato de mensaje <a href="#protocol-and-message-format" id="protocol-and-message-format"></a>

La API del Issuer Gateway es una API de estilo RPC. Cada método se asigna a un endpoint HTTP. Las solicitudes y respuestas usan cargas JSON.

A `200 OK` El estado HTTP significa que la solicitud tuvo éxito.

### Archivos Swagger <a href="#swagger-files" id="swagger-files"></a>

La API de Tokenization Service (Issuer Gateway API) está disponible como una definición Swagger (OpenAPI). Úsela para generar código cliente y validar solicitudes.

Descargar las definiciones OpenAPI:

* [Entrante (backend del emisor → Tokenization Service)](/classic-tokenization/es/referencia-de-la-api/api-de-la-pasarela-del-emisor/entrada-del-emisor.md)
* [Saliente (Tokenization Service → backend del emisor)](/classic-tokenization/es/referencia-de-la-api/api-de-la-pasarela-del-emisor/salida-al-emisor.md)

### Descripción general de la API <a href="#api-overview" id="api-overview"></a>

La API tiene endpoints entrantes y salientes:

* **Saliente**: Tokenization Service llama al **backend del emisor**.
* **Entrante**: el **backend del emisor** llama a Tokenization Service.

**Saliente**

| SOLICITUD DE THALES AL EMISOR | DESCRIPCIÓN                                                                                                                                                                                                                                                 |
| ----------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| NotifyVirtualCardChange       | Esta solicitud es utilizada por Tokenization Service para notificar al backend del emisor sobre cualquier cambio en el estado de un token.                                                                                                                  |
| RequestCardDigitalization     | Esta solicitud es utilizada por Tokenization Service para solicitar el consentimiento del backend del emisor para digitalizar la tarjeta de financiación.                                                                                                   |
| CheckCardEligibility          | Esta solicitud es utilizada por Tokenization Service para verificar si una tarjeta de financiación es elegible para la tokenización.                                                                                                                        |
| SendOTP                       | Esta solicitud es utilizada por Tokenization Service para enviar el OTP generado por la red de pago para la autenticación de elevación de privilegios (step-up). El backend del emisor debe enviar el OTP al usuario final mediante el método seleccionado. |

**Entrante**

| SOLICITUD DEL EMISOR A THALES | DESCRIPCIÓN                                                                                                                                                                                                                              |
| ----------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| UpdateCard                    | <p>Esta solicitud es utilizada por el backend del emisor para actualizar la información de la tarjeta, como:<br>- PAN de la tarjeta de financiación y fecha de vencimiento (para renovación de la tarjeta)<br>- Perfil de la tarjeta</p> |
| UpdateCardState               | Esta solicitud es utilizada por el backend del emisor para solicitar una actualización del estado de una tarjeta o token.                                                                                                                |
| GetCardInfo                   | Esta solicitud es utilizada por el backend del emisor para recuperar la información del token emitido para una determinada tarjeta de financiación.                                                                                      |
| SendMessage                   | Solo Apple Pay. Esta solicitud es utilizada por el backend del emisor para enviar un mensaje de texto al usuario final en la aplicación Wallet.                                                                                          |

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

La API del Issuer Gateway mantiene estado para la mayoría de las operaciones. Su backend del emisor debe gestionar el estado de la sesión para manejar correctamente las solicitudes de Tokenization Service.

*Inscripción*

* Use varias llamadas a la API.
* Almacene la información requerida devuelta en cada paso.
* Use el `x-correlation-id` encabezado para correlacionar todas las solicitudes de la misma sesión.

*LCM (gestión del ciclo de vida)*

* Confíe en Tokenization Service para gestionar los escenarios de finalización y no finalización.
* Use el `x-correlation-id` encabezado para correlacionar todas las solicitudes de la misma sesión.

<br>


---

# 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/protocolo-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.