Green flow digitization

Overview

Green flow is a Tokenization flow where the issuer backend approves Tokenization without step-up authentication.

This flow is common when the NFC Wallet SDK is integrated in the issuer application and the end user is already authenticated in-app.

User experience

See Green flow user experience.

Sequence diagram

Green flow digitization sequence

Integrate SDK

After you Check card eligibility:

1. Call CardDigitizationService.digitizeCard().

   Include an authenticationToken generated by your digital wallet backend.

2. If Tokenization is approved with no conditions (green flow):

   • The NFC Wallet SDK provisions the digital card and payment keys on the device.

   • When provisioning succeeds, the SDK emits the digitizationApproved event.

The example below shows how to start digitization and handle the green flow outcome.

func digitizeCard(
    _ termsAndConditions: CardDigitizationService.TermsAndConditions
) async throws {
    // Step 1: Initialize the service.
    let cardDigitizationService = CardDigitizationService()

    // Step 2: Collect inputs.
    let authenticationToken = Data() // Issuer backend token for green flow enrollment.
    let fcmToken = "FACY6074293608087656831WRF1234" // Example only.

    // Step 3: Start digitization.
    try await cardDigitizationService.digitizeCard(
        withTNC: termsAndConditions.accept(),
        pushToken: fcmToken, // Firebase Cloud Messaging (FCM) token
        language: "en",
        authenticationToken: authenticationToken
    )

    // Step 4: Listen for outcomes.
    for await state in await cardDigitizationService.eventStream {
        switch state {
        case let .digitizationApproved(digitalCardID):
            // Green flow: provisioning succeeded.
            _ = digitalCardID
            return
        default:
            break
        }
    }
}