> 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 monederos digitales

## Implementar envío a carteras digitales

Use esta guía para integrar la provisión push de D1 en su aplicación emisora para que los usuarios finales puedan añadir sus tarjetas a Apple Pay, Google Pay y Samsung Pay directamente desde su aplicación.

A grandes rasgos, la aplicación emisora debe:

1. Comprobar si la tarjeta ya está digitalizada en la cartera seleccionada en el dispositivo.
2. Si la tarjeta no está digitalizada, iniciar el flujo de provisión push para añadir la tarjeta a la cartera.

Para una introducción conceptual, consulte [Descripción general de la provisión push](/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. Utilice el estado de digitalización para impulsar sus **Añadir a la cartera** y **Activar tarjeta** acciones.
{% endhint %}

### Antes de comenzar

Asegúrese de que se cumplen 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, el `consumerId` y `cardId` están disponibles. Consulte la **Registro en D1** sección en [Comenzar](/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 se ha implementado el flujo de inicio de sesión del SDK. Vea [Integrar el SDK de D1](/push-provisioning/es/integrate-the-d1-sdk.md).
* **Inscripción en el programa de la cartera**
  * Está inscrito en los programas de cartera relevantes (por ejemplo, Apple Pay, Google Pay, Samsung Pay) y cumple con las directrices de marca y UX de cada proveedor.

{% hint style="warning" %}
***Provisión push unificada 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 antes de junio de 2026 para permitir que los emisores planifiquen adecuadamente 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 se inicia la aplicación emisora, o cuando el usuario final abre la pantalla de detalles de una tarjeta, utilice el SDK de D1 para recuperar el estado de digitalización de una tarjeta específica y de la cartera (por ejemplo, Apple Pay, Google Pay o Samsung Pay).

El estado de digitalización impulsa su interfaz de usuario:

* **DIGITALIZADA** – La tarjeta ya está tokenizada en la cartera en este dispositivo. Ocultar **Añadir a la cartera**.
* **NO\_DIGITALIZADA** – La tarjeta no está tokenizada. Mostrar un **Añadir a la cartera** botón.
* **PENDIENTE\_IDV** – La tokenización está pendiente de una autenticación de elevación de nivel. Mostrar un **Activar tarjeta** botón si se admite la autenticación en la aplicación (ID\&V).

Consulte [Obtener 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 flujos de SDK detallados y ejemplos.
{% endstep %}

{% step %}

#### Enviar la tarjeta a la cartera digital

Cuando el usuario final toque **Añadir a la cartera** y el estado de la tarjeta sea `NO_DIGITALIZADA`, llame al SDK de D1 para iniciar el flujo de provisión 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 emisora para que pueda actualizar la interfaz de usuario

Para pasos específicos de la plataforma y diagramas de secuencia, consulte [Enviar a la cartera 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 `PENDIENTE_IDV`, la tarjeta digital está creada pero requiere autenticación adicional antes de poder usarse.

En este caso:

* Solicite al usuario final que se autentique en la aplicación emisora utilizando su método de ID\&V elegido.
* Después de la autenticación exitosa, llame al SDK de D1 para activar la tarjeta digital.

El flujo de activación se describe en [Obtener 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 %}

#### Soportar extensiones de Apple Wallet

Para Apple Pay, puede integrar extensiones de Apple Wallet para que los usuarios finales puedan comenzar la provisión directamente desde la aplicación Apple Wallet, no solo desde su aplicación emisora.

Use esto cuando quiera:

* permitir que Apple Wallet descubra qué tarjetas están disponibles en su aplicación emisora
* autenticar al usuario final a través de una extensión de interfaz de usuario dedicada
* proporcionar cargas útiles de provisión 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 estén digitalizadas, puede usar el SDK de D1 para listar las tarjetas digitales, mostrar su estado (activas, suspendidas, eliminadas) y gestionar las operaciones del ciclo de vida dentro de la aplicación emisora. Vea [Ver y controlar](/push-provisioning/es/implement-push-provisioning/implement-view-and-control/view-and-control-digital-cards.md).
* **Provisión push de la red de pagos** – Si también participa en programas de redes de pago (por ejemplo, Mastercard token connect), puede enviar tarjetas a solicitantes de tokens certificados por la red de pago. Vea [Mastercard token connect](/push-provisioning/es/implement-push-provisioning/implement-push-to-scheme/push-to-token-requestors-token-connect.md).

### Referencias relacionadas

Utilice estas referencias mientras implementa el envío a carteras digitales:

* [Descripción general de la provisión push](/push-provisioning/es/get-started/push-provisioning-overview.md)
* [Obtener 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 cartera 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 provisión push](broken://spaces/FmdnPRbEArkjtgwpgYya/pages/4c271cf7ba12b2ec862f6ec693361707a4031a7d)
* [Integrar 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:

```
GET https://docs.payments.thalescloud.io/push-provisioning/es/implement-push-provisioning/implement-push-to-digital-wallets.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.