Obtener el estado de digitalización de la tarjeta

Obtener el estado de digitalización de la tarjeta

Utilice esta guía para determinar si una tarjeta ya está digitalizada en una billetera específica del dispositivo. La aplicación del emisor usa este estado para decidir si mostrar Agregar a la billetera o Activar tarjetao para ocultar ambas.

Normalmente llama a esta API cuando:

• la aplicación del emisor se inicia, o

• el usuario final abre una pantalla de detalles de la tarjeta.

Para el flujo general de provisión push, consulte Implementar push en billeteras digitales.

Descripción general

La aplicación del emisor usa el SDK D1 para comprobar el estado de tokenización de la tarjeta en el dispositivo móvil. Según el estado devuelto, la aplicación del emisor actualiza la interfaz de usuario:

• DIGITIZED – La tarjeta ya está tokenizada en la billetera de este dispositivo. Ocultar Agregar a la billetera y Activar tarjeta.

• NOT_DIGITIZED – La tarjeta no está tokenizada. Mostrar Agregar a la billetera.

• PENDING_IDV – La tarjeta digital está creada pero pendiente de ID&V. Mostrar Activar tarjeta si la autenticación en la aplicación es compatible.

Precaución

• Si la tarjeta sigue apareciendo como NOT_DIGITIZED después de la digitalización, compruebe que la aplicación del emisor esté configurada correctamente en el portal TSP.

• Para Samsung Pay, algunos emisores deben registrar varios nombres de emisor en el portal. Asegúrese de que el nombre del emisor usado en la API coincida con los nombres registrados en el portal. Solo se devuelven coincidencias exactas. Consulte la preguntas frecuentes de Samsung para obtener consejos de solución de problemas.

Flujo

Diagrama de secuencia

Requisitos previos

• La cuenta del consumidor y la tarjeta se registraron en D1

• El SDK está inicializado correctamente

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

Secuencia de alto nivel para recuperar el estado de digitalización de la tarjeta desde la billetera.

Integración de plataforma

Android

Para Android 2.4.0 y versiones posteriores, el SDK D1 expone la D1PushWallet.getCardDigitizationState() API para comprobar el estado de tokenización de la tarjeta para una billetera específica (Google Pay o Samsung Pay).

Los posibles estados son:

• DIGITIZED La tarjeta ya ha sido tokenizada. No se requiere ningún mensaje ni acción.

• NOT_DIGITIZED Mostrar un botón Agregar a Google/Samsung Pay . Consulte las directrices de marca de Google Pay para obtener más información. El siguiente paso es enviar la tarjeta a la billetera, como se explica en Enviar a la billetera digital.

• PENDING_IDV Mostrar un botón Activar tarjeta si la autenticación de la aplicación del emisor es compatible. Después de una autenticación correcta, llame a activateDigitalCard() para activar la tarjeta digital.

Consulte la referencia del SDK D1 para ver la firma completa de la API.

fun checkCardDigitizationState_v2_4_0(d1Task: D1Task, cardID: String) {
    val d1PushWallet = d1Task.d1PushWallet
    val wallet = OEMPayType.GOOGLE_PAY // puede ser SAMSUNG_PAY

    val callback: D1Task.Callback<CardDigitizationState> = object : D1Task.Callback<CardDigitizationState> {

        override fun onSuccess(state: CardDigitizationState) {
            // Actualiza la interfaz de usuario según el valor de estado.

            // Oculta el botón "Agregar a Google/Samsung Pay".
            // Oculta el botón "Activar tu tarjeta".
            when (state) {
                NOT_DIGITIZED -> {
                    // Muestra el botón "Agregar a Google/Samsung Pay".
                }
                PENDING_IDV -> {
                    // 1. Muestra el botón "Activar tu tarjeta".
                    // 2. Autentica al usuario final.
                    // 3. Realiza la activación: d1PushWallet.activateDigitalCard(cardID, wallet, callback)
                }
                DIGITIZED -> {
                    // Oculta el botón "Agregar a Google/Samsung Pay".
                }
                else -> {
                    // No hacer nada.
                }
            }
        }

        override fun onError(exception: D1Exception) {
            // Consulte la sección Gestión de errores de Integración del SDK D1.
        }
    }
    d1PushWallet.getCardDigitizationState(cardID, wallet, callback)
}

iOS

Para obtener acceso completo al SDK D1, consulte referencia de la API.