> 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/secure-card-display/ja/get-started/mange-end-users/register-end-users-via-api.md).

# API 経由でエンドユーザーを登録する

D1 でエンドユーザーを登録し、カードをエンドユーザーにリンクします。

これは、あなたのバックエンド間のフローです **イシュアバックエンド** と、 **D1バックエンド**.

エンティティ定義については、 [D1 の概念](/secure-card-display/ja/get-started/d1-concepts.md).

### エンドユーザー登録が必要な場合

エンドユーザー登録は、D1 の使い方によって異なります。

* **カード作成モデル**：D1 でカードを作成する前に、エンドユーザーを登録します。
* **カード登録モデル**：エンドユーザー登録は次のいずれかです。
  * **明示的**、D1 API 経由で。
  * **暗黙的**、カード作成またはカード登録中に（ `consumerId`).

### 定義する `consumerId`

あなたのイシュアのバックエンドが `consumerId` を各エンドユーザーに対して提供します。

D1 は `consumerId` を使用してエンドユーザーを識別します。

これは D1 API、D1 SDK、D1 ポータルで使用されます。

`consumerId` 個人情報を含めてはいけません。

氏名、メールアドレス、電話番号、PAN、または同様のデータは含めないでください。

### 登録モデルを選択する

D1 バックエンドがエンドユーザーの個人情報を保存するかどうかを選択してください。

この選択により、登録フローが変わります。

#### D1 バックエンドに個人情報を保存する

D1 に個人情報を保存させたい場合は、このモデルを使用します。

その後、D1 はデータをキャッシュできます。

これにより、イシュアのバックエンドへの呼び出し回数が減ります。

で必須フィールドを指定してください `personalInformation`.

スキーマは [コンシューマー登録](/secure-card-display/ja/integrate-d1-api/d1-api-reference/inbound-api-to-d1/consumer-api.md#put-issuers-issuerid-consumers-consumerid).

個人情報が変更されたら、D1 を最新の状態に保ちます。

使用 [コンシューマーを更新](/secure-card-display/ja/integrate-d1-api/d1-api-reference/inbound-api-to-d1/consumer-api.md#post-issuers-issuerid-consumers-consumerid-operations-update).

<figure><img src="/spaces/62lLFDcmLCeqqwmy4Fee/files/i5w22YlP0DfCZyKP7F4y" alt=""><figcaption><p>イシュアのバックエンドと D1 バックエンド間のエンドユーザー登録フロー。</p></figcaption></figure>

API 呼び出し：

* [コンシューマー登録](/secure-card-display/ja/integrate-d1-api/d1-api-reference/inbound-api-to-d1/consumer-api.md#put-issuers-issuerid-consumers-consumerid) （ `personalInformation`)
* [コンシューマーを更新](/secure-card-display/ja/integrate-d1-api/d1-api-reference/inbound-api-to-d1/consumer-api.md#post-issuers-issuerid-consumers-consumerid-operations-update)

#### D1 バックエンドに個人情報を保存しない

D1 に個人情報を保存してはならない場合は、このモデルを使用します。

それでも、エンドユーザーを明示的に登録できます。

を呼び出す [コンシューマー登録](/secure-card-display/ja/integrate-d1-api/d1-api-reference/inbound-api-to-d1/consumer-api.md#put-issuers-issuerid-consumers-consumerid) なしで `personalInformation`.

明示的な登録を省略することもできます。

カード作成またはカード登録中の暗黙的な登録に依存します。

D1 が個人情報を必要とするときは、あなたのイシュアのバックエンドを呼び出します。

たとえば、D1 はトークナイゼーションに対してこれを実行できます。

それは [消費者情報を取得](https://thales-dis-dbp.stoplight.io/d1-caas/branches/mergeV1V2/80c02eb3c9adf-get-consumer-information).

{% hint style="info" %}
すでに コンシューマー登録 1.0 を使用している場合は、そのまま使い続けられます。新しい統合では v2 エンドポイントを使用してください。
{% endhint %}

<figure><img src="/spaces/62lLFDcmLCeqqwmy4Fee/files/WExE2X1EC8srhZAcoLqX" alt=""><figcaption></figcaption></figure>

API 呼び出し：

* [コンシューマー登録](/secure-card-display/ja/integrate-d1-api/d1-api-reference/inbound-api-to-d1/consumer-api.md#put-issuers-issuerid-consumers-consumerid) （ `personalInformation`)
* [消費者情報を取得](https://thales-dis-dbp.stoplight.io/d1-caas/branches/mergeV1V2/80c02eb3c9adf-get-consumer-information)

### エンドポイントの概要

イシュアバックエンドからD1バックエンドへ：

* [コンシューマー登録](/secure-card-display/ja/integrate-d1-api/d1-api-reference/inbound-api-to-d1/consumer-api.md#put-issuers-issuerid-consumers-consumerid)
* [コンシューマーを更新](/secure-card-display/ja/integrate-d1-api/d1-api-reference/inbound-api-to-d1/consumer-api.md#post-issuers-issuerid-consumers-consumerid-operations-update) （D1 が個人情報を保存する場合）
* [消費者情報を取得](https://thales-dis-dbp.stoplight.io/d1-caas/branches/mergeV1V2/80c02eb3c9adf-get-consumer-information) （D1 が個人情報を保存しない場合）


---

# 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/secure-card-display/ja/get-started/mange-end-users/register-end-users-via-api.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.