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.

Click to Pay プロファイルを更新

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

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

D1 はこの目的のために 2 つの API を提供します:

  • Click to Pay のコンシューマー更新 – エンドユーザー（コンシューマー）のプロフィールデータを更新し、必要に応じてすべてのカードの請求先住所も更新します。

  • Click to Pay のカード更新 – 請求先住所などのカード単位のデータを更新し、Visa の場合はカード所有者名も更新します。

クイックリンク

適切な API を選択

どの API を呼び出すべきかを判断するには、次のガイダンスを使用してください:

Click to Pay API

  • Click to Pay のコンシューマー更新 Click to Pay 内のコンシューマーデータのみを更新する必要がある場合に使用します（たとえば、Click to Pay を D1 にのみ統合している場合や、コンシューマープロファイルが D1 で完全に管理されていない場合）。一部の値だけが変更された場合でも、すべてのコンシューマーフィールドを指定してください。必要に応じて請求先住所を含めると、すべてのカードの請求先住所を更新できます。

  • Click to Pay のカード更新 コンシューマープロファイルを変更せずに、Click to Pay に保存されているカード単位のデータのみを変更する必要がある場合に使用します。たとえば、特定のカードの請求先住所や、Visa カードのカード所有者名を更新する場合です。

D1 API

  • コンシューマー情報を更新 D1 でエンドユーザープロファイルを管理しており、Click to Pay を含むすべてのチャネルを更新したい場合に使用します。エンドユーザーは D1 に完全に登録され、すでに Click to Pay に登録済みである必要があります。更新は自動的に Click to Pay ディレクトリへ伝播されるため、呼び出す必要はありません Click to Pay のコンシューマー更新 API。

  • 更新 / 再発行 D1 には最新データが更新されている必要があります。D1 の 更新 または 再発行 API は、カードが更新または再発行された場合（新しい PAN および/または有効期限）に使用します。これらのイベント専用の Click to Pay API はありません。トークン化も有効になっている場合、D1 が既存のトークン（Click to Pay トークンを含む）の再関連付けを調整します。

ユーザー体験

フロー

下の図は、D1 を通じて Click to Pay のコンシューマーおよびカードの詳細を更新する全体のフローを示しています:

シーケンス図

前提条件

については参照してください 前提条件.

コンシューマー詳細を更新

Click to Pay のエンドユーザー詳細を更新するには、D1 API を使用します Click to Pay のコンシューマー更新.

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

変更されていないフィールドを含め、すべてのコンシューマー詳細をリクエストで指定する必要があります:

  • 名

  • ミドルネーム

  • 姓

  • 電話番号

  • メールアドレス

  • 言語

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

下のシーケンス図は動作を要約しています:

イシュアのバックエンドが D1 にエンドユーザー詳細を完全に登録しており、エンドユーザーが Click to Pay に登録済みであれば、への呼び出しで コンシューマー情報を更新 も更新を Click to Pay ディレクトリに自動的に伝播します。その場合、呼び出す必要はありません Click to Pay のコンシューマー更新 別々に。

カード詳細を更新

D1 API を使用して、Click to Pay に保存されている特定のカード詳細も更新できます Click to Pay のカード更新.

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

  • 請求先住所

  • カード所有者名（任意 – Visa のみに適用）

下のシーケンス図は動作を要約しています:

カードの更新（新しい有効期限）またはカードの再発行（新しい PAN と新しい有効期限）の場合、この目的の専用 Click to Pay API はありません。

これらのシナリオでは、イシュアのバックエンドは 必ず 適切な D1 API:

  • 再発行: カードが再発行された場合（PAN 番号と有効期限の両方が変更）。

  • 更新 V2: 有効期限のみが変更されます。

または

  • V1 のお客様向けの更新 V1。

前へD1 SDK によるプロファイル取得次へD1 SDK によるプロファイル更新

最終更新

役に立ちましたか？