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

概要

黄色のフローは、発行元バックエンドがステップアップ認証（ID&V）でトークン化を承認するトークン化フローです。

このフローは、NFCウォレットSDKが複数のイシュアのカードをトークン化するデジタルウォレットアプリに統合されている場合に一般的です。

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

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

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

シーケンス図

SDKを統合する

以下の後にカードの有効性を確認する:

呼び出す CardDigitizationService.digitizeCard().
条件付きでトークン化が承認された場合（黄色フロー）：
- NFCウォレットSDKは以下を発行します digitizationApprovedWithIDV.
発行元がサポートするID&V方式を取得するには、次を使用します IDVMethodSelector.getIDVMethodList().
方式を表示してエンドユーザーに選択させます。
IDVMethodSelector.select(idvID:) を呼び出して NFC ウォレット SDK に通知します IDVMethodSelector.select(idvID:).

サポートされているID&V方式

NFCウォレットSDKは次のID&V方式をサポートしています：

otpBySMS：SMSで送信されるワンタイムパスワード（OTP）でエンドユーザーを検証します。
otpByEmail：メールで送信されるワンタイムパスワード（OTP）でエンドユーザーを検証します。
customerService：イシュアのカスタマーサポートを通じてエンドユーザーを検証します。
webService：イシュアのウェブサイト上でエンドユーザーを検証します。
appToApp：イシュアのアプリ内でエンドユーザーを検証します。
- with cryptogram：イシュアアプリがイシュア暗号文（issuer cryptogram）を生成します。
- without cryptogram：イシュアが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 {
    /// 表示するために方式を一覧表示する
}

// ... ウォレットが選択されたID&V方式を取得するためのコード ...

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

OTPによるID&V

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

NFCウォレットSDKは以下を発行します activationRequired とともに PendingCardActivation.State に設定される otpNeeded.

エンドユーザーがOTPを入力した後、次を呼び出します PendingCardActivation.activate() とOTPの値を渡します。

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

OTP入力UIの実装

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

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

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

使用する IDVMethod.value で、イシュアのウェブポータルのURLやイシュアのカスタマーケアの電話番号を取得します。

発行元がエンドユーザーを正常に認証した後、発行元はTSPイシュアAPIを使用してトークンを有効化します。

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

プッシュの処理方法は、次に示すとおりです CPS通知の処理.

アプリ間（App-to-app）ID&V

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

NFCウォレットSDKは以下を発行します activationRequired とともに PendingCardActivation.State に設定される appToAppSelected.

使用する appToAppSelected.requestPayload, appToAppSelected.scheme、および appToAppSelected.source を使用してエンドユーザーをイシュアアプリにリダイレクトします。

イシュアアプリへリダイレクトする

アプリ間ID&V方式はMastercardおよびVisaでサポートされています。詳細はMastercardまたはVisaの仕様を参照してください。

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

2つの可能な方法があります：

暗号文付きのAppToApp：イシュアアプリがイシュア暗号文（issuer cryptogram）を生成します。
暗号文なしのAppToApp：イシュアがTSPイシュアAPIを使用してトークンを有効化します。

については、 暗号文付きのAppToAppを呼び出します PendingCardActivation.resumeAppToAppActivation(withTAV:) およびイシュア暗号文を提供します。NFCウォレットSDKはバックグラウンドでデジタルカードプロファイルをプロビジョニングします。プロビジョニングが完了すると、NFCウォレットSDKは以下を発行します activatedByIDV.

については、 暗号文なしのAppToAppを呼び出します PendingCardActivation.resumeAppToAppActivation()。その後、NFCウォレットバックエンドはデジタルウォレットアプリにプッシュ通知を送信します。プッシュの処理方法は次に示すとおりです CPS アクティベーションを再開する CPS通知の処理.

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

PendingCardActivationSession API。 これによりエンドユーザーはID&V方式を再選択できます：

、または otpBySMS, otpByEmail, customerService, webService暗号文付きのappToApp appToApp with cryptogram.

前へグリーンフローのデジタル化次へレッドフローを処理する

最終更新 3 か月前

役に立ちましたか？