Handle red flow

Overview

The red flow happens when the issuer backend declines Tokenization.

The decline is typically driven by risk rules or program policy.

When this happens, the application must display a decline message to end user.

Sequence diagram

Red flow: the issuer backend declines Tokenization and the NFC Wallet SDK emits digitizationDeclined.

Integrate SDK

After you Check card eligibility:

1. Call CardDigitizationService.digitizeCard().

2. Listen to CardDigitizationService.eventStream.

3. When the NFC Wallet SDK emits digitizationDeclined:

   • Stop the digitization flow.

   • Display a decline message.

   • Offer a retry path (optional).

func digitizeCard(_ termsAndConditions: CardDigitizationService.TermsAndConditions) async throws {
    // Step 1: Initialize the service.
    let cardDigitizationService = CardDigitizationService()
    let fcmToken: String = "FACY6074293608087656831WRF1234" // Example only.

    // Step 2: Start digitization.
    try await cardDigitizationService.digitizeCard(withTNC: termsAndConditions.accept(),
                                                  pushToken: fcmToken,
                                                  language: "en")

    // Step 3: Listen for outcomes.
    for await state in await cardDigitizationService.eventStream {
        switch state {
        case .digitizationDeclined:
            // Red flow: Tokenization declined by the issuer backend.
            // Show a decline message and stop the flow.
            return
        default:
            break
        }
    }
}