カードをデジタル化する

概要

カードが有効性チェックに合格し、必要に応じてエンドユーザーが利用規約（T&C）を受け入れたら、デジタル化を開始します。

デジタル化の間：

• イシュアのバックエンドは トークナイゼーション 決定（グリーンフロー、イエローフロー、またはレッドフロー）をNFCウォレット経由でデジタルウォレットアプリケーションに返します。

• イシュアのバックエンドが承認する（グリーンフローまたはイエローフロー）の場合：

  • トークンリクエスタ（Token Requestor）はデジタルカードとそのアセット（プロファイルと支払いキー）を作成します。

  • NFCウォレットはデジタルカードのプロファイルと支払いキーをデジタルウォレットアプリケーション内に安全にプロビジョニングします。

イエローフローでは、カードをプロビジョニングする前にデジタルウォレットアプリケーションがID＆V（ステップアップ認証）を実行します。

レッドフローでは、デジタル化は拒否され、SDKはエラーコールバックを返します。

プログラムに基づいて、グリーンフロー、イエローフロー、またはその両方を実装してください。

プログラムによっては、 利用規約（T&C） は必須ではない場合があります。その場合、デジタルウォレットアプリケーションはエンドユーザーの操作なしにT&Cを受け入れることができます。

SDK の統合

開始 カードのデジタル化 を呼び出して MGCardEnrollmentService.digitizeCard(...).

まず実装する必要があります MGDigitizationListener 登録のカラー フローに従ってコールバックを処理することでデジタル化の進行状況を追跡するために：

• で： グリーンフロー（承認、ステップアップなし） SDKはこれらのコールバックを呼び出します：

  • onCPSActivationCodeAcquired

  • onComplete

  詳細については、参照してください グリーンフロードデジタル化.

• で： イエローフロー（ステップアップありで承認） SDKはさらに以下も呼び出します：

  • onSelectIDVMethod

  • onActivationRequired

  詳細については、参照してください イエローフロードデジタル化.

デジタル化エラーが発生した場合、NFCウォレットSDKは次のコールバックを発行します：

• onError：デジタル化に失敗しました。使用する error.getCode() を使用して、再試行するか、エンドユーザーに操作を求めるか、サポートに回すかを判断します。

MGDigitizationListener 実装例

以下のコードスニペットを参照して、を実装してください MGDigitizationListener

// Digitizationリスナーを構築します
public class MyDigitizationListener implements MGDigitizationListener {

    @Override
    public void onCPSActivationCodeAcquired(String digitalCardId, byte[] activationCode) {
        // このdigitalCardIdのプロビジョニングを開始するためにactivationCodeを受け取ります。
        // 「プロビジョニングセッションをトリガーする」を参照してください。
    }

    @Override
    public void onSelectIDVMethod(IDVMethodSelector idvMethodSelector) {
        // イエローフローのみ - ID＆Vメソッドのリストを受け取ります
        // 「イエローフロードデジタル化」を参照してください
    }

    @Override
    public void onActivationRequired(PendingCardActivation pendingCardActivation) {
        // イエローフローのみ - アクティベーションを必要とする選択されたID＆Vメソッド
        // 「イエローフロードデジタル化」を参照してください
   }

    @Override
    public void onComplete(String digitalCardId) {
        // デジタル化が正常に完了しました。
    }

    @Override
    public void onError(String digitalCardId, MobileGatewayError error) {
        // デジタル化に失敗しました。
        // error.getCode()を解析し、適切な再試行/復旧ロジックを適用します。
    }
});

カードをデジタル化する例

以下の例では、デジタル化を開始するためのコードを示します。

• グリーンフローの場合、を提供する必要があります 認証トークン.

// あなたのカードデジタリゼーションリスナーへの参照
// - コールバックを使用してデジタル化の進行状況を追跡するため
MyDigitizationListener digitizationListener = new MyDigitizationListener();

// 登録サービスを取得します。
// Enrollment Serviceのハンドラを取得する
        MGCardEnrollmentService enrollmentService =

digitizeCard(...)
// 「カードの有効性を確認する」を参照してください。
// その後、エンドユーザーの同意後：

// グリーンフローの場合は認証を提供します
byte[] authenticationToken = null;

enrollmentService.digitizeCard(tncSession, authenticationToken, digitizationListener);