Welcome to our new developer portal! Use the "Ask" button to chat with our AI Agent.
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Ver y controlar tarjetas digitales

Usa esta guía para permitir que el Usuario Final vea y gestione tarjetas digitales (tokens) creados para sus tarjetas en xPay Wallets y otros solicitantes de tokens.

En la aplicación del emisor, normalmente:

  • muestra todas las tarjetas digitales vinculadas a un cardId

  • muestra el estado de cada tarjeta digital (por ejemplo, activa o suspendida)

  • admite acciones básicas del ciclo de vida, como suspender, reanudar, eliminar y activar

Requisitos previos

Asegúrate de que:

  • El Usuario Final y la tarjeta estén registrados en el backend de D1.

  • El SDK D1 está integrado en tu aplicación del emisor e inicializado.

  • La aplicación del emisor ha completado el flujo de inicio de sesión del SDK D1.

Para el flujo completo de tokenización de wallet de extremo a extremo, consulta Implementar push a wallets digitales.

Ver tarjetas digitales

Para mostrar las tarjetas digitales existentes de un cardId, llama a getDigitalCardList().

La respuesta contiene una lista de objetos DigitalCard . Para Visa Cloud Token Framework (CTF), el DigitalCard objeto también incluye información de vinculación del dispositivo, lo que permite a la aplicación ver todas las vinculaciones de dispositivos asociadas a cada tarjeta digital.

El DigitalCard contiene la siguiente información:

  • Estado de la tarjeta digital (por ejemplo, activa, suspendida o pendiente de activación).

  • Fecha de caducidad de la tarjeta digital.

  • Últimos cuatro dígitos de la tarjeta digital.

  • Nombre y tipo del dispositivo que contiene la tarjeta digital.

  • ID del solicitante de tokens (tokenRequestorID).

  • Si la tarjeta digital está en el dispositivo actual (isOnCurrentDevice) para la wallet o el solicitante de tokens seleccionados (por ejemplo, Apple Pay, Google Pay, Samsung Pay o NFC Wallet).

  • Lista de vinculación de dispositivos (desde SDK 4.3.0 para Visa CTF). Contiene la referencia de vinculación, el nombre del dispositivo y el estado de la vinculación (APPROVED, DECLINED o CHALLENGED) para cada dispositivo vinculado.

Debido a limitaciones de la red de pagos, no siempre puedes recuperar en tiempo real el nombre y el logotipo del solicitante de tokens.

Como buena práctica, identifica los 5–10 IDs de solicitantes de tokens más relevantes para tu cartera y codifica de forma fija en la aplicación del emisor un nombre para mostrar y un logotipo visibles para el Usuario Final.

Flujo

Flow for retrieving the digital card list
Flujo de alto nivel para listar tarjetas digitales de una tarjeta.

Diagrama de secuencia

Requisitos previos

  • La cuenta del consumidor y la tarjeta fueron registradas en D1

  • El SDK está correctamente inicializado

  • La aplicación del emisor llamó a la API de inicio de sesión del SDK D1

Example issuer application screen showing a list of digital cards
Ejemplo de interfaz de la aplicación del emisor para listar tarjetas digitales.

Ejemplos

Controlar tarjetas digitales

La aplicación del emisor puede permitir al Usuario Final gestionar el estado de cada tarjeta digital.

Las acciones compatibles incluyen:

  • Suspender una tarjeta digital cuando el estado actual es activo: d1Task.updateDigitalCard(cardID, digitalCard, CardAction.SUSPEND, callback)

  • Reanudar una tarjeta digital cuando el estado actual es suspendido: d1Task.updateDigitalCard(cardID, digitalCard, CardAction.RESUME, callback)

  • Eliminar una tarjeta digital: d1Task.updateDigitalCard(cardID, digitalCard, CardAction.DELETE, callback)

  • Activar una tarjeta digital (por ejemplo, después de la autenticación reforzada): d1PushWallet.activateDigitalCard(digitalCard.getCardID(), callback)

Diagrama de secuencia

Requisitos previos

  • La cuenta del consumidor y la tarjeta fueron registradas en D1

  • El SDK está correctamente inicializado

  • La aplicación del emisor llamó a la API de inicio de sesión del SDK D1

Example issuer application screen for controlling digital cards
Ejemplo de interfaz de la aplicación del emisor para controlar el estado de una tarjeta digital.

Ejemplos

Para tener acceso completo al SDK D1, consulta referencia de API.

Última actualización

¿Te fue útil?