Migra tu integración de D1

Entiende qué cambia entre la API D1 v1 y v2 y cómo migrar de forma segura.

D1 ofrece dos generaciones de la API D1:

• v1 Las API usan /v1/ en la ruta URL.
• v2 Las API usan /v2/ en la ruta URL.

v2 es la opción recomendada para nuevas integraciones. También introduce nuevas capacidades y modelos actualizados para la gestión de usuarios finales y tarjetas.

Cuándo deberías migrar

Migra si el backend de tu emisor actualmente llama a endpoints v1 y quieres:

• Usar funciones exclusivas de v2 (por ejemplo, nuevos controles de autorización).
• Alinearte con los últimos modelos de la API D1 para operaciones del ciclo de vida de usuarios finales y tarjetas.
• Estandarizar en una sola versión de la API para tarjetas nuevas y existentes.

La API D1 usa el término consumer para un usuario final. Esta documentación usa end user, y mantiene los nombres de campos de la API tal cual (por ejemplo, consumerId).

Enfoque de migración recomendado

Usa el flujo guiado de migración de v1 a v2:

• Sigue Migrar a v2 para los pasos de extremo a extremo.
• Enruta nuevos registros a v2 primero.
• Migra los datos existentes (manejado por Thales).
• Luego mueve el tráfico del ciclo de vida (suspender, reanudar, renovar, reemplazar, eliminar) a v2.

Guías relacionadas

• Registrar usuarios finales y tarjetas
• Gestionar usuarios finales y tarjetas

Referencias de la API

• Referencias de la API D1 v1