> 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/click-to-pay/ja/implement-click-to-pay-issuers/update-click-to-pay-profiles.md).

# Click to Pay のプロファイルを更新する

Click to Pay に保存されているエンドユーザーデータとカードデータは、時間の経過とともに変更される場合があります。

このページでは、イシュアのバックエンドが D1 を使用して Click to Pay ディレクトリを最新情報と同期し続ける方法を説明します。

D1 はこの目的のために 2 つの API を公開しています:

* **Click to Pay 更新 consumer** – エンドユーザー（consumer）のプロファイルデータを更新し、必要に応じてすべてのカードの請求先住所も更新します。
* **Click to Pay 更新 card** – 請求先住所などのカードレベルのデータ、および Visa のみを対象としたカード所有者名を更新します。

{% hint style="info" %}
**クイックリンク**

* [Click to Pay にカードを登録する](/click-to-pay/ja/implement-click-to-pay-issuers/enroll-cards-in-click-to-pay.md)
* [Click to Pay プロファイルを取得する](/click-to-pay/ja/implement-click-to-pay-issuers/retrieve-click-to-pay-profiles.md)
* [Click to Pay からカードをオプトアウトする](/click-to-pay/ja/implement-click-to-pay-issuers/opt-out-cards-from-click-to-pay.md)
  {% endhint %}

## 適切な API を選択する

次のガイダンスを使用して、どの API を呼び出すかを決定してください:

### Click to Pay API

* **Click to Pay 更新 consumer**\
  Click to Pay 内の consumer データのみを更新する必要がある場合に使用します（たとえば、Click to Pay と D1 をのみ統合している場合、または consumer プロファイルが D1 で完全には管理されていない場合）。一部の値のみが変更されていても、すべての consumer フィールドを指定してください。必要に応じて請求先住所を含め、すべてのカードの請求先住所を更新します。
* **Click to Pay 更新 card**\
  consumer プロファイルを変更せずに、Click to Pay に保存されているカードレベルのデータのみを変更する必要がある場合に使用します。たとえば、特定のカードの請求先住所や、Visa カードのカード所有者名などです。

### **D1 API**

* **consumer 情報を更新する**\
  エンドユーザープロファイルを D1 で管理しており、Click to Pay を含むすべてのチャネルを更新したい場合に使用します。エンドユーザーは D1 に完全に登録され、すでに Click to Pay に登録されている必要があります。更新は自動的に Click to Pay ディレクトリへ反映されるため、 **Click to Pay 更新 consumer** API を呼び出す必要はありません。
* **更新 / 置換**\
  D1 には最新データが更新されている必要があります。カードが更新または置換された場合（新しい PAN および/または有効期限）、D1 の **Renew** または **Replace** API を使用してください。これらのイベントに対する専用の Click to Pay API はありません。トークン化も有効になっている場合、D1 は既存トークン（Click to Pay トークンを含む）の再関連付けをオーケストレーションします。

## ユーザーエクスペリエンス

<figure><img src="/files/40d1b7ec58c1eef529b7eee83e475e768269c8c9" alt=""><figcaption></figcaption></figure>

## フロー

以下の図は、D1 経由で Click to Pay の consumer およびカード詳細を更新する全体のフローを示しています:

<figure><img src="/files/10c6e115ae9c1f481a15aaccbe3d4564c2dbb6d7" alt=""><figcaption></figcaption></figure>

## シーケンス図

### 前提条件

次を参照してください [前提条件](/click-to-pay/ja/implement-click-to-pay-issuers/enroll-cards-in-click-to-pay.md#prerequisites).

#### consumer 詳細を更新する

Click to Pay でエンドユーザー詳細を更新するには、D1 API を使用します [Click to Pay 更新 consumer](/click-to-pay/ja/integrate-the-d1-api/d1-api-summary.md).

D1 は更新されたデータを、関連するすべての Click to Pay ディレクトリ（複数のディレクトリが存在する場合）に転送します。これにより、イシュアのバックエンドは 1 回の API 呼び出しですべてのディレクトリを同期できます。

すべての consumer 詳細をリクエストで提供する必要があります。変更されていないフィールドも含みます:

* 名
* ミドルネーム
* 姓
* 電話番号
* メールアドレス
* 言語

必要に応じて、請求先住所が指定されている場合、D1 はその consumer に関連付けられた各カードの請求先住所も更新します。

以下のシーケンス図は、この動作を要約したものです:

<figure><img src="/files/f697685f6fd5851c2dfcf8c79f89d2702358c2fb" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
イシュアのバックエンドが D1 上でエンドユーザー詳細を完全に登録しており、エンドユーザーが Click to Pay に登録されている場合、 [consumer 情報を更新する](/click-to-pay/ja/integrate-the-d1-api/d1-api-reference/outbound-api-from-d1/consumer-api.md#post-notifications-d1-v2-issuers-issuerid-consumers) への呼び出しにより、更新内容は Click to Pay ディレクトリにも自動的に反映されます。この場合、 **Click to Pay 更新 consumer** を別途呼び出す必要はありません。
{% endhint %}

#### カード詳細を更新する

D1 API を使用して、Click to Pay に保存されている特定のカード詳細を更新することもできます [Click to Pay 更新 card](/click-to-pay/ja/integrate-the-d1-api/d1-api-summary.md).

この API は、次のカード属性の更新に使用できます:

* 請求先住所
* カード所有者名（任意 – Visa のみに適用）

以下のシーケンス図は、この動作を要約したものです:

<figure><img src="/files/24c5bed075e8949a0a27f3201529b96cf43ba7d7" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
カードの更新（有効期限の変更）またはカードの置換（新しい PAN と新しい有効期限）の場合、この目的に対する特定の Click to Pay API はありません。

これらのシナリオでは、イシュアのバックエンドは **必ず** 適切な [D1 API](/click-to-pay/ja/integrate-the-d1-api/d1-api-summary.md):

* Replace: カードが置換された場合（PAN 番号と有効期限の両方が変更）。
* Renew V2: 有効期限のみが変更。

または

* V1 のお客様向けには Renew V1 を使用します。
  {% endhint %}


---

# 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/click-to-pay/ja/implement-click-to-pay-issuers/update-click-to-pay-profiles.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.
