> 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/d1-v1-api/es/migra-a-la-api-d1-v2.md). # 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). {% hint style="info" %} 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. {% endhint %} ### Pasos de la migración Una migración de V1 a V2 consta de cuatro pasos. Algunos pasos los gestiona Thales; otros, el emisor.
PasoResponsableDescripción
1ThalesThales 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.
2EmisorEl 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.
3ThalesThales 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.
4EmisorEl 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](broken://pages/1a25eb9cffe12b7953131ca5c04a8fce98e9ce82#post-issuers-issuerid-cards-cardid-operations-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. --- # 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/d1-v1-api/es/migra-a-la-api-d1-v2.md?ask= ``` 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.