Digitalización del flujo amarillo

Descripción general

El flujo amarillo es un flujo de tokenización donde el backend del emisor aprueba la tokenización con autenticación adicional (ID&V).

Este flujo es común cuando el SDK de billetera NFC está integrado en una aplicación de billetera digital que tokeniza tarjetas para múltiples emisores.

En este caso, la solución debe autenticar mediante ID&V para completar la tokenización.

Experiencia del usuario

Ver Experiencia del usuario del flujo amarillo.

Diagrama de secuencia

Flujo amarillo: seleccionar un método de ID&V después de digitizationApprovedWithIDV.

Integrar SDK

Después de que tú Comprobar la elegibilidad de la tarjeta:

1. Llamar CardDigitizationService.digitizeCard().

2. Si la tokenización se aprueba con condiciones (flujo amarillo):

   • El SDK de billetera NFC emite digitizationApprovedWithIDV.

3. Obtén los métodos de ID&V compatibles por el emisor usando IDVMethodSelector.getIDVMethodList().

4. Muestra los métodos y permite que el usuario final elija uno.

5. Notifica al SDK de billetera NFC llamando IDVMethodSelector.select(idvID:).

Métodos de ID&V compatibles

El SDK de billetera NFC admite los siguientes métodos de ID&V:

• otpBySMS: Verifica al usuario final con una contraseña de un solo uso (OTP) enviada por SMS.

• otpByEmail: Verifica al usuario final con una contraseña de un solo uso (OTP) enviada por correo electrónico.

• customerService: Verifica al usuario final a través del servicio de atención al cliente del emisor.

• webService: Verifica al usuario final en el sitio web del emisor.

• appToApp: Verifica al usuario final en la aplicación del emisor.

  • with cryptogram: La aplicación del emisor genera un criptograma del emisor.

  • without cryptogram: El emisor activa el token utilizando la API del emisor del TSP.

Listar y seleccionar un método de ID&V

Utiliza el siguiente ejemplo para listar los métodos de ID&V compatibles por el emisor.

func digitizeCard(_ termsAndConditions: CardDigitizationService.TermsAndConditions) async throws {
    // Paso 1: Inicializa el servicio de digitización de tarjetas.
    let cardDigitizationService = CardDigitizationService()
    let fcmToken: String = "FACY6074293608087656831WRF1234" // Solo ejemplo.

    // Paso 2: Inicia el proceso de digitización de la tarjeta.
    try await cardDigitizationService.digitizeCard(withTNC: termsAndConditions.accept(),
                                                  pushToken: fcmToken,
                                                  language: "en")

    // Paso 3: Suscríbete a eventos de digitización.
    for await state in await cardDigitizationService.eventStream {
        switch state {
        case let .digitizationApprovedWithIDV(_, idvMethodSelector):
            // Flujo amarillo: listar los métodos de ID&V compatibles por el emisor.
            let verificationMethods = idvMethodSelector.getIDVMethodList()
            for method in verificationMethods {
                if method.type == .otpBySMS || method.type == .otpByEmail {
                    /// Método OTP.
                } else if method.type == .webService || method.type == .customerService {
                    /// Método gestionado directamente por el emisor.
                } else if method.type == .appToApp {
                    /// Método app-a-app usando la aplicación del emisor.
                }
            }

        default:
            break
        }
    }
}

Usar IDVMethod.id al llamar IDVMethodSelector.select(idvID:).

Seleccionar un método de ID&V

case let .digitizationApprovedWithIDV(digitalCardID, idvMethodSelector):

let verificationMethods = idvMethodSelector.getIDVMethodList()
for method in verificationMethods {
    /// listar métodos para mostrar
}

// ... código para que la billetera capture el método de ID&V seleccionado ...

// seleccionar el método usando el id del método
try await idvMethodSelector.select(idvID: selectedMethod.id)

ID&V con OTP

Si el usuario final selecciona otpBySMS o otpByEmail, el TSP genera un OTP. Luego el TSP solicita al emisor que envíe el OTP por SMS o correo electrónico.

El SDK de billetera NFC emite activationRequired con PendingCardActivation.State establecido en otpNeeded.

Después de que el usuario final ingrese el OTP, llama a PendingCardActivation.activate() con el valor del OTP.

El SDK de billetera NFC aprovisiona el perfil de la tarjeta digital en segundo plano. Después de que el aprovisionamiento se complete, el SDK de billetera NFC emite activatedByIDV.

Implementar la interfaz de entrada de OTP

El SDK de billetera NFC no proporciona una interfaz de entrada de OTP. Implementa y personaliza la interfaz de OTP en tu aplicación de billetera digital.

ID&V por servicio al cliente o servicio web

Si la aplicación de billetera digital selecciona webService o customerService, el emisor gestiona la ID&V directamente. Esto se realiza a través de un portal web del emisor o del servicio de atención al cliente del emisor.

Usar IDVMethod.value para obtener la URL del portal web del emisor o el número de teléfono del servicio de atención al cliente del emisor.

Después de que el emisor autentique con éxito al usuario final, el emisor activa el token utilizando la API del emisor del TSP.

Entonces el backend de la billetera NFC envía una CPS notificación push a la aplicación de billetera digital.

Procesa el push como se describe en Procesar notificaciones CPS.

ID&V app-a-app

En este método de ID&V, la aplicación de billetera digital redirige al usuario final a la aplicación del emisor.

El SDK de billetera NFC emite activationRequired con PendingCardActivation.State establecido en appToAppSelected.

Usar appToAppSelected.requestPayload, appToAppSelected.scheme, y appToAppSelected.source para redirigir al usuario final a la aplicación del emisor.

Redirigir a la aplicación del emisor

El método de ID&V app-a-app es compatible con Mastercard y Visa. Consulta las especificaciones de Mastercard o Visa para más detalles.

Después de que la aplicación del emisor complete la autenticación, redirige al usuario final de regreso a la aplicación de billetera digital.

Hay dos métodos posibles:

• AppToApp con criptograma: La aplicación del emisor genera un criptograma del emisor.

• AppToApp sin criptograma: El emisor activa el token utilizando la API del emisor del TSP.

Para AppToApp con criptograma, llama PendingCardActivation.resumeAppToAppActivation(withTAV:) y proporciona el criptograma del emisor. El SDK de billetera NFC aprovisiona el perfil de la tarjeta digital en segundo plano. Después de que el aprovisionamiento se complete, el SDK de billetera NFC emite activatedByIDV.

Para AppToApp sin criptograma, llama PendingCardActivation.resumeAppToAppActivation(). Luego el backend de la billetera NFC envía una CPS notificación push a la aplicación de billetera digital. Procesa el push como se describe en Procesar notificaciones CPS.

Reanudar la activación

Si el proceso de ID&V se interrumpe, reanúdalo usando la PendingCardActivationSession API.

Esto permite que el usuario final vuelva a seleccionar un método de ID&V: otpBySMS, otpByEmail, customerService, webService, o appToApp con criptograma.