デジタルウォレットへのプッシュを実装する

このガイドを使用して、D1 プッシュプロビジョニングをイシュアアプリに統合し、エンドユーザーがアプリから直接 Apple Pay、Google Pay、Samsung Pay にカードを追加できるようにします。

大まかには、イシュアアプリは次のことを行う必要があります：

概念的な導入については、次を参照してくださいプッシュプロビジョニングの概要.

同じデバイスの同じウォレットでカードを複数回デジタル化することはできません。デジタル化の状態を使って、あなたの ウォレットに追加 および カードを有効化 アクションを制御してください。

次の前提条件が満たされていることを確認してください：

D1 オンボーディング
- D1 のオンボーディングが完了しており、D1 バックエンドにアクセスできること。
D1 登録
- エンドユーザーとカードが D1 に登録されていること。最低でも、 consumerId および cardId が利用可能であること。詳しくは D1 登録 のセクションを参照してくださいはじめに.
D1 SDK 統合
- D1 SDK が Android および/または iOS 用のイシュアアプリに統合されており、SDK のログインフローが実装されていること。参照： D1 SDK を統合する.
ウォレットプログラムへの登録
- 関連するウォレットプログラム（例：Apple Pay、Google Pay、Samsung Pay）に登録されており、各プロバイダーのブランディングおよび UX ガイドラインに準拠していること。

Google 統合 Android プッシュプロビジョニング – Thales は新しい API と Google-OPC モデルを 2026 年 10 月までにサポートする予定です。

Thales は発行者が移行作業を適切に計画できるように、2026 年 6 月までに通知を送信します。

D1 を使用したプッシュトゥウォレットの実装は、通常次の順序に従います：

イシュアアプリが起動したとき、またはエンドユーザーがカード詳細画面を開いたときに、D1 SDK を使用して特定のカードとウォレット（例：Apple Pay、Google Pay、Samsung Pay）のカードデジタル化状態を取得します。

デジタル化の状態が UI を制御します：

DIGITIZED – カードはこのデバイスのウォレットですでにトークン化されています。を非表示にしてください ウォレットに追加.
NOT_DIGITIZED – カードはトークン化されていません。ボタンを表示してください ウォレットに追加 。
PENDING_IDV – トークン化はステップアップ認証を保留中です。アプリ内認証（ID&V）がサポートされている場合は、ボタンを表示してください カードを有効化 。

参照：カードのデジタル化状態を取得する詳細な SDK フローと例については。

エンドユーザーがをタップし、カード状態が ウォレットに追加 の場合、D1 SDK を呼び出してプッシュプロビジョニングフローを開始してください。 NOT_DIGITIZED。

D1 SDK と D1 バックエンドは：

プラットフォーム固有の手順およびシーケンス図については、次を参照してくださいデジタルウォレットへのプッシュ.

デジタル化状態が PENDING_IDVの場合、デジタルカードは作成されていますが、使用できるようになる前に追加の認証が必要です。

この場合：

有効化フローは次に記載されています：カードのデジタル化状態を取得するおよび D1 SDK API リファレンス。

Apple Pay については、Apple Wallet アプリケーションから直接プロビジョニングを開始できるように、Apple Wallet 拡張を統合することができます。これにより、必ずしもイシュアアプリからだけでなく Apple Wallet からも開始できます。

次のような場合にこれを使用します：

詳細については、次を参照してください Apple ウォレット拡張.

表示および制御 – カードがデジタル化された後、D1 SDK を使用してデジタルカードを一覧表示し、そのステータス（有効、停止、削除）を表示し、イシュアアプリ内でライフサイクル操作を管理できます。参照：表示および制御.
決済ネットワークのプッシュプロビジョニング – 例えば、Mastercard token connect のような決済ネットワークプログラムにも参加している場合、決済ネットワークによって認定されたトークンリクエスタにカードをプッシュすることができます。参照： Mastercard token connect.