> 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/transit-classic/es/referencia-de-la-api/historial-del-documento.md).

# Historial del documento

| Versión | Fecha (dd/mm/aaaa) | Modificaciones                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| ------- | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| 1.0.0   | 20/09/2018         | Primera versión de la API TES                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| 1.0.1   | 01/10/2018         | <ul><li><p>añadir nuevos códigos de error</p><ul><li>provisionCard rechazada</li><li>discordancia de cuenta</li><li>datos perso inválidos</li><li>operación no permitida con el estado actual de la tarjeta</li></ul></li><li>añadir el parámetro opcional timestamp para los encabezados de solicitud/respuesta</li><li>añadir el valor 'unknown' para el método de captura de tarjeta</li><li>añadir el parámetro keyIndex para cardPersoData</li><li>updateCardState (TES a TSH) tiene la nueva acción PARK\_AND\_DELETE</li><li>updateCardState (TSH a TES) tiene la nueva acción BLACKLIST</li><li>updateCardState (TSH a TES) tiene la nueva acción BLACKLIST</li><li>los estados devueltos en getCards se han actualizado a CREATED, ACTIVE, SUSPENDED\_ISSUER, SUSPENDED\_WALLET, BLACKLISTED y DELETED</li></ul>                                                                                                                                                                                                                                                                                                                  |
| 1.0.2   | 22/10/2018         | <ul><li>añadir el nuevo deviceType "UNKNOWN"</li><li>añadir el nuevo código de error "provisioning count exceeded"</li><li>corregir el error tipográfico en phoneNumerLastDigits, sustituido por phoneNumberLastDigits</li><li>añadir el parámetro opcional "displayCardNumber" en la respuesta de provisionCard</li><li>eliminar la acción PARK\_AND\_DELETE de updateCardState (TES a TSH)</li><li>añadir la nueva API sendMessage que permite a TES solicitar la entrega de un mensaje al usuario</li><li>eliminar el estado BLACKLISTED de getCards y la acción BLACKLIST de updateCardState (TSH a TES)</li><li>añadir la nueva API refundCardAccount que permite a TES notificar a TSH que se ha reembolsado una cuenta de tarjeta</li><li>corregir un problema en el swagger de TES a TSH para el tipo cardPersoData</li><li>reemplazar la operación PARK\_CARD por BLOCK\_AND\_READ\_CARD en initiateCardSession</li><li>actualizar el parámetro operation a newState para updateCardState (TSH a TES) y los valores asociados para reflejar que esta llamada se realiza para notificar el cambio y no para solicitarlo.</li></ul> |
| 1.0.3   | 05/11/2018         | <ul><li>aumentar la longitud de orderId y purchaseId a 64 en lugar de 48</li><li><p>añadir nuevos parámetros en el parámetro paymentInstrument (aplicable para createCardAccound y topupCardAccount)</p><ul><li>versión</li><li>encabezado</li><li>firma</li></ul></li><li>añadir el nuevo parámetro de salida "signature" a createCardAccount y topupCardAccount</li><li>statusCode en responseHeader ahora es obligatorio</li><li>añadir la nueva API getRequestStatus + el nuevo código de error "unknow request"</li><li>añadir la nueva acción LCM "ERASE" para el cumplimiento de GDPR / RoI</li><li>añadir la nueva API getRequestStatus + el nuevo código de error "unknow request"</li><li>añadir el parámetro customerData en provisionCard</li></ul>                                                                                                                                                                                                                                                                                                                                                                            |
| 1.0.4   | 10/12/2018         | <ul><li>eliminar las APIs obsoletas "getPurchaseStatus" y "updatePurchaseStatus"</li><li>Nueva API Device GW getParkCardCommands para aparcar tarjeta</li><li><p>añadir nuevos códigos de error para createCardAccount y topupCardAccount</p><ul><li>419 PIN requerido</li><li>420 PIN incorrecto</li><li>421 PIN bloqueado</li></ul></li><li>Error en updateCardState (TSH a TES), purchaseId eliminado de la respuesta</li><li>añadir productId en la solicitud createCardAccount</li><li>añadir cardLastDigits en provisionCard</li><li>corregir el prefijo de la URL para la API de notificaciones de tránsito (de xxx/v1.0 a xxx/1/0)</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| 1.0.5   | 07/01/2019         | <ul><li>eliminar el estado RECEIVED de la respuesta de la API getRequestStatus</li><li>añadir el nuevo código de error 166 para información de tarjeta inválida</li><li>signature y paymentData en paymentInstrument están limitados a un máximo de 8192 caracteres</li><li>añadir el nuevo parámetro wrappedKey en paymentInstrument (usado para el algoritmo RSA) para createCardAccount y topupCardAccount</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| 1.0.6   | 01/02/2019         | <ul><li>añadir el nuevo método updateCardMetadata para la gestión de planes de desplazamiento</li><li>añadir el parámetro de objeto cardContents en getReaderModeCommands</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| 1.0.7   | 08/02/2019         | <ul><li>añadir compatibilidad con título localizado en los planes de desplazamiento</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| 1.0.8   | 21/02/2019         | <ul><li>alinear los posibles valores de operation entre initiateCardSession y getCardCommands</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| 1.0.9   | 18/03/2019         | <ul><li>El nuevo estado "UNLINKED" puede enviarse en updateCardState (TSH a TES)</li><li>actualizar la API getCards para gestionar el estado de tarjeta UNLINKED y ahora devolverá el estado de la cuenta de tarjeta</li><li>Nuevo parámetro opcional en la respuesta de provisionCard "cardholderName"</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| 1.0.10  | 02/04/2019         | <ul><li><p>añadir nuevos códigos de error en la API de gateway de dispositivos</p><ul><li>172 Tarjeta inválida, código de sistema no compatible</li><li>173 Tarjeta inválida, servicio no compatible</li><li>177 Tarjeta inválida, datos de área no válidos</li><li>178 Tarjeta inválida, el estado de la tarjeta es in-station</li></ul></li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| 1.0.11  | 16/04/2019         | <ul><li><p>actualizar la respuesta de getCards</p><ul><li>cardAccountId eliminado</li><li>walletAccountId, cardAccountState y walletCardAccountId están en el nivel superior</li></ul></li><li>actualizar la respuesta de provisionCard para la gestión de localización del nombre del titular de la tarjeta</li><li><p>actualizar getParkCardCommands y getReaderModeCommands</p><ul><li>añadir el nuevo parámetro "cardData" en la respuesta</li><li>cardData contiene "balanceAmount"</li></ul></li><li>se añade el código de error 221 para la API de TES a TSH</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| 1.0.12  | 24/04/2019         | <ul><li>añadir códigos de error en el gateway de dispositivos para tener en cuenta la nueva especificación del cliente TSM 2.2</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| 1.0.13  | 17/05/2019         | <ul><li>cambiar el valor de operation "RENEW\_CARD" a "UPDATE\_PLAN"</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| 1.0.14  | 27/05/2019         | <ul><li><p>actualización de notifyOperationResult</p><ul><li>cardId ahora es opcional</li><li>añadir el parámetro opcional purchaseId</li><li>añadir el parámetro opcional cardAccountId</li><li>añadir el parámetro isProvisioning</li></ul></li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| 1.0.15  | 06/06/2019         | <ul><li>walletAccountId se elimina de createCardAccount (solo se envía en provisionCard)</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| 1.0.16  | 23/07/2019         | <ul><li>eliminación de retryCount de los métodos del gateway de dispositivos</li><li>eliminación del error 922</li><li>añadir el error 432 para los métodos de TSH a TES</li><li>aumentar la longitud de card perso data a 8192 en lugar de 500</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| 1.0.17  | 11/12/2019         | <ul><li>eliminar la restricción enum sobre walletProviderId proporcionado en checkCardAccount</li><li>añadir el nuevo encabezado HTTP x-actor-id en device-gateway y transit-tsh-to-tes. Este encabezado indica el proveedor de wallet que inicia la solicitud. Su valor corresponde a walletProviderId tal como se define en checkCardAccount</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| 1.0.18  | 26/10/2020         | <ul><li>añadir el nuevo parámetro opcional "resultData" en notifyOperationResult para proporcionar información adicional a TES</li><li>añadir el nuevo parámetro "purchaseId" que TSH proporciona a TES en getCardCommands cuando está relacionado con una recarga iniciada desde la wallet.</li><li>añadir el nuevo parámetro "cardData" en la respuesta de provisionCard.</li><li>añadir el nuevo parámetro opcional "opaqueServiceProviderData" en las solicitudes createCardAccount y topupCardAccount.</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| 1.0.19  | 30/11/2021         | <ul><li>añadir la nueva función getCardAccountsMetadata</li><li>añadir la nueva función getCardActions</li><li>añadir el nuevo parámetro opcional 'cardArtManifest' en la respuesta de checkCardAccount y en la solicitud updateCardMetadata</li><li>añadir la nueva función getAsset</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| 1.0.20  | 28/02/2024         | <ul><li>añadir el nuevo parámetro (array de objetos) "title" dentro del objeto cardActions de la respuesta de getCardActions para permitir reemplazar valores predefinidos aprovisionados estáticamente</li><li>añadir <a href="https://thales-dis-dbp.stoplight.io/docs/digital-transit/33e2dd0faee3a-calypso-toc">verdad de Calypso sobre la preparación de los datos de la tarjeta</a> sección</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| 1.0.21  | 14/1/2024          | <ul><li>añadir el nuevo parámetro 'mobileApplicationInfo' en la respuesta de 'checkCardAccount'</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| 1.0.22  | 11/12/2025         | <ul><li>añadir el nuevo parámetro opcional 'cardArtManifest' en la respuesta de provisionCard</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| 1.0.23  | 21/09/2026         | <ul><li>añadir un nuevo encabezado HTTP opcional para la solicitud entrante (TES a TSH) que indica a qué proveedor de wallet va dirigida. Su valor corresponde a walletProviderId (como en el encabezado HTTP saliente)</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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.payments.thalescloud.io/transit-classic/es/referencia-de-la-api/historial-del-documento.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.