Welcome to our new developer portal! Use the "Ask" button to chat with our AI Agent.
Ctrlk
For the complete documentation index, see llms.txt. This page is also available as Markdown.

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

  • añadir nuevos códigos de error

    • provisionamiento de tarjeta rechazado

    • incompatibilidad de cuenta

    • datos de personalización inválidos

    • operación no permitida con el estado actual de la tarjeta

  • añadir parámetro opcional timestamp para cabeceras de solicitud/respuesta

  • añadir valor 'unknown' para el método de captura de tarjeta

  • añadir parámetro keyIndex para cardPersoData

  • updateCardState (TES a TSH) tiene nueva acción PARK_AND_DELETE

  • updateCardState (TSH a TES) tiene nueva acción BLACKLIST

  • updateCardState (TSH a TES) tiene nueva acción BLACKLIST

  • estados devueltos en getCards actualizados a CREATED, ACTIVE, SUSPENDED_ISSUER, SUSPENDED_WALLET, BLACKLISTED y DELETED

1.0.2

22/10/2018

  • añadir nuevo deviceType "UNKNOWN"

  • añadir nuevo código de error "provisioning count exceeded"

  • corregir error tipográfico en phoneNumerLastDigits, reemplazado por phoneNumberLastDigits

  • añadir parámetro opcional "displayCardNumber" en la respuesta de provisionCard

  • eliminar la acción PARK_AND_DELETE de updateCardState (TES a TSH)

  • añadir nueva API sendMessage que permite a TES solicitar la entrega de mensajes al usuario

  • eliminar el estado BLACKLISTED de getCards y la acción BLACKLIST de updateCardState (TSH a TES)

  • añadir nueva API refundCardAccount que permite a TES notificar a TSH que una cuenta de tarjeta ha sido reembolsada

  • Corregir problema en el swagger TES a TSH para el tipo cardPersoData

  • Reemplazar la operación PARK_CARD por BLOCK_AND_READ_CARD en initiateCardSession

  • 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.

1.0.3

05/11/2018

  • aumentar la longitud de orderId y purchaseId a 64 en lugar de 48

  • añadir nuevos parámetros en paymentInstrument (aplicable para createCardAccound y topupCardAccount)

    • versión

    • cabecera

    • firma

  • añadir nuevo parámetro de salida "signature" a createCardAccount y topupCardAccount

  • statusCode en responseHeader ahora es obligatorio

  • añadir nueva API getRequestStatus + nuevo código de error "unknow request"

  • añadir nueva acción LCM "ERASE" para cumplimiento GDPR / RoI

  • añadir nueva API getRequestStatus + nuevo código de error "unknow request"

  • añadir parámetro customerData en provisionCard

1.0.4

10/12/2018

  • eliminar APIs obsoletas "getPurchaseStatus" y "updatePurchaseStatus"

  • Nueva API Device GW getParkCardCommands para parking de tarjeta

  • añadir nuevos códigos de error para createCardAccount y topupCardAccount

    • 419 PIN requerido

    • 420 PIN incorrecto

    • 421 PIN bloqueado

  • Error en updateCardState (TSH a TES), purchaseId eliminado de la respuesta

  • Añadir productId en la solicitud createCardAccount

  • Añadir cardLastDigits en provisionCard

  • Corregir el prefijo URL para la API de notificaciones de tránsito (de xxx/v1.0 a xxx/1/0)

1.0.5

07/01/2019

  • eliminar el estado RECEIVED de la respuesta de la API getRequestStatus

  • añadir nuevo código de error 166 para información de tarjeta inválida

  • signature y paymentData en paymentInstrument están limitados a 8192 caracteres como máximo

  • añadir nuevo parámetro wrappedKey en paymentInstrument (usado para algoritmo RSA) para createCardAccount y topupCardAccount

1.0.6

01/02/2019

  • añadir nuevo método updateCardMetadata para la gestión de planes de transporte

  • añadir parámetro objeto cardContents en getReaderModeCommands

1.0.7

08/02/2019

  • añadir soporte para título localizado en planes de transporte

1.0.8

21/02/2019

  • alinear los valores posibles de operation entre initiateCardSession y getCardCommands

1.0.9

18/03/2019

  • Nuevo estado "UNLINKED" puede enviarse en updateCardState (TSH a TES)

  • Actualizar la API getCards para gestionar el estado UNLINKED de la tarjeta y ahora devolverá el estado de la cuenta de tarjeta

  • Nuevo parámetro opcional en la respuesta de provisionCard "cardholderName"

1.0.10

02/04/2019

  • Añadir nuevos códigos de error en la API del gateway de dispositivos

    • 172 Tarjeta inválida, código de sistema no compatible

    • 173 Tarjeta inválida, servicio no compatible

    • 177 Tarjeta inválida, datos de área inválidos

    • 178 Tarjeta inválida, el estado de la tarjeta está en estación

1.0.11

16/04/2019

  • actualizar respuesta de getCards

    • cardAccountId eliminado

    • walletAccountId, cardAccountState y walletCardAccountId están en nivel superior

  • actualizar respuesta de provisionCard para la gestión de localización del nombre del titular

  • actualizar getParkCardCommands y getReaderModeCommands

    • añadir nuevo parámetro "cardData" en la respuesta

    • cardData contiene "balanceAmount"

  • código de error 221 añadido para la API TES a TSH

1.0.12

24/04/2019

  • añadir códigos de error en el gateway de dispositivos para tener en cuenta la nueva especificación cliente TSM 2.2

1.0.13

17/05/2019

  • renombrar el valor de operation "RENEW_CARD" a "UPDATE_PLAN"

1.0.14

27/05/2019

  • actualización de notifyOperationResult

    • cardId ahora es opcional

    • añadir parámetro opcional purchaseId

    • añadir parámetro opcional cardAccountId

    • añadir parámetro isProvisioning

1.0.15

06/06/2019

  • walletAccountId se elimina de createCardAccount (solo se envía en provisionCard)

1.0.16

23/07/2019

  • eliminación de retryCount de los métodos del gateway de dispositivos

  • eliminación del error 922

  • añadir error 432 para métodos TSH a TES

  • aumentar la longitud de card perso data a 8192 en lugar de 500

1.0.17

11/12/2019

  • eliminar la restricción enum en walletProviderId proporcionada en checkCardAccount

  • 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

1.0.18

26/10/2020

  • añadir nuevo parámetro opcional "resultData" en notifyOperationResult para proporcionar información adicional a TES

  • 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.

  • añadir nuevo parámetro "cardData" en la respuesta de provisionCard.

  • añadir nuevo parámetro opcional "opaqueServiceProviderData" en las solicitudes createCardAccount y topupCardAccount.

1.0.19

30/11/2021

  • añadir nueva función getCardAccountsMetadata

  • añadir nueva función getCardActions

  • añadir nuevo parámetro opcional 'cardArtManifest' en la respuesta de checkCardAccount y en la solicitud updateCardMetadata

  • añadir nueva función getAsset

1.0.20

28/02/2024

  • 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

  • añadir Verdad Calypso sobre la preparación de datos de la tarjeta sección

1.0.21

14/1/2024

  • añadir nuevo parámetro 'mobileApplicationInfo' en la respuesta 'checkCardAccount'

1.0.22

11/12/2025

  • añadir nuevo parámetro opcional 'cardArtManifest' en la respuesta de provisionCard

AnteriorTránsito (Clásico)SiguienteDescripción general de la API

Última actualización

¿Te fue útil?