Migra a la API D1 v2

Migrar usuarios finales y tarjetas a las API V2

En D1, hay disponibles dos generaciones de API: V1 y V2.

V2 introduce nuevas capacidades, como las API de Controles de Autorización (por ejemplo, la API de control de límites).

Esta página es para emisores que ya tienen usuarios finales ("consumidores" en la API D1) y tarjetas registradas mediante las API V1 y desean migrarlos a V2 para poder usar las nuevas funciones de V2.

Pasos de la migración

Una migración de V1 a V2 consta de cuatro pasos. Algunos pasos los gestiona Thales; otros, el emisor.

Paso	Responsable	Descripción
1	Thales	Thales configura su tenant de emisor para la migración de V1 a V2. Esta configuración no tiene impacto en sus integraciones de backend de emisor existentes ni en el tráfico en vivo.
2	Emisor	El emisor integra la API V2 Register consumer y la API V2 Register card, y dirige todo el nuevo tráfico de registro a estas API V2. Como resultado, cada nuevo usuario final y tarjeta se crea directamente en V2. El emisor puede seguir utilizando todas las demás API V1, incluso para tarjetas que se registraron mediante V2.
3	Thales	Thales ejecuta el proceso de migración masiva. Todos los usuarios finales y tarjetas que previamente se registraron en V1 para este emisor se migran a V2. El emisor puede seguir usando las API V1, incluso para tarjetas que ya se han migrado a V2.
4	Emisor	El emisor integra las API de ciclo de vida restantes de V2 para usuarios finales y tarjetas — suspender, reanudar, renovar, reemplazar y eliminar para tarjetas, y eliminar para usuarios finales — y dirige todo el tráfico de ciclo de vida a estas API V2.

Limitaciones de la migración

Se aplican varios cambios de comportamiento y limitaciones durante una migración de V1 a V2.

Mapeo de datos

Los modelos de datos utilizados por las API V1 y V2 difieren para algunos atributos. Durante la migración, valores específicos de V1 se convierten automáticamente a los valores correspondientes de V2.

Atributo	API V1	Valor V1	API V2	Valor V2 después de la migración
Estado del consumidor	Consumidor	INACTIVO	Consumidor	ACTIVO (INACTIVE no es compatible en V2; los consumidores migrados se establecen en ACTIVE).
Estado del consumidor	Consumidor	ACTIVO	Consumidor	ACTIVO
Estado de la tarjeta	Tarjeta	INACTIVO	Tarjeta	SUSPENDIDA
Estado de la tarjeta	Tarjeta	ACTIVO	Tarjeta	ACTIVO
accountId de la tarjeta	Tarjeta	accountId	N/A	consumerId (reemplaza el accountId valor de V1 con el correspondiente consumerId).
Nombre de la tarjeta	N/A	N/A	Tarjeta	Cadena vacía (no se completa ningún nombre de tarjeta durante la migración).

Limitación por esquema

Solo las tarjetas Mastercard y Visa son compatibles en V2. Las tarjetas de otras redes de pago que existen en V1 no se migran a V2.

cardId y limitación de PAN

En las API V2, un cardId está asociado con exactamente un PAN. Es una asignación uno a uno.

En V1, múltiples cardId valores pueden estar vinculados al mismo PAN. Durante la migración:

• Solo se migra a V2 el cardId más reciente para un PAN dado ("gana la tarjeta más reciente").

• Valores cardId anteriores asociados con el mismo PAN no se migran y no son compatibles en V2.

• Si llama a una API V2 con uno de estos cardId valores no migrados, la API devuelve HTTP 404 No Encontrado.

API V1 Renew frente a las API V2 Renew y Replace

Esta limitación se aplica solo cuando la V1 Renew API se llama en una tarjeta que ya ha sido migrada a V2 (por ejemplo, después de que Thales haya iniciado la migración pero antes de que el emisor haya implementado completamente las API V2 Renew y V2 Replace).

En esta situación, la API V1 Renew devuelve HTTP 403 Prohibido si se cumple alguna de las siguientes condiciones:

• El newCardId en la carga útil es igual al cardId, pero el PAN de la tarjeta se ha actualizado.

• El newCardId en la carga útil no es igual al cardId, pero el PAN de la tarjeta sigue siendo el mismo.

• El newCardId en la carga útil no es igual al cardId y newCardStatus es INACTIVO.

• El reasonCode proporcionado en la carga útil no está permitido en V2.