# ユーザー検証

エクソーラはユーザーがゲームに登録されていることを確認するために、user_validationタイプのウェブフックをウェブフックURLに送信します。このリ
クエストは支払いプロセスの一部として複数回送信されます：

* ユーザーが決済UIで決済方法を選択する場合
* ユーザーが決済フォームにデータを入力する場合（例: 銀行カードのデータやPayPal経由で支払う場合の郵便番号）
* ユーザーが今すぐ支払うをクリックして決済を続行する場合
* 支払処理が完了し、取引状況がdoneに変更された場合

このリクエストは、任意の決済方法で支払いを行う際に送信されます。

パブリッシャーアカウントにウェブフックURLを保存すると、ウェブフックで詳細情報を受信する権限を与えることができます。これを行うには、パブリッシャーアカウントの
「プロジェクト設定&gt
; ウェブフック> 詳細設定」セクションで必要なトグルを「アクティブ」に設定します。


注意
2025年1月22日以前にパブリッシャーアカウントに登録した場合は、「プロジェクト設定>ウェブフック>テスト>決済ソリューション>詳細設定」セクションでトグルを見つけます。




    
        トグル
        説明
    


    
        機密データは含まず、必要なユーザーパラメータのみを送信する
        ウェブフックでは、ユーザーに関する次の情報のみが渡されます：ID国
    
    
        カスタムパラメータを送信する
        カスタムトークンパラメータに関する情報は、ウェブフックで渡されます。

Endpoint: POST user-validation
Version: 1.0

## Request fields (application/json):

  - `notification_type` (string, required)
    通知タイプ。

  - `settings` (object)
    カスタムプロジェクト設定（オブジェクト）。

  - `settings.merchant_id` (integer)
    マーチャントID。

  - `settings.project_id` (integer)
    プロジェクトID。このパラメータは、[ドメインページ](https://publisher.xsolla.com/)のプロジェクト名の横にあります。

  - `user` (object)
    ユーザーの詳細（オブジェクト）。

  - `user.country` (string)
    ユーザーの国。2文字の国コード（大文字）は、[ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)に従って使用されます。

  - `user.email` (string)
    ユーザーのEメール。

  - `user.id` (string, required)
    ユーザーID。

  - `user.ip` (string)
    ユーザーIP。

  - `user.name` (string)
    ユーザー名。

  - `user.phone` (string)
    ユーザーの電話。

## Response 400 fields (application/json):

  - `error` (object)

  - `error.code` (string)

  - `error.message` (string)


## Response 204 fields

## Response 500 fields