Digitalización del flujo amarillo

Descripción general

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

Este flujo es común cuando el SDK de NFC Wallet se integra en una aplicación de billetera digital que tokeniza tarjetas de múltiples emisores.

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

Experiencia de usuario

Consulta Experiencia de usuario del flujo amarillo.

Diagrama de secuencia

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

Integrar el SDK

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

1. Llama a CardDigitizationService.digitizeCard().
2. Si la tokenización se aprueba con condiciones (flujo amarillo):

   • El SDK de NFC Wallet emite digitizationApprovedWithIDV.
3. Obtenga los métodos ID&V admitidos por el emisor usando IDVMethodSelector.getIDVMethodList().
4. Muestre los métodos y permita que el usuario final elija uno.
5. Notifique al SDK de NFC Wallet llamando a IDVMethodSelector.select(idvID:).

Métodos ID&V admitidos

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

• otpBySMS: Verifique al usuario final con una contraseña de un solo uso (OTP) enviada por SMS.
• otpByEmail: Verifique al usuario final con una contraseña de un solo uso (OTP) enviada por correo electrónico.
• customerService: Verifique al usuario final a través del servicio de atención al cliente del emisor.
• webService: Verifique al usuario final en el sitio web del emisor.
• appToApp: Verifique al usuario final en la aplicación del emisor.

  • con criptograma: La aplicación del emisor genera un criptograma del emisor.
  • sin criptograma: El emisor activa el token usando la API del emisor de TSP.

Liste y seleccione un método ID&V

Use el siguiente ejemplo para listar los métodos ID&V admitidos por el emisor.

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

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

    // Paso 3: Suscríbase a los eventos de digitalización.
    for await state in await cardDigitizationService.eventStream {
        switch state {
        case let .digitizationApprovedWithIDV(_, idvMethodSelector):
            // Flujo amarillo: liste los métodos ID&V admitidos 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 de app a app usando la aplicación del emisor.
                }
            }

        default:
            break
        }
    }
}

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

Seleccione un método 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 ID&V seleccionado ...

// seleccione 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 una OTP. Luego el TSP solicita al emisor que envíe la OTP por SMS o correo electrónico.

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

Después de que el usuario final introduzca la OTP, llame a PendingCardActivation.activate() con el valor de la OTP.

El SDK de NFC Wallet aprovisiona el perfil de la tarjeta digital en segundo plano. Cuando finaliza el aprovisionamiento, el SDK de NFC Wallet emite activatedByIDV.

Implemente la interfaz de entrada de OTP

El SDK de NFC Wallet no proporciona una interfaz de entrada de OTP. Implemente y personalice la interfaz de OTP en su aplicación de billetera digital.

ID&V de servicio al cliente o de servicio web

Si la aplicación de billetera digital selecciona webService o customerService, el emisor gestiona ID&V directamente. Esto se hace 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 correctamente al usuario final, el emisor activa el token usando la API del emisor de TSP.

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

Procese el push como se describe en Procesar notificaciones CPS.

ID&V de app a app

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

El SDK de NFC Wallet 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 ID&V de app a app es compatible con Mastercard y Visa. Consulte las especificaciones de Mastercard o Visa para obtener más detalles.

Después de que la aplicación del emisor complete la autenticación, redirige al usuario final de vuelta 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 usando la API del emisor de TSP.

Para AppToApp con criptograma, llame a PendingCardActivation.resumeAppToAppActivation(withTAV:) y proporcione el criptograma del emisor. El SDK de NFC Wallet aprovisiona el perfil de la tarjeta digital en segundo plano. Cuando finaliza el aprovisionamiento, el SDK de NFC Wallet emite activatedByIDV.

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

Reanudar activación

Si el proceso ID&V se interrumpe, reanúdelo usando el PendingCardActivationSession API.

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