Implementar el envío 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.

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.

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.

• 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.

• 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.

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.

Flujo de extremo a extremo

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

1

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 para flujos de SDK detallados y ejemplos.

2

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.

3

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 y en la referencia de la API del SDK de D1.

4

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.

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.

• 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.

Referencias relacionadas

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

• Descripción general de la provisión push

• Obtener el estado de digitalización de la tarjeta

• Enviar a la cartera digital

• extensión de Apple Wallet

• Resumen de la API de provisión push

• Integrar el SDK de D1