> 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>provisionamiento de tarjeta rechazado</li><li>incompatibilidad de cuenta</li><li>datos de personalización inválidos</li><li>operación no permitida con el estado actual de la tarjeta</li></ul></li><li>añadir parámetro opcional timestamp para cabeceras de solicitud/respuesta</li><li>añadir valor 'unknown' para el método de captura de tarjeta</li><li>añadir parámetro keyIndex para cardPersoData</li><li>updateCardState (TES a TSH) tiene nueva acción PARK\_AND\_DELETE</li><li>updateCardState (TSH a TES) tiene nueva acción BLACKLIST</li><li>updateCardState (TSH a TES) tiene nueva acción BLACKLIST</li><li>estados devueltos en getCards actualizados a CREATED, ACTIVE, SUSPENDED\_ISSUER, SUSPENDED\_WALLET, BLACKLISTED y DELETED</li></ul>                                                                                                                                                                                                                                                                                           |
| 1.0.2   | 22/10/2018         | <ul><li>añadir nuevo deviceType "UNKNOWN"</li><li>añadir nuevo código de error "provisioning count exceeded"</li><li>corregir error tipográfico en phoneNumerLastDigits, reemplazado por phoneNumberLastDigits</li><li>añadir 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 nueva API sendMessage que permite a TES solicitar la entrega de mensajes al usuario</li><li>eliminar el estado BLACKLISTED de getCards y la acción BLACKLIST de updateCardState (TSH a TES)</li><li>añadir nueva API refundCardAccount que permite a TES notificar a TSH que una cuenta de tarjeta ha sido reembolsada</li><li>Corregir problema en el swagger 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 hace 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 paymentInstrument (aplicable para createCardAccound y topupCardAccount)</p><ul><li>versión</li><li>cabecera</li><li>firma</li></ul></li><li>añadir nuevo parámetro de salida "signature" a createCardAccount y topupCardAccount</li><li>statusCode en responseHeader ahora es obligatorio</li><li>añadir nueva API getRequestStatus + nuevo código de error "unknow request"</li><li>añadir nueva acción LCM "ERASE" para cumplimiento GDPR / RoI</li><li>añadir nueva API getRequestStatus + nuevo código de error "unknow request"</li><li>añadir parámetro customerData en provisionCard</li></ul>                                                                                                                                                                                                                                                                                                                                                                                            |
| 1.0.4   | 10/12/2018         | <ul><li>eliminar APIs obsoletas "getPurchaseStatus" y "updatePurchaseStatus"</li><li>Nueva API Device GW getParkCardCommands para parking de 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 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 nuevo código de error 166 para información de tarjeta inválida</li><li>signature y paymentData en paymentInstrument están limitados a 8192 caracteres como máximo</li><li>añadir nuevo parámetro wrappedKey en paymentInstrument (usado para algoritmo RSA) para createCardAccount y topupCardAccount</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| 1.0.6   | 01/02/2019         | <ul><li>añadir nuevo método updateCardMetadata para la gestión de planes de transporte</li><li>añadir parámetro objeto cardContents en getReaderModeCommands</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| 1.0.7   | 08/02/2019         | <ul><li>añadir soporte para título localizado en planes de transporte</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| 1.0.8   | 21/02/2019         | <ul><li>alinear los valores posibles de operation entre initiateCardSession y getCardCommands</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| 1.0.9   | 18/03/2019         | <ul><li>Nuevo estado "UNLINKED" puede enviarse en updateCardState (TSH a TES)</li><li>Actualizar la API getCards para gestionar el estado UNLINKED de la tarjeta 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 del 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 inválidos</li><li>178 Tarjeta inválida, el estado de la tarjeta está en estación</li></ul></li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| 1.0.11  | 16/04/2019         | <ul><li><p>actualizar respuesta de getCards</p><ul><li>cardAccountId eliminado</li><li>walletAccountId, cardAccountState y walletCardAccountId están en nivel superior</li></ul></li><li>actualizar respuesta de provisionCard para la gestión de localización del nombre del titular</li><li><p>actualizar getParkCardCommands y getReaderModeCommands</p><ul><li>añadir nuevo parámetro "cardData" en la respuesta</li><li>cardData contiene "balanceAmount"</li></ul></li><li>código de error 221 añadido para la API 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 cliente TSM 2.2</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| 1.0.13  | 17/05/2019         | <ul><li>renombrar 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 parámetro opcional purchaseId</li><li>añadir parámetro opcional cardAccountId</li><li>añadir 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 error 432 para métodos 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 en walletProviderId proporcionada en checkCardAccount</li><li>añadir 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 al walletProviderId tal como se define en checkCardAccount</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| 1.0.18  | 26/10/2020         | <ul><li>añadir nuevo parámetro opcional "resultData" en notifyOperationResult para proporcionar información adicional a TES</li><li>añadir nuevo parámetro "purchaseId" que es proporcionado por TSH a TES en getCardCommands cuando está relacionado con una recarga iniciada desde la wallet.</li><li>añadir nuevo parámetro "cardData" en la respuesta de provisionCard.</li><li>añadir nuevo parámetro opcional "opaqueServiceProviderData" en las solicitudes createCardAccount y topupCardAccount.</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| 1.0.19  | 30/11/2021         | <ul><li>añadir nueva función getCardAccountsMetadata</li><li>añadir nueva función getCardActions</li><li>añadir nuevo parámetro opcional 'cardArtManifest' en la respuesta de checkCardAccount y en la solicitud updateCardMetadata</li><li>añadir nueva función getAsset</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| 1.0.20  | 28/02/2024         | <ul><li>añadir nuevo parámetro (matriz de objetos) "title" dentro del objeto cardActions de la respuesta getCardActions para permitir reemplazar valores predefinidos provisionados de forma estática</li><li>añadir <a href="https://thales-dis-dbp.stoplight.io/docs/digital-transit/33e2dd0faee3a-calypso-toc">Verdad Calypso sobre la preparación de datos de la tarjeta</a> sección</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| 1.0.21  | 14/1/2024          | <ul><li>añadir nuevo parámetro 'mobileApplicationInfo' en la respuesta 'checkCardAccount'</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| 1.0.22  | 11/12/2025         | <ul><li>añadir nuevo parámetro opcional 'cardArtManifest' en la respuesta de provisionCard</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:

```
GET https://docs.payments.thalescloud.io/transit-classic/es/referencia-de-la-api/historial-del-documento.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.