カード詳細を表示する

概要

このガイドでは、D1 SDK を使用して完全なカード情報（PAN、有効期限、カード所有者名、CVV2/dCVV2）を安全に表示する方法を説明します。

方法は 2 つあります:

• カード情報を取得し、イシュアアプリケーション UI で自分で表示します。
• データの露出を最小限に抑えるため、表示処理を D1 SDK に委任します。

PAN、有効期限、カード所有者名、または CVV2/dCVV2 を記録する可能性のあるログ、分析、クラッシュレポートは避けてください。必要なくなったらすぐに機密データをメモリから消去してください。

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

オプション 1: カード情報を取得する

この方法では、イシュアアプリケーションが呼び出します getCardDetails() 完全なカード情報を取得し、それを表示する責任を負います。

機密性を保つため、D1 SDK は値をプレーンテキスト文字列ではなくバイト配列として返します。取得できる項目:

• PAN
• 有効期限
• カード所有者名（エンドユーザー）— 任意
• CVV2 または dCVV2

シーケンス図

前提条件:

• エンドユーザーとカードは D1 に登録されています。
• D1 SDK は正しく初期化されています。
• イシュアアプリケーションが D1 SDK のログイン API を呼び出しました。

D1 SDK の統合

Android >= 4.4.0

fun getCardDetails(d1Task: D1Task, cardID: String, activity: FragmentActivity) {
    activity.lifecycleScope.launch {
        try {
            val cardDetails = d1Task.secureCardDisplayService.getCardDetails(cardID).await()

            // サーバーから受け取った cardDetails オブジェクトを処理し、バイト配列型を文字列に変換します
            val cardHolderName: String? =
                cardDetails.cardHolderName?.let { String(it, Charsets.UTF_8) }
            val pan = String(cardDetails.pan, Charsets.UTF_8)
            val expiryDate = String(cardDetails.expiryDate, Charsets.UTF_8)
            val cvv = String(cardDetails.cvv, Charsets.UTF_8)

            // cardDetails オブジェクトのバイト配列変数を消去します
            cardDetails.wipe()
        } catch (exception: D1Exception) {
            // D1 SDK の統合 – エラー管理セクションを参照してください
        }
    }
}

Android < 4.4.0

fun getCardDetails(d1Task: D1Task) {
            
  var cardID = "" // バックエンドから受け取ったカード ID
  val callback = object : D1Task.Callback<CardDetails> {
    
    override fun onSuccess(cardDetails: CardDetails) {
      // サーバーから受け取った cardDetails オブジェクトを処理し、バイト配列型を文字列に変換します。
      val cardHolderName: String? = cardDetails.cardHolderName?.let { String(it,Charsets.UTF_8) }
      val pan = String(cardDetails.pan, Charsets.UTF_8)
      val expiryDate = String(cardDetails.expiryDate, Charsets.UTF_8)
      val cvv = String(cardDetails.cvv, Charsets.UTF_8)
      // cardDetails オブジェクトのバイト配列変数を消去します。
      cardDetails.wipe()
    }

    override fun onError(exception: D1Exception) {
      // D1 SDK の統合 – エラー管理セクションを参照してください。
    }
  }

  d1Task.getCardDetails(cardID,callback)
}

iOS >= 4.4.0

let cardID = "" // 例: サーバーから取得
do {
    let service = try d1Task.secureCardDisplayService()
    var cardDetails = try await service.cardDetails(cardID)
    // その後のフローを継続します。例: UI を更新
    print("有効期限: \((String(data: cardDetails.expiryDate, encoding: .utf8) ?? ""))")
    print("CVV: \((String(data: cardDetails.cvv, encoding: .utf8) ?? ""))")
    print("名前: \(String(data: cardDetails.cardHolderName ?? Data(), encoding: .utf8) ?? "")")
    print("PAN: \((String(data: cardDetails.pan, encoding: .utf8) ?? ""))")
    
    // 使用後、バイト配列の cardDetails を消去します
    cardDetails.wipe()
        
    
} catch let d1Error as D1Error {
    // D1 SDK の統合 – エラー管理セクションを参照してください
} catch let error {
    // その他のエラーを処理します
}

iOS < 4.4.0

let cardID = "" // 例: サーバーから取得
d1Task.cardDetails(cardID) { cardDetails, error in
    if let error = error {
        // D1 SDK の統合 – エラー管理セクションを参照してください
    } else if var cardDetails = cardDetails {
        // その後のフローを継続します。例: UI を更新
        print("有効期限: \((String(data: cardDetails.expiryDate, encoding: .utf8) ?? ""))")
        print("CVV: \((String(data: cardDetails.cvv, encoding: .utf8) ?? ""))")
        print("名前: \(String(data: cardDetails.cardHolderName ?? Data(), encoding: .utf8) ?? "")")
        print("PAN: \((String(data: cardDetails.pan, encoding: .utf8) ?? ""))")

        // 使用後、バイト配列の cardDetails を消去します
        cardDetails.wipe()
    }
}

カスタム UI/UX と表示ライフサイクルを完全に制御する必要があるイシュアに最適です。メモリ内の保持時間を最小限にし、 wipe() を使用後すぐに呼び出してください。

オプション 2: 表示を D1 SDK に委任する

PAN の露出を減らすには、 displayCardDetails。ただし、 getCardDetails、この API はカードデータを返しません。代わりに、UI コンポーネントを CardDetailsUIとして渡します。D1 SDK がそれらのテキスト内容を安全に設定します。イシュアアプリケーションはスタイルとレイアウトを完全に制御できます。

このオプションは Visa と Mastercard のカードのみをサポートします。PAN の長さと表示方法が異なるため、Amex カードはサポートしません。

CardDetailsUI 提供内容:

• setPanMaskCharacter は PAN マスク文字を設定するための maskCardDetails （デフォルト: *).
• setPanSeparatorCharacter は 4 桁ごとの PAN 区切り文字を設定します（デフォルト: スペース）。
• setExpiryDateFormat は有効期限の形式を設定します（デフォルト: MM/YY).
• insecureCopyToClipboard は PAN をシステムクリップボードにコピーします。推奨されません。

次の値を表示できます:

• PAN
• 有効期限
• カード所有者名（エンドユーザー）— 任意
• CVV2 または dCVV2

シーケンス図

前提条件:

• エンドユーザーとカードは D1 に登録されています。
• D1 SDK は正しく初期化されています。
• イシュアアプリケーションが D1 SDK のログイン API を呼び出しました。

オプション 2 — D1 SDK が提供された UI コンポーネントにカード情報を表示します。

CardDetailsUI を含みます DisplayTextView （Android）と D1DisplayTextField （iOS）、ネイティブの TextView と UITextField。露出を抑えるため、 getText() は制限されています。

次を参照してください: Android セキュリティ ガイドライン を難読化するために DisplayTextView.

D1 SDK の統合

Android >= 4.4.0

fun displayCardDetails(d1Task: D1Task, cardID: String, cardDetailsUI: CardDetailsUI, activity: FragmentActivity) {
    activity.lifecycleScope.launch(Dispatchers.Main) {
        try {
            d1Task.secureCardDisplayService.displayCardDetails(cardID, cardDetailsUI)
                .await()
            // UI が更新されます
        } catch (exception: D1Exception) {
            // D1 SDK の統合 – エラー管理セクションを参照してください
        }
    }
    // UI が更新されます
}

Android < 4.4.0

fun displayCardDetails (d1Task: D1Task) {

  var view: View? = null // レイアウトをここでインフレートします。
  val panTextView: DisplayTextView? = null // view?.findViewById(R.id.panText)
  val expiryDateTextView: DisplayTextView? = null //view?.findViewById(R.id.expiryDateText)
  val cvvTextView: DisplayTextView? = null //view?.findViewById(R.id.cvvText)
  val cardHolderNameTextView: DisplayTextView? = null //view?.findViewById(R.id.cardHolderNameText)

  val cardDetailsUI = CardDetailsUI.getInstance(panTextView, expiryDateTextView,
  cvvTextView, cardHolderNameTextView)

  var cardID = "" // バックエンドから受け取ったカード ID。
  val callback = object : D1Task.Callback<Void> {
      override fun onSuccess(ignore: Void?) {
        // UI が更新されます。
      }

      override fun onError(exception: D1Exception) {
        // D1 SDK の統合 – エラー管理セクションを参照してください。
      }
    }

  d1Task.displayCardDetails(cardID, cardDetailsUI, callback)
}

iOS >= 4.4.0

let panTextField = D1DisplayTextField()
let cvvTextField = D1DisplayTextField()
let expiryDateTextField = D1DisplayTextField()
let cardHolderNameTextField = D1DisplayTextField()

/* 例: テキストフィールドをレイアウトします */

let cardDetailsUI = SecureCardDisplayService.CardDetailsUI(panTextField: panTextField,
                                                           expiryDateTextField: expiryDateTextField,
                                                           cvvTextField: cvvTextField,
                                                           cardHolderNameTextField: cardHolderNameTextField)

let cardID = "" // 例: サーバーから取得
do {
    let service = try d1Task.secureCardDisplayService()
    try await service.displayCardDetails(cardID, cardDetailsUI: cardDetailsUI)
} catch let d1Error as D1Error {
    // D1 SDK の統合 – エラー管理セクションを参照してください
} catch let error {
    // その他のエラーを処理します
}

iOS < 4.4.0

let panTextField = D1DisplayTextField()
let cvvTextField = D1DisplayTextField()
let expiryDateTextField = D1DisplayTextField()
let cardHolderNameTextField = D1DisplayTextField()

/* 例: テキストフィールドをレイアウトします */

let cardDetailsUI = CardDetailsUI(panTextField: panTextField,
        expiryDateTextField: expiryDateTextField,
        cvvTextField: cvvTextField,
        cardHolderNameTextField: cardHolderNameTextField)

let cardID = "" // 例: サーバーから取得
d1Task.displayCardDetails(cardID, cardDetailsUI: cardDetailsUI) { error in
    if let error = error {
        // D1 SDK の統合 – エラー管理セクションを参照してください
    } else {
        // UI が更新されます
    }
}

insecureCopyToClipboard PAN をシステム全体のクリップボードに公開するため、推奨されません。

カード情報をマスクして表示する

便利なことに、 CardDetailsUI カード情報をマスクしたり表示したりできます:

• maskCardDetails 詳細をマスクします。
• showCardDetails 詳細を表示します。セキュリティ上、これは常にサーバーからデータを再取得します。

ベストプラクティス: 短いタイマー（例: 1 分）を設定し、 maskCardDetails を呼び出して詳細を自動的に再マスクします。

Android >= 4.4.0

fun showCardDetails(cardDetailsUI: CardDetailsUI, activity: FragmentActivity) {
        activity.lifecycleScope.launch {
            try {
                // カード情報をマスクします
                cardDetailsUI.maskCardDetails()

                // カード情報を再度表示します
                cardDetailsUI.showCardDetails().await()
                // UI が更新されます
            } catch (exception: D1Exception) {
                // D1 SDK の統合 – エラー管理セクションを参照してください
            }
    }
}

Android < 4.4.0

fun showCardDetails (cardDetailsUI: CardDetailsUI) {
  // カード情報をマスクします。
  cardDetailsUI.maskCardDetails()

  val callback = object : D1Task.Callback<Void> {
    override fun onSuccess(ignore: Void?) {
      // UI が更新されます。
    }

    override fun onError(exception: D1Exception) {
      // D1 SDK の統合 – エラー管理セクションを参照してください。
    }
  }

  // カード情報を再度表示します。
  cardDetailsUI.showCardDetails(callback)
}

iOS >= 4.4.0

// カード情報をマスクします
cardDetailsUI.maskCardDetails()

// カード情報を再度表示します
do {
    try await cardDetailsUI.showCardDetails()
    // その後のフローを継続します
} catch let d1Error as D1Error {
    // D1 SDK の統合 – エラー管理セクションを参照してください
} catch let error {
    // その他のエラーを処理します
}

iOS < 4.4.0

// カード情報をマスクします
cardDetailsUI.maskCardDetails()

// カード情報を再度表示します
cardDetailsUI.showCardDetails() { error in
    if let error = error {
        // D1 SDK の統合 – エラー管理セクションを参照してください
    } else {
        // UI が更新されます
    }
}