> 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/push-provisioning/es/implement-push-provisioning/implement-push-to-digital-wallets.md).

# Implementar push a carteras digitales

## Implementar push a billeteras digitales

Use esta guía para integrar el aprovisionamiento push de D1 en la aplicación de su emisor para que los usuarios finales puedan agregar sus tarjetas a Apple Pay, Google Pay y Samsung Pay directamente desde su app.

A alto nivel, la aplicación del emisor debe:

1. Comprobar si la tarjeta ya está digitalizada en la cartera seleccionada del dispositivo.
2. Si la tarjeta no está digitalizada, iniciar el flujo de aprovisionamiento push para agregar la tarjeta a la cartera.

Para una introducción conceptual, consulte [Descripción general de push provisioning](/push-provisioning/es/get-started/push-provisioning-overview.md).

{% hint style="info" %}
Una tarjeta no puede digitalizarse más de una vez en la misma cartera en el mismo dispositivo. Use el estado de digitalización para guiar sus **Añadir a la billetera** y **Activar tarjeta** acciones.
{% endhint %}

### Antes de empezar

Asegúrese de que se cumplan los siguientes requisitos previos:

* **Incorporación a D1**
  * Ha completado la incorporación a D1 y puede acceder al backend de D1.
* **Registro en D1**
  * Los usuarios finales y las tarjetas están registrados en D1. Como mínimo, los `consumerId` y `cardId` están disponibles. Consulte la **Registro en D1** sección en [Primeros pasos](/push-provisioning/es/get-started.md).
* **Integración del SDK de D1**
  * El SDK de D1 está integrado en su aplicación emisora para Android y/o iOS, y el flujo de inicio de sesión del SDK está implementado. Consulte [Integre el SDK de D1](/push-provisioning/es/integrate-the-d1-sdk.md).
* **Inscripción en programas de wallet**
  * Está inscrito en los programas de wallet pertinentes (por ejemplo, Apple Pay, Google Pay, Samsung Pay) y cumple las directrices de marca y UX de cada proveedor.

{% hint style="warning" %}
***Provisionamiento push unificado de Android de Google** – Thales dará soporte a la nueva API y al modelo Google-OPC para octubre de 2026.*

*Thales enviará una comunicación en junio de 2026 para permitir que los emisores planifiquen correctamente las actividades de migración.*
{% endhint %}

### Flujo de extremo a extremo

La implementación de push-to-wallet con D1 suele seguir esta secuencia:

{% stepper %}
{% step %}
**Comprobar el estado de digitalización de la tarjeta**

Cuando la aplicación del emisor se inicia, o cuando el usuario final abre una pantalla de detalles de la tarjeta, use el SDK de D1 para recuperar el estado de digitalización de la tarjeta para una tarjeta y una cartera específicas (por ejemplo, Apple Pay, Google Pay o Samsung Pay).

El estado de digitalización guía su interfaz de usuario:

* **DIGITIZED** – La tarjeta ya está tokenizada en la billetera de este dispositivo. Oculta **Añadir a la billetera**.
* **NOT\_DIGITIZED** – La tarjeta no está tokenizada. Muestre un **Añadir a la billetera** botón.
* **PENDING\_IDV** – La tokenización está pendiente de autenticación adicional. Muestre un **Activar tarjeta** botón si se admite la autenticación en la aplicación (ID\&V).

Consulte [Obtén el estado de digitalización de la tarjeta](/push-provisioning/es/implement-push-provisioning/implement-push-to-digital-wallets/get-the-card-digitization-state.md) para ver flujos y ejemplos detallados del SDK.
{% endstep %}

{% step %}
**Enviar la tarjeta a la cartera digital**

Cuando el usuario final pulsa **Añadir a la billetera** y el estado de la tarjeta es `NOT_DIGITIZED`, llame al SDK de D1 para iniciar el flujo de aprovisionamiento push.

El SDK de D1 y el backend de D1:

* preparan la carga útil en función de los datos del usuario final y de la tarjeta almacenados en D1
* interactúan con la aplicación de la cartera y el TSP para realizar la tokenización
* devuelven el resultado a la aplicación del emisor para que pueda actualizar la interfaz

Para ver los pasos y diagramas de secuencia específicos de cada plataforma, consulte [Enviar a la billetera digital](/push-provisioning/es/implement-push-provisioning/implement-push-to-digital-wallets/push-to-the-digital-wallet.md).
{% endstep %}

{% step %}
**Gestionar la activación (ID\&V pendiente)**

Si el estado de digitalización es `PENDING_IDV`, la tarjeta digital se crea, pero requiere autenticación adicional antes de poder usarse.

En este caso:

* Pida al usuario final que se autentique en la aplicación del emisor mediante el método de ID\&V que haya elegido.
* Después de una autenticación correcta, llame al SDK de D1 para activar la tarjeta digital.

El flujo de activación se describe en [Obtén el estado de digitalización de la tarjeta](/push-provisioning/es/implement-push-provisioning/implement-push-to-digital-wallets/get-the-card-digitization-state.md) y en la referencia de la API del SDK de D1.
{% endstep %}

{% step %}
**Compatibilidad con extensiones de Apple Wallet**

Para Apple Pay, puede integrar extensiones de Apple Wallet para que los usuarios finales puedan iniciar el aprovisionamiento directamente desde la aplicación Apple Wallet, no solo desde su aplicación del emisor.

Use esto cuando quiera:

* permitir que Apple Wallet descubra qué tarjetas están disponibles en su aplicación del emisor
* autenticar al usuario final mediante una extensión de interfaz de usuario específica
* proporcionar cargas útiles de aprovisionamiento a Apple Wallet para tarjetas seleccionadas

Para más detalles, consulte [Extensión de Apple Wallet](/push-provisioning/es/implement-push-provisioning/implement-push-to-digital-wallets/apple-wallet-extension.md).
{% endstep %}
{% endstepper %}

### Cómo se relaciona esto con otras funciones de D1

* **Ver y controlar** – Después de que las tarjetas se digitalicen, puede usar el SDK de D1 para listar las tarjetas digitales, mostrar su estado (activa, suspendida, eliminada) y gestionar las operaciones del ciclo de vida dentro de la aplicación del emisor. Consulte [Ver y controlar](/push-provisioning/es/implement-push-provisioning/implement-view-and-control/view-and-control-digital-cards.md).
* **Aprovisionamiento push de la red de pago** – Si también participa en programas de la red de pago (por ejemplo, Mastercard token connect), puede enviar las tarjetas a token requestors certificados por la red de pago. Consulte [Mastercard Token Connect](/push-provisioning/es/implement-push-provisioning/implement-push-to-scheme/push-to-token-requestors-token-connect.md).

### Referencias relacionadas

Use estas referencias al implementar el push a monederos digitales:

* [Descripción general de push provisioning](/push-provisioning/es/get-started/push-provisioning-overview.md)
* [Obtén el estado de digitalización de la tarjeta](/push-provisioning/es/implement-push-provisioning/implement-push-to-digital-wallets/get-the-card-digitization-state.md)
* [Enviar a la billetera digital](/push-provisioning/es/implement-push-provisioning/implement-push-to-digital-wallets/push-to-the-digital-wallet.md)
* [Extensión de Apple Wallet](/push-provisioning/es/implement-push-provisioning/implement-push-to-digital-wallets/apple-wallet-extension.md)
* [Resumen de la API de aprovisionamiento push](broken://spaces/FmdnPRbEArkjtgwpgYya/pages/4c271cf7ba12b2ec862f6ec693361707a4031a7d)
* [Integre el SDK de D1](/push-provisioning/es/integrate-the-d1-sdk.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, and the optional `goal` query parameter:

```
GET https://docs.payments.thalescloud.io/push-provisioning/es/implement-push-provisioning/implement-push-to-digital-wallets.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.