> 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-tu-integracion-de-d1.md).

# Migra tu integración de D1

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.

{% hint style="info" %}
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`).
{% endhint %}

## Enfoque de migración recomendado

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

* Sigue [Migrar a v2](/d1-v1-api/es/migra-a-la-api-d1-v2.md) 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](/d1-v1-api/es/registra-usuarios-finales-y-tarjetas-en-d1.md)
* [Gestionar usuarios finales y tarjetas](/d1-v1-api/es/gestiona-usuarios-finales-y-tarjetas.md)

## Referencias de la API

* [Referencias de la API D1 v1](/d1-v1-api/es/referencias-de-la-api-d1-v1.md)


---

# 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-tu-integracion-de-d1.md?ask=<question>
```

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.