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 API を使用して、Click to Pay に保存されている特定のカード詳細も更新できます Click to Pay のカード更新.
この API は次のカード属性の更新に使用できます:
請求先住所
カード所有者名(任意 – Visa のみに適用)
下のシーケンス図は動作を要約しています:
最終更新
役に立ちましたか?