デジタルカードを表示および制御する

トークン化サービスは、「View&Control」機能で Thales D1 SDK を使用するために必要です。

このガイドを使用して、 エンドユーザー が閲覧・管理できるようにします デジタルカード （トークン）を、以下のために作成された自分のカードに対して： xPay Wallets およびその他の トークンリクエスタ.

イシュアアプリケーションでは、通常次のことを行います：

• 特定の cardId

• に関連付けられたすべてのデジタルカードを表示する

• サスペンド、再開、削除、アクティベートなどの基本的なライフサイクル操作をサポートする

前提条件

次の点を確認してください：

• エンドユーザーとカードが、 D1 バックエンド.

• に登録されていること D1 SDK がイシュアアプリケーションに統合され、初期化されていること。

• イシュアアプリケーションが D1 SDK のログインフローを完了していること。

エンドツーエンドのウォレット・トークン化フローについては、こちらを参照してください： デジタルウォレットへの push 実装.

デジタルカードの表示

特定の既存のデジタルカードを表示するには cardId、次を呼び出します getDigitalCardList().

レスポンスには DigitalCard オブジェクトの一覧が含まれます。Visa Cloud Token Framework（CTF）では、 DigitalCard オブジェクトにはデバイスバインディング情報も含まれ、アプリケーションが各デジタルカードに関連付けられたすべてのデバイスバインディングを表示できるようになります。

に登録されていること DigitalCard 次の情報が含まれます：

• デジタルカードの状態（例：アクティブ、サスペンド、アクティベーション保留）。

• デジタルカードの有効期限。

• デジタルカードの下4桁。

• デジタルカードを含むデバイス名と種類。

• トークンリクエスタ ID（tokenRequestorID).

• 選択したウォレットまたはトークンリクエスタ（例：Apple Pay、Google Pay、Samsung Pay、NFC Wallet）に対して、デジタルカードが現在のデバイス上にあるかどうか（isOnCurrentDevice）。

• デバイスバインディング一覧（Visa CTF では SDK 4.3.0 以降）。各バインド済みデバイスのバインディング参照、デバイス名、バインディング状態（APPROVED、DECLINED、または CHALLENGED）を含みます。

決済ネットワークの制約により、トークンリクエスタ名とロゴを常にリアルタイムで取得できるとは限りません。

推奨事項として、ポートフォリオに関連する上位 5～10 件のトークンリクエスタ ID を特定し、エンドユーザー向けの表示名とロゴをイシュアアプリケーションにハードコードしてください。

フロー

カードのデジタルカード一覧表示のハイレベルフロー。

シーケンス図

前提条件

• 消費者アカウントとカードが D1 に登録されている

• SDK が正しく初期化されている

• イシュアアプリが D1 SDK ログイン API を呼び出した

デジタルカード一覧表示のイシュアアプリケーション UI の例。

例

Android

fun getDigitalCardList(d1Task: D1Task, cardID: String) {
    val callback: D1Task.Callback<List<DigitalCard>> = object : D1Task.Callback<List<DigitalCard>> {

        override fun onSuccess(digitalCardList: List<DigitalCard>) {
            // サーバーからの digitalCardList オブジェクトを処理します。
            // たとえば、上のサンプル画像のように UI に表示します。
            for (digitalCard in digitalCardList) {
                val digitalCardID = digitalCard.cardID
                val digitalCardState = digitalCard.state // 現在のデジタルカードの状態。
                val digitalCardExp = digitalCard.expiryDate // 現在のデジタルカードの有効期限。
                val last4 = digitalCard.last4 // 現在のデジタルカードの下4桁。
                val tokenRequestorID = digitalCard.tokenRequestorID // トークンリクエスタ ID。
                val isOnCurrentDevice = digitalCard.isOnCurrentDevice // デジタルカードが現在のデバイス上にあるかを識別します。

                // デバイスバインディング一覧を取得します（Visa CTF では SDK 4.3.0 以降）。
                val deviceBindingList = digitalCard.deviceBindingList
                deviceBindingList?.forEach { binding ->
                    val bindingReference = binding.bindingReference // バインディング参照 ID。
                    val deviceName = binding.deviceName // デバイス名。
                    val bindingStatus = binding.bindingStatus // APPROVED、DECLINED、または CHALLENGED。
                }
            }
        }

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

iOS

デジタルカードを制御する

イシュアアプリケーションでは、エンドユーザーが各デジタルカードの状態を管理できるようにできます。

サポートされる操作は次のとおりです：

• サスペンド 現在の状態がアクティブのデジタルカード： d1Task.updateDigitalCard(cardID, digitalCard, CardAction.SUSPEND, callback)

• 再開 現在の状態がサスペンドのデジタルカード： d1Task.updateDigitalCard(cardID, digitalCard, CardAction.RESUME, callback)

• 削除 デジタルカード： d1Task.updateDigitalCard(cardID, digitalCard, CardAction.DELETE, callback)

• アクティベート デジタルカード（例：追加認証後）： d1PushWallet.activateDigitalCard(digitalCard.getCardID(), callback)

シーケンス図

前提条件

• 消費者アカウントとカードが D1 に登録されている

• SDK が正しく初期化されている

• イシュアアプリが D1 SDK ログイン API を呼び出した

デジタルカードの状態を制御するイシュアアプリケーション UI の例。

例

Android

//digitalCard: getDigitalCardList API から取得
fun controlDigitalCard(d1Task: D1Task, cardID: String, digitalCard: DigitalCard) {
    val callback: D1Task.Callback<Boolean> = object : D1Task.Callback<Boolean> {

        override fun onSuccess(isSuccess: Boolean) {
            if (isSuccess) {
                // デジタルカードの状態が正常に更新されました。
                // アプリケーションは UI を更新できます。
            } else {
                // デジタルカードの状態の更新に失敗しました。
            }
        }

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

    // 現在のデジタルカードの状態が ACTIVE の場合
    d1Task.updateDigitalCard(cardID, digitalCard, CardAction.SUSPEND, callback)
}

iOS

D1 SDK を完全に利用するには、こちらを確認してください API リファレンス.