イエローフローのデジタル化

概要

黄色フローは、イシュアのバックエンドがステップアップ認証（ID&V）を使用してトークナイゼーションを承認するトークナイゼーションフローです。

このフローは、NFC Wallet SDK が複数のイシュア向けにカードをトークン化するデジタルウォレットアプリに統合されている場合によく見られます。

この場合、ソリューションはトークナイゼーションを完了するために ID&V を使用して認証する必要があります。

ユーザー体験

参照 黄色フローのユーザー体験.

シーケンス図

黄色フロー: の後に ID&V メソッドを選択 digitizationApprovedWithIDV.

SDK を統合する

その後 カードの有効性を確認する:

1. 次を呼び出します CardDigitizationService.digitizeCard().

2. トークナイゼーションが条件付きで承認された場合（黄色フロー）:

   • NFC Wallet SDK は次を発行します digitizationApprovedWithIDV.

3. を使用してイシュア対応の ID&V メソッドを取得します IDVMethodSelector.getIDVMethodList().

4. メソッドを表示し、エンドユーザーに 1 つ選択させます。

5. 次を呼び出して NFC Wallet SDK に通知します IDVMethodSelector.select(idvID:).

対応する ID&V メソッド

NFC Wallet SDK は次の ID&V メソッドをサポートしています:

• otpBySMS: SMS で送信されたワンタイムパスワード（OTP）を使用してエンドユーザーを認証します。

• otpByEmail: メールで送信されたワンタイムパスワード（OTP）を使用してエンドユーザーを認証します。

• customerService: イシュアのカスタマーケアを通じてエンドユーザーを認証します。

• webService: イシュアの Web サイトでエンドユーザーを認証します。

• appToApp: イシュアアプリケーションでエンドユーザーを認証します。

  • 暗号値あり: イシュアアプリケーションがイシュアの暗号値を生成します。

  • 暗号値なし: イシュアが TSP イシュア API を使用してトークンを有効化します。

ID&V メソッドを一覧表示して選択する

次の例を使用して、イシュア対応の ID&V メソッドを一覧表示します。

func digitizeCard(_ termsAndConditions: CardDigitizationService.TermsAndConditions) async throws {
    // 手順 1: カードデジタル化サービスを初期化します。
    let cardDigitizationService = CardDigitizationService()
    let fcmToken: String = "FACY6074293608087656831WRF1234" // 例のみ。

    // 手順 2: カードデジタル化プロセスを開始します。
    try await cardDigitizationService.digitizeCard(withTNC: termsAndConditions.accept(),
                                                  pushToken: fcmToken,
                                                  language: "en")

    // 手順 3: デジタル化イベントを購読します。
    for await state in await cardDigitizationService.eventStream {
        switch state {
        case let .digitizationApprovedWithIDV(_, idvMethodSelector):
            // 黄色フロー: イシュア対応の ID&V メソッドを一覧表示します。
            let verificationMethods = idvMethodSelector.getIDVMethodList()
            for method in verificationMethods {
                if method.type == .otpBySMS || method.type == .otpByEmail {
                    /// OTP メソッド。
                } else if method.type == .webService || method.type == .customerService {
                    /// イシュアによって直接処理されるメソッド。
                } else if method.type == .appToApp {
                    /// イシュアアプリケーションを使用するアプリ間メソッド。
                }
            }

        default:
            break
        }
    }
}

使用する IDVMethod.id を呼び出すときに IDVMethodSelector.select(idvID:).

ID&V メソッドを選択

case let .digitizationApprovedWithIDV(digitalCardID, idvMethodSelector):

let verificationMethods = idvMethodSelector.getIDVMethodList()
for method in verificationMethods {
    /// 表示するメソッドを一覧化します
}

// ... code for wallet to capture the selected ID&V method ...

// メソッド ID を使用してメソッドを選択します
try await idvMethodSelector.select(idvID: selectedMethod.id)

OTP による ID&V

エンドユーザーが次を選択した場合 otpBySMS または otpByEmail、TSP が OTP を生成します。その後、TSP はイシュアに対し、SMS またはメールで OTP を送信するよう要求します。

NFC Wallet SDK は次を発行します activationRequired で PendingCardActivation.State に設定される otpNeeded.

エンドユーザーが OTP を入力したら、次を呼び出します PendingCardActivation.activate() OTP 値を使用して。

NFC Wallet SDK はバックグラウンドでデジタルカードプロファイルをプロビジョニングします。プロビジョニングが完了すると、NFC Wallet SDK は次を発行します activatedByIDV.

OTP 入力 UI を実装する

NFC Wallet SDK は OTP 入力 UI を提供しません。デジタルウォレットアプリで OTP UI を実装し、カスタマイズしてください。

カスタマーサービスまたは Web サービスによる ID&V

デジタルウォレットアプリケーションが次を選択した場合 webService または customerService、イシュアが ID&V を直接管理します。これはイシュアの Web ポータルまたはイシュアのカスタマーケアを通じて行われます。

使用する IDVMethod.value イシュアの Web ポータルの URL またはイシュアのカスタマーケアの電話番号を取得します。

イシュアがエンドユーザーの認証に成功すると、イシュアは TSP イシュア API を使用してトークンを有効化します。

その後、NFC Wallet バックエンドは次を送信します CPS デジタルウォレットアプリケーションへのプッシュ通知。

次の説明に従ってプッシュを処理します CPS 通知を処理する.

アプリ間 ID&V

この ID&V メソッドでは、デジタルウォレットアプリケーションがエンドユーザーをイシュアアプリケーションへリダイレクトします。

NFC Wallet SDK は次を発行します activationRequired で PendingCardActivation.State に設定される appToAppSelected.

使用する appToAppSelected.requestPayload, appToAppSelected.scheme、および appToAppSelected.source エンドユーザーをイシュアアプリケーションへリダイレクトするために

イシュアアプリケーションへリダイレクトする

このアプリ間 ID&V メソッドは Mastercard と Visa でサポートされています。詳細は Mastercard または Visa の仕様を参照してください。

イシュアアプリケーションが認証を完了すると、エンドユーザーはデジタルウォレットアプリケーションに戻されます。

可能なメソッドは 2 つあります:

• 暗号値ありの AppToApp: イシュアアプリケーションがイシュアの暗号値を生成します。

• 暗号値なしの AppToApp: イシュアが TSP イシュア API を使用してトークンを有効化します。

次の場合 暗号値ありの AppToApp、次を呼び出します PendingCardActivation.resumeAppToAppActivation(withTAV:) 、イシュアの暗号値を指定します。NFC Wallet SDK はバックグラウンドでデジタルカードプロファイルをプロビジョニングします。プロビジョニングが完了すると、NFC Wallet SDK は次を発行します activatedByIDV.

次の場合 暗号値なしの AppToApp、次を呼び出します PendingCardActivation.resumeAppToAppActivation()。その後、NFC Wallet バックエンドは次を送信します CPS デジタルウォレットアプリケーションへのプッシュ通知。次の説明に従ってプッシュを処理します CPS 通知を処理する.

アクティベーションを再開する

ID&V プロセスが中断された場合は、次を使用して再開します PendingCardActivationSession API。

これにより、エンドユーザーは ID&V メソッドを再選択できます: otpBySMS, otpByEmail, customerService, webService、または 暗号値ありの appToApp.