Welcome to our new developer portal! Use the "Ask" button to chat with our AI Agent.
Ctrlk
For the complete documentation index, see llms.txt. This page is also available as Markdown.

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

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

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

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

  1. デバイス上の選択したウォレットにそのカードがすでにデジタル化されているか確認します。

  2. カードがデジタル化されていない場合は、プッシュプロビジョニングフローを開始してウォレットにカードを追加します。

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

同じデバイス上の同じウォレットでは、カードを複数回デジタル化することはできません。デジタル化ステータスを使って、 ウォレットに追加 と カードを有効化 のアクション。

始める前に

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

  • 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 Unified Android Push Provisioning – Thalesは2026年10月までに新しいAPIとGoogle-OPCモデルをサポートします。

Thalesは、イシュアが移行作業を適切に計画できるよう、2026年6月までに案内を送付します。

エンドツーエンドのフロー

D1によるウォレットへのプッシュ実装は通常、次の手順で進みます:

1

カードのデジタル化ステータスを確認する

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

デジタル化ステータスに基づいてUIを制御します:

  • デジタル化済み – カードはこのデバイス上のウォレットですでにトークン化されています。非表示にします ウォレットに追加.

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

  • ID&V保留中 – トークン化はステップアップ認証待ちです。〜を表示します カードを有効化 アプリ内認証（ID&V）がサポートされている場合はボタンを表示します。

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

2

カードをデジタルウォレットにプッシュする

エンドユーザーが〜をタップしたとき ウォレットに追加 かつカードの状態が NOT_DIGITIZEDの場合、D1 SDKを呼び出してプッシュプロビジョニングフローを開始します。

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

  • D1に保存されているエンドユーザーおよびカードデータに基づいてペイロードを準備し

  • ウォレットアプリケーションとTSPと連携してトークン化を実行し

  • 結果をイシュアアプリケーションに返して、UIを更新できるようにします

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

3

有効化の処理（ID&V保留中）

デジタル化ステータスが ID&V保留中の場合、デジタルカードは作成されていますが、使用するには追加の認証が必要です。

この場合:

  • 選択したID&V方式を使用して、イシュアアプリケーションで認証するようエンドユーザーに促します。

  • 認証に成功したら、D1 SDKを呼び出してデジタルカードを有効化します。

有効化フローについては、次を参照してください カードのデジタル化状態を取得する およびD1 SDK APIリファレンス。

4

Apple Wallet拡張機能をサポートする

Apple Payでは、Apple Wallet拡張機能を統合して、エンドユーザーがイシュアアプリケーションだけでなく、Apple Walletアプリケーションから直接プロビジョニングを開始できるようにできます。

次のような場合に使用します:

  • Apple Walletが、イシュアアプリケーションで利用可能なカードを検出できるようにする

  • 専用のUI拡張機能を通じてエンドユーザーを認証する

  • 選択したカードのプロビジョニングペイロードをApple Walletに提供する

詳細は次を参照してください Apple Wallet拡張機能.

これが他のD1機能とどのように関連するか

  • 表示と制御 – カードがデジタル化された後は、D1 SDKを使用してデジタルカードを一覧表示し、ステータス（有効、停止、削除）を表示し、イシュアアプリケーション内でライフサイクル操作を管理できます。次を参照してください 表示と制御.

  • 決済ネットワークのプッシュプロビジョニング – 決済ネットワークプログラム（例: Mastercard token connect）にも参加している場合は、決済ネットワークに認定されたトークンリクエスタにカードをプッシュできます。次を参照してください Mastercard token connect.

関連リファレンス

デジタルウォレットへのプッシュを実装する際には、次のリファレンスを参照してください:

前へPush Provisioningを実装する
次へカードのデジタイゼーション状態を取得する

最終更新

役に立ちましたか？