Welcome to our new developer portal! Use the "Ask" button to chat with our AI Agent.

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

Referencias de la API

Última actualización

¿Te fue útil?