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

概要

カードの有効性は、最初のステップです トークン化。これは、カードがトークン化できるかどうかを確認します デジタルウォレットアプリケーション.

NFC Wallet SDK は、Token Service Provider (TSP) で有効性を確認します。

カードが対象の場合、SDK は TSP から利用規約 (T&C) を返します。T&C を表示して エンドユーザー デジタル化の前に同意を取得します。

お使いのプログラムによっては、 利用規約 は必須ではない場合があります。

有効性の確認と（必要な場合の）T&C への同意の後、次に進みます カードをデジタル化する.

SDK 連携

呼び出します MGCardEnrollmentService.checkEligibility() 確認するため トークン化 有効性。

次を提供してください:

• 有効性データ
• 次のいずれか:

  • 機器データ
  • pushSessionId

有効性データ には以下が含まれます:

• 言語: 優先言語（例、 en).
• inputMethod: カード情報がどのように収集されたか（たとえば、 イシュアアプリケーションによる認証 または手動入力）。

機器データ 次の項目から構築できます:

• encryptedCardData
• issuerPushReceipt

プッシュカード登録のユースケースでは、NFC Wallet のバックエンドは pushSessionId を イシュアのバックエンドが.

カード資格情報で有効性を確認

ほとんどの場合、カード資格情報を使って有効性を確認します。PAN と有効期限を指定してください。必要に応じてカードセキュリティコード（CSC）も指定してください。

// Enrollment Service のハンドラを取得
MGCardEnrollmentService enrollmentService =
        MobileGatewayManager.INSTANCE.getCardEnrollmentService();

// 暗号化されたカードデータと公開鍵からインストルメントデータを構築
InstrumentData instrumentData =
        new InstrumentData.EncryptedCardDataBuilder(encryptedCardInfo)
                .publicKeyIdentifier(pubKey)
                .build();

// 有効性データを構築
有効性Data 有効性Data =
        new 有効性Data.Builder(InputMethod.金融機関_APP, "en").build();

// リスナー Card有効性Listener で有効性を判定します
enrollmentService.check有効性(有効性Data, instrumentData, new Card有効性Listener() {
    @Override
    public void onSuccess(TermsAndConditions termsAndConditions, IssuerData issuerData) {
        // カードが有効であれば、T&C を取得します
        String tncContent = termsAndConditions.getContent();
        ContentType tncContentType = termsAndConditions.getContentType();

        // T&C を保存して表示します。
        // digitizeCard(...) を呼び出す前に同意を取得します。
    }

    @Override
    public void onError(MobileGatewayError error) {
        // カードが有効ではないか、リクエストに失敗しました。
        // エラーの理由を確認し、再試行するかフローを停止するかを判断します。
    }
});

イシュアのプッシュレシートで有効性を確認する

イシュアは以下から登録を開始できます イシュアアプリケーションによる認証。このフローでは、イシュアアプリケーションがイシュアのプッシュレシートを送信します。その デジタルウォレットアプリケーション それを使用して構築します 機器データ.

あるイシュアのプッシュレシートを使用した登録 イシュアのプッシュレシート はMastercardでのみサポートされています。NFC WalletはMDES Token Connect仕様をサポートしています。

構築 機器データ イシュアのプッシュレシートを使用して。次に呼び出します checkEligibility(...) カード認証情報フローと同様です。

final String type = "pushAccountReceipt"; // 定数
final String scheme = "MASTERCARD"; // Mastercard / MDES のみサポートされています
String payload = "..."; // イシュアアプリから受信したペイロード

// イシュアのプッシュレシートからインストゥルメントデータを構築します
InstrumentData instrumentData =
        new InstrumentData.イシュアPushReceiptBuilder(scheme, type, payload).build();

プッシュカード登録セッションIDで有効性を確認する

アプリケーションで暗号化されたカード詳細を扱うのを避けるため、 イシュアのバックエンドが イシュアはカード詳細を直接 NFC Wallet バックエンドにプッシュできます。NFC Wallet バックエンドは、一時的なプッシュカード登録セッション ID（pushSessionId).

// NFC Wallet バックエンドによって生成された pushSessionId を取得します
String pushSessionId = "....";

// Enrollment Service のハンドラを取得
MGCardEnrollmentService enrollmentService =
        MobileGatewayManager.INSTANCE.getCardEnrollmentService();

// カードの有効性を呼び出します
enrollmentService.checkEligibility(eligibilityData, pushSessionId, new Card有効性Listener() {
    @Override
    public void onSuccess(TermsAndConditions termsAndConditions, IssuerData issuerData) {
        // カードが有効であれば、T&C を取得します
        String tncContent = termsAndConditions.getContent();
        ContentType tncContentType = termsAndConditions.getContentType();

        // T&C を保存して表示します。
        // digitizeCard(...) を呼び出す前に同意を取得します。
    }

    @Override
    public void onError(MobileGatewayError error) {
        // カードが有効ではないか、リクエストに失敗しました。
    }
});

利用規約への同意

有効性の確認に成功したら、利用規約（T&C）を エンドユーザー 必要な場合。

その後、エンドユーザーが同意したら、次を作成します TermsAndConditionSession そしてそれを次に渡します digitizeCard(...)。参照してください カードをデジタル化する.

// 有効性から TermsAndConditions を取得します。
// termsAndConditions.getContentType() に基づいて termsAndConditions.getContent() を表示します。
// その後、エンドユーザーが受諾したら:
TermsAndConditionSession tncSession = termsAndConditions.accept();

この デジタルウォレットアプリケーション T&C を表示し、同意を収集する責任があります（プログラムで必要な場合）。

プログラムで暗黙の同意が許可されている場合は、 termsAndConditions.accept() エンドユーザーとのやり取りなしで。