> 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/tokenizacion-de-red/implement-network-tokenization/handle-token-updates-from-tsp.md).

# Gestionar actualizaciones de tokens del TSP

La red de pagos TSP puede actualizar un token. El backend de Thales reenvía las actualizaciones a su endpoint de solicitante de tokens.

## ¿Qué desencadena una actualización de token?

* El emisor actualiza los datos de la tarjeta.
  * La renovación o reemisión cambia los últimos dígitos del PAN y/o la fecha de caducidad del PAN.
  * El diseño de la tarjeta puede cambiar.
* La red de pagos TSP actualiza los detalles del token.
  * La fecha de caducidad del token puede extenderse.
    * Mastercard: la vida útil del token suele ser de 3 años.
    * Visa: la fecha de caducidad del token es igual a la fecha de caducidad de la tarjeta.
  * El estado del token puede cambiar.
    * `ELIMINADO`: La tarjeta se destruye o caduca sin renovación.
    * `SUSPENDIDO`: El emisor bloquea la tarjeta temporalmente.

## Flujo

<figure><img src="/files/7ea5f593aa3148192be34fec8589cbc3f1e5956f" alt=""><figcaption><p>Flujo de notificación de actualización de token.</p></figcaption></figure>

<table><thead><tr><th width="100">Paso</th><th>Descripción</th></tr></thead><tbody><tr><td>1</td><td>El backend del emisor informa a la red de pagos TSP que los datos de la tarjeta o del token han cambiado.</td></tr><tr><td>2</td><td>La red de pagos TSP envía la actualización al backend de Thales.</td></tr><tr><td>3</td><td>El backend de Thales notifica al solicitante del token (comerciante o PSP) con los datos de token actualizados. Reconozca la notificación, incluso si la procesa de forma asíncrona.</td></tr></tbody></table>

## API

[Notificar actualización de token](broken://pages/838081e7da060803f29a737002c2eb70f0805d2b#post-notify-token-update)

## Notas de implementación

* Haga que su manejador sea idempotente.
* Espere reintentos. Las notificaciones pueden llegar fuera de orden.
* Use `lastUpdateTimestamp` para descartar actualizaciones obsoletas.

{% hint style="warning" %}
Si almacena el PAN del token, descártelo cuando `tokenLastDigits` cambie.

Recupere el PAN de token más reciente usando el **Crear transacción** API.
{% endhint %}


---

# 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:

```
GET https://docs.payments.thalescloud.io/merchant-tokenization/es/tokenizacion-de-red/implement-network-tokenization/handle-token-updates-from-tsp.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.