Digitalización del flujo verde

Descripción general

El flujo verde es un flujo de tokenización en el que el backend del emisor aprueba la tokenización sin autenticación adicional.

Este flujo es común cuando el SDK de NFC Wallet está integrado en la aplicación del emisor y el usuario final ya está autenticado en la app.

Experiencia de usuario

Consulta Experiencia de usuario del flujo verde.

Diagrama de secuencia

Secuencia de digitalización del flujo verde

Integrar el SDK

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

1. Llama a CardDigitizationService.digitizeCard().

   Incluye un authenticationToken generado por el backend de tu billetera digital.
2. Si la tokenización se aprueba sin condiciones (flujo verde):

   • El SDK de NFC Wallet aprovisiona la tarjeta digital y las claves de pago en el dispositivo.
   • Cuando el aprovisionamiento tiene éxito, el SDK emite el digitizationApproved evento.

El siguiente ejemplo muestra cómo iniciar la digitalización y manejar el resultado del flujo verde.

func digitizeCard(
    _ términosYCondiciones: CardDigitizationService.TermsAndConditions
) async throws {
    // Paso 1: Inicializar el servicio.
    let cardDigitizationService = CardDigitizationService()

    // Paso 2: Recopilar entradas.
    let authenticationToken = Data() // Token del backend del emisor para el registro en flujo verde.
    let fcmToken = "FACY6074293608087656831WRF1234" // Solo un ejemplo.

    // Paso 3: Iniciar la digitalización.
    try await cardDigitizationService.digitizeCard(
        withTNC: termsAndConditions.accept(),
        pushToken: fcmToken, // Token de Firebase Cloud Messaging (FCM)
        language: "en",
        authenticationToken: authenticationToken
    )

    // Paso 4: Escuchar los resultados.
    for await state in await cardDigitizationService.eventStream {
        switch state {
        case let .digitizationApproved(digitalCardID):
            // Flujo verde: el aprovisionamiento tuvo éxito.
            _ = digitalCardID
            return
        default:
            break
        }
    }
}