カードのデジタル化状態を取得する

カードのデジタイズ状態を取得する

このガイドを使用して、デバイス上の特定のウォレットでカードがすでにデジタイズされているかどうかを判断します。イシュアアプリケーションは、この状態を使用して、 ウォレットに追加 または カードを有効化を表示するか、あるいは両方を非表示にするかを決定します。

通常、このAPIを呼び出すのは次の場合です。

• イシュアアプリケーションの起動時、または

• エンドユーザーがカード詳細画面を開いたとき。

プッシュプロビジョニングの全体的なフローについては、以下を参照してください デジタルウォレットへのプッシュを実装する.

概要

イシュアアプリケーションは、D1 SDKを使用してモバイルデバイス内のカードのトークン化状態を確認します。返された状態に基づいて、イシュアアプリケーションはUIを更新します。

• DIGITIZED – カードはこのデバイス上のウォレットですでにトークン化されています。非表示にします ウォレットに追加 および カードを有効化.

• NOT_DIGITIZED – カードはトークン化されていません。表示します ウォレットに追加.

• PENDING_IDV – デジタルカードは作成されていますが、ID&V待ちです。表示します カードを有効化 アプリ内認証がサポートされている場合。

注意

• カードがデジタイズ後も引き続き NOT_DIGITIZED として表示される場合は、TSPポータルでイシュアアプリケーションが正しく設定されていることを確認してください。

• Samsung Payでは、一部のイシュアはポータルに複数のイシュア名を登録する必要があります。APIで使用するイシュア名が、ポータルに登録された名前と一致していることを確認してください。完全一致のみが返されます。詳細は、 Samsung FAQ のトラブルシューティングのヒントを参照してください。

フロー

シーケンス図

前提条件

• コンシューマーアカウントとカードがD1に登録されている

• SDKが適切に初期化されている

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

ウォレットからカードのデジタイズ状態を取得するための高レベルのシーケンス。

プラットフォーム統合

Android

Android 2.4.0以降では、D1 SDKは D1PushWallet.getCardDigitizationState() APIを公開しており、特定のウォレット（Google PayまたはSamsung Pay）のカードのトークン化状態を確認できます。

可能な状態は次のとおりです。

• DIGITIZED カードはすでにトークン化されています。メッセージやアクションは不要です。

• NOT_DIGITIZED 以下を表示します Google/Samsung Pay に追加 ボタン。詳細については、Google Payの ブランドガイドライン を参照してください。次のステップは、 デジタルウォレットにプッシュする.

• PENDING_IDV 以下を表示します カードを有効化 で説明されているように、カードをウォレットにプッシュすることです。イシュアアプリケーション認証がサポートされている場合は、ボタンを表示します。認証に成功した後、 activateDigitalCard() を呼び出してデジタルカードを有効化します。

完全なAPIシグネチャについては、D1 SDKリファレンスを参照してください。

fun checkCardDigitizationState_v2_4_0(d1Task: D1Task, cardID: String) {
    val d1PushWallet = d1Task.d1PushWallet
    val wallet = OEMPayType.GOOGLE_PAY // SAMSUNG_PAY も使用できます

    val callback: D1Task.Callback<CardDigitizationState> = object : D1Task.Callback<CardDigitizationState> {

        override fun onSuccess(state: CardDigitizationState) {
            // state の値に基づいてUIを更新します。

            // 「Google/Samsung Pay に追加」ボタンを非表示にします。
            // 「カードを有効化」ボタンを非表示にします。
            when (state) {
                NOT_DIGITIZED -> {
                    // 「Google/Samsung Pay に追加」ボタンを表示します。
                }
                PENDING_IDV -> {
                    // 1. 「カードを有効化」ボタンを表示します。
                    // 2. エンドユーザーを認証します。
                    // 3. 有効化を実行します: d1PushWallet.activateDigitalCard(cardID, wallet, callback)
                }
                DIGITIZED -> {
                    // 「Google/Samsung Pay に追加」ボタンを非表示にします。
                }
                else -> {
                    //何もしません。
                }
            }
        }

        override fun onError(exception: D1Exception) {
            // D1 SDK Integration – Error Management セクションを参照してください。
        }
    }
    d1PushWallet.getCardDigitizationState(cardID, wallet, callback)
}

iOS

D1 SDKへの完全なアクセスについては、以下を確認してください APIリファレンス.