Gestionar el LCM de tarjetas digitales

Resumen

Utilice el SDK de NFC Wallet en su aplicación de monedero digital para gestionar el ciclo de vida de una tarjeta digital (LCM).

Caso de uso principal:

• Eliminar una tarjeta digital de la aplicación de monedero digital

Antes de comenzar, debe obtener un token de acceso como se describe en Obtenga un token de acceso.

En esta sección, describimos las acciones de LCM iniciadas desde la aplicación de monedero digital. El backend del emisor también puede iniciar directamente el LCM de la tarjeta digital con el TSP.

Integración del SDK

Use MGCardLifeCycleManager y el ID de la tarjeta digital para activar las acciones de LCM.

Implemente MGCardLifecycleEventListener para manejar onSuccess y onError las devoluciones de llamada.

Acciones admitidas:

• deleteCard
• suspendCard
• resumeCard

onSuccess confirma que el SDK de NFC Wallet aceptó la solicitud. La aplicación de monedero digital se actualiza después de recibir una notificación push.

Los cambios de backend de Thales NFC Wallet no aparecen inmediatamente en la aplicación de monedero digital.

backend de Thales NFC Wallet envía una notificación push para sincronizar el estado de la tarjeta digital.

Consulte Gestionar notificaciones push.

Eliminar una tarjeta digital

Eliminar una tarjeta digital usando MGCardLifeCycleManager.deleteCard(...).

Eliminar una tarjeta la elimina permanentemente de la aplicación de monedero digital.

DeleteCard.java

// obtener el token de acceso
String accessToken = "....";

// Obtener el gestor del ciclo de vida de la tarjeta.
MGCardLifeCycleManager cardLifeCycleManager = MGClient.getCardLifeCycleManager();

// Eliminar una tarjeta usando su ID de tarjeta digital.
cardLifeCycleManager.deleteCard(
    digitalCardId,
    new MGCardLifecycleEventListener() {
        @Override
        public void onSuccess(String digitalCardId) {
            /*
             * Solicitud aceptada por el SDK de NFC Wallet.
             * El backend de NFC Wallet envía una notificación push para completar la operación.
             *
             * Si la tarjeta ya está eliminada en el servidor, el SDK elimina los datos locales de la tarjeta.
             */
        }

        @Override
        public void onError(String digitalCardId, MobileGatewayError error) {
            /*
             * Solicitud fallida.
             * Inspeccione MobileGatewayError para determinar la causa.
             */
        }
    },
    null,
    null,
    accessToken );

Después de backend del emisor o aplicación de cartera digital iniciar una solicitud de eliminación, la tarjeta digital puede aparecer temporalmente como RETIRADAestado.

Durante este tiempo, DigitalizedCardManager#getAllCards() aún puede devolver la tarjeta.

La tarjeta desaparece de la lista después de que el SDK la elimina del almacenamiento local.

Suspender una tarjeta digital

Suspender una tarjeta digital usando MGCardLifeCycleManager.suspendCard(...).

Reanudar una tarjeta digital

Reanudar una tarjeta digital usando MGCardLifeCycleManager.resumeCard(...).