> For the complete documentation index, see [llms.txt](https://docs.payments.thalescloud.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.payments.thalescloud.io/push-provisioning/ja/implement-push-provisioning/implement-push-to-digital-wallets.md).

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

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

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

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

1. デバイス上の選択したウォレットにそのカードがすでにデジタル化されているか確認します。
2. カードがデジタル化されていない場合は、プッシュプロビジョニングフローを開始してウォレットにカードを追加します。

概念的な概要については、次を参照してください [プッシュプロビジョニングの概要](/push-provisioning/ja/get-started/push-provisioning-overview.md).

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

### 始める前に

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

* **D1オンボーディング**
  * D1オンボーディングを完了しており、D1バックエンドにアクセスできます。
* **D1登録**
  * エンドユーザーとカードがD1に登録されていること。少なくとも、 `consumerId` と `cardId` が利用可能である必要があります。次を参照してください: **D1登録** のセクション [はじめに](/push-provisioning/ja/get-started.md).
* **D1 SDKの統合**
  * D1 SDKがAndroidおよび/またはiOS向けのイシュアアプリケーションに統合され、SDKのログインフローが実装されていること。次を参照してください: [D1 SDKを統合する](/push-provisioning/ja/integrate-the-d1-sdk.md).
* **ウォレットプログラムへの参加登録**
  * 関連するウォレットプログラム（例: Apple Pay、Google Pay、Samsung Pay）に参加登録しており、各提供元のブランドガイドラインおよびUXガイドラインに準拠しています。

{% hint style="warning" %}
***Google Unified Android Push Provisioning** – Thalesは2026年10月までに新しいAPIとGoogle-OPCモデルをサポートします。*

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

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

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

{% stepper %}
{% step %}
**カードのデジタル化ステータスを確認する**

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

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

* **デジタル化済み** – カードはこのデバイス上のウォレットですでにトークン化されています。非表示にします **ウォレットに追加**.
* **NOT\_DIGITIZED** – カードはトークン化されていません。〜を表示します **ウォレットに追加** ボタン。
* **ID\&V保留中** – トークン化はステップアップ認証待ちです。〜を表示します **カードを有効化** アプリ内認証（ID\&V）がサポートされている場合はボタンを表示します。

次を参照してください [カードのデジタル化状態を取得する](/push-provisioning/ja/implement-push-provisioning/implement-push-to-digital-wallets/get-the-card-digitization-state.md) 詳細なSDKフローと例については。
{% endstep %}

{% step %}
**カードをデジタルウォレットにプッシュする**

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

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

* D1に保存されているエンドユーザーおよびカードデータに基づいてペイロードを準備し
* ウォレットアプリケーションとTSPと連携してトークン化を実行し
* 結果をイシュアアプリケーションに返して、UIを更新できるようにします

プラットフォーム固有の手順とシーケンス図については、次を参照してください [デジタルウォレットへのプッシュ](/push-provisioning/ja/implement-push-provisioning/implement-push-to-digital-wallets/push-to-the-digital-wallet.md).
{% endstep %}

{% step %}
**有効化の処理（ID\&V保留中）**

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

この場合:

* 選択したID\&V方式を使用して、イシュアアプリケーションで認証するようエンドユーザーに促します。
* 認証に成功したら、D1 SDKを呼び出してデジタルカードを有効化します。

有効化フローについては、次を参照してください [カードのデジタル化状態を取得する](/push-provisioning/ja/implement-push-provisioning/implement-push-to-digital-wallets/get-the-card-digitization-state.md) およびD1 SDK APIリファレンス。
{% endstep %}

{% step %}
**Apple Wallet拡張機能をサポートする**

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

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

* Apple Walletが、イシュアアプリケーションで利用可能なカードを検出できるようにする
* 専用のUI拡張機能を通じてエンドユーザーを認証する
* 選択したカードのプロビジョニングペイロードをApple Walletに提供する

詳細は次を参照してください [Apple Wallet拡張機能](/push-provisioning/ja/implement-push-provisioning/implement-push-to-digital-wallets/apple-wallet-extension.md).
{% endstep %}
{% endstepper %}

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

* **表示と制御** – カードがデジタル化された後は、D1 SDKを使用してデジタルカードを一覧表示し、ステータス（有効、停止、削除）を表示し、イシュアアプリケーション内でライフサイクル操作を管理できます。次を参照してください [表示と制御](/push-provisioning/ja/implement-push-provisioning/implement-view-and-control/view-and-control-digital-cards.md).
* **決済ネットワークのプッシュプロビジョニング** – 決済ネットワークプログラム（例: Mastercard token connect）にも参加している場合は、決済ネットワークに認定されたトークンリクエスタにカードをプッシュできます。次を参照してください [Mastercard token connect](/push-provisioning/ja/implement-push-provisioning/implement-push-to-scheme/push-to-token-requestors-token-connect.md).

### 関連リファレンス

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

* [プッシュプロビジョニングの概要](/push-provisioning/ja/get-started/push-provisioning-overview.md)
* [カードのデジタル化状態を取得する](/push-provisioning/ja/implement-push-provisioning/implement-push-to-digital-wallets/get-the-card-digitization-state.md)
* [デジタルウォレットへのプッシュ](/push-provisioning/ja/implement-push-provisioning/implement-push-to-digital-wallets/push-to-the-digital-wallet.md)
* [Apple Wallet拡張機能](/push-provisioning/ja/implement-push-provisioning/implement-push-to-digital-wallets/apple-wallet-extension.md)
* [プッシュプロビジョニングAPIの概要](broken://spaces/Id8y50lrNNPMlMWNeBxq/pages/c3f4f606514aca02b43547f041805de149f8bcf0)
* [D1 SDKを統合する](/push-provisioning/ja/integrate-the-d1-sdk.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.payments.thalescloud.io/push-provisioning/ja/implement-push-provisioning/implement-push-to-digital-wallets.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.