グリーンフローのデジタル化

概要

グリーンフローは、イシュアのバックエンドがステップアップ認証なしでトークン化を承認するトークン化フローです。

このフローは、NFCウォレットSDKがイシュアのアプリ内で統合され、エンドユーザーが既にアプリ内で認証済みの場合に一般的です。

ユーザーエクスペリエンス

参照 グリーンフローのユーザーエクスペリエンス.

シーケンス図

グリーンフローのデジタル化シーケンス

SDKを統合する

次の操作を実行した後 カードの有効性を確認する:

1. 呼び出す CardDigitizationService.digitizeCard().

   を含める authenticationToken あなたのデジタルウォレットのバックエンドによって生成されたもの。

2. 条件なしでトークン化が承認された場合（グリーンフロー）：

   • NFCウォレットSDKはデバイス上にデジタルカードと支払いキーをプロビジョニングします。

   • プロビジョニングに成功すると、SDKは digitizationApproved イベントを発行します。

以下の例は、デジタル化を開始し、グリーンフローの結果を処理する方法を示します。

func digitizeCard(
    _ termsAndConditions: CardDigitizationService.TermsAndConditions
) async throws {
    // ステップ1: サービスを初期化します。
    let cardDigitizationService = CardDigitizationService()

    // ステップ2: 入力を収集します。
    let authenticationToken = Data() // グリーンフロー登録のためのイシュアのバックエンドトークン。
    let fcmToken = "FACY6074293608087656831WRF1234" // サンプルのみ。

    // ステップ3: デジタル化を開始します。
    try await cardDigitizationService.digitizeCard(
        withTNC: termsAndConditions.accept(),
        pushToken: fcmToken, // Firebase Cloud Messaging (FCM) トークン
        language: "en",
        authenticationToken: authenticationToken
    )

    // ステップ4: 結果を監視します。
    for await state in await cardDigitizationService.eventStream {
        switch state {
        case let .digitizationApproved(digitalCardID):
            // グリーンフロー: プロビジョニングが成功しました。
            _ = digitalCardID
            return
        default:
            break
        }
    }
}