Digitalización de flujo verde

Descripción general

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

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

Experiencia del usuario

Ver Experiencia del usuario del flujo verde.

Diagrama de secuencia

Secuencia de digitalización del flujo verde

Integrar SDK

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

1. Llamar a CardDigitizationService.digitizeCard().

   Incluir un authenticationToken generado por el backend de tu billetera digital.

2. Si la tokenización se aprueba sin condiciones (flujo verde):

   • El SDK de la billetera NFC provisiona la tarjeta digital y las claves de pago en el dispositivo.

   • Cuando la provisión tiene éxito, el SDK emite el digitizationApproved evento.

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

func digitizeCard(
    _ termsAndConditions: 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 la inscripción en el flujo verde.
    let fcmToken = "FACY6074293608087656831WRF1234" // Solo 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 resultados.
    for await state in await cardDigitizationService.eventStream {
        switch state {
        case let .digitizationApproved(digitalCardID):
            // Flujo verde: la provisión tuvo éxito.
            _ = digitalCardID
            return
        default:
            break
        }
    }
}