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

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

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

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

{% stepper %}
{% step %}

#### カードのデジタル化状態を確認する

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

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

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

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

{% step %}

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

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

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 保留）を処理する

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

この場合：

* 選択した 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 からも開始できます。

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

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

詳細については、次を参照してください [Apple ウォレット拡張](/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 ウォレット拡張](/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.