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

概要

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

NFC Walletは、Token Service Provider（TSP）と有効性を確認します。

カードが有効であれば、NFC WalletはTSPから利用規約（T&C）を返します。デジタル化前にT&Cをエンドユーザーに表示し、同意を取得してください。

プログラムによっては、 利用規約（T&C） 必要ない場合があります。

SDK 統合

使用する CardDigitizationService.check有効性 を確認する トークン化 有効性。該当する場合、NFC Walletバックエンドは適用される利用規約（T&C）を返します。

有効性チェックを実行するには、 有効性Data および次のいずれか InstrumentData または pushSessionID.

有効性Data には以下が含まれます:

• language: 操作に使用する優先言語（例： en).
• inputMethod: カード情報の収集方法（例: イシュアアプリケーションまたは手動入力）。

次のいずれかを指定してください:

• InstrumentData: 次のいずれかから構築されます encryptedCardData または issuerPushReceipt。カードデータは機密情報として扱い、必ず暗号化して送信してください。
• pushSessionID: NFC Walletバックエンドによって生成される一意の識別子です。イシュアのバックエンドは、プッシュカード登録時にこれを受け取ります。

カード資格情報を使用して有効性を確認する

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

カード資格情報は暗号化された形式で送信してください。

標準フローでは、イシュアのバックエンドがカード資格情報を提供します。デジタルウォレットアプリケーションは、それらを有効性チェックに使用します。

次のコードスニペットは、以下を使用して有効性を確認する方法を示しています encryptedCardData:

func triggerCheck有効性(_ pubKey: String, _ encryptedData: Data) async throws {
    do {
        let encryptedDataComponent = CardDigitizationService.InstrumentDataComponents(encryptedCardData: encryptedData, publicKeyIdentifier: pubKey)
        let instrumentData = encryptedDataComponent.instrumentData()
        // 有効性データを構築します
        let 有効性DataBuilder = CardDigitizationService.有効性DataComponents(inputMethod: .bankApp, language: "en")
        let 有効性Data = 有効性DataBuilder.有効性Data()
        let cardDigitizationService = CardDigitizationService()
        let acceptanceData = try await cardDigitizationService.check有効性(有効性Data, instrumentData: instrumentData)
        let tnc = acceptanceData.termsAndConditions
        // T&Cを保存し、UIに通知して応答を待ちます。
    } catch let error as CardDigitizationService.Error {
        // エラーを処理します。
    }
}

イシュアプッシュレシートを使用して有効性を確認する

イシュアはイシュアアプリケーションからカード登録を開始できます。このフローでは、イシュアアプリケーションがイシュアプッシュレシートを送信します。デジタルウォレットアプリケーションは、それを使用して InstrumentData.

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

次のコードスニペットは、以下を構築する方法を示しています InstrumentData イシュアプッシュレシートを使用して。次に 有効性を確認する カード資格情報を使用する場合と同じ方法で。

func triggerCheck有効性(_ payload: String, _ scheme: DigitalCard.Scheme) async throws {
    do {
        let pushReceiptDataComponent = CardDigitizationService.InstrumentDataComponents(scheme: scheme, payload: payload)
        let instrumentData = pushReceiptDataComponent.instrumentData()
        // 有効性データを構築します。
        let 有効性DataBuilder = CardDigitizationService.有効性DataComponents(inputMethod: .bankApp, language: "en")
        let 有効性Data = 有効性DataBuilder.有効性Data()
        let cardDigitizationService = CardDigitizationService()
        let acceptanceData = try await cardDigitizationService.check有効性(有効性Data, instrumentData: instrumentData)
        let tnc = acceptanceData.termsAndConditions
        // T&Cを保存し、UIに通知して、応答を待ちます。
    } catch let error as CardDigitizationService.Error {
        // エラーを処理します。
    }
}

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

アプリケーション内で暗号化されたカード詳細を共有しないようにするため、デジタルウォレットバックエンドはカード詳細をNFC Walletバックエンドに直接プッシュできます。NFC Walletバックエンドは一時的な プッシュカード登録セッションID (pushSessionID).

次のコードスニペットは、以下を使用して有効性を確認し、カード登録を続行する方法を示しています プッシュカード登録セッションID.

func triggerCheck有効性(_ pushSessionID: String) async throws {
    do {
        // 有効性データを構築します。
        let 有効性DataBuilder = CardDigitizationService.有効性DataComponents(inputMethod: .onFile, language: "en")
        let 有効性Data = 有効性DataBuilder.有効性Data()
        let cardDigitizationService = CardDigitizationService()
        let acceptanceData = try await cardDigitizationService.check有効性(有効性Data, pushSessionID: pushSessionID)
        let tnc = acceptanceData.termsAndConditions
        // T&Cを保存し、UIに通知して応答を待ちます。
    } catch let error as CardDigitizationService.Error {
        // エラーを処理します。
    }
}