# 用户验证

艾克索拉向Webhook 
URL发送一个user_validation类型的Webhook以验证用户是否已在游戏中注册。该请求作为付款流程的一部分会被多次发送：

* 用户在支付UI中选择支付方式时
* 用户在支付表单中输入数据时，如通过PayPal支付时的银行卡数据或邮政编码
* 用户点击立即支付进行付款时
* 支付过程完成且交易状态变为done时

使用任何支付方式付款时都会发送该请求。

在发布商帐户中保存 Webhook URL 时，可以授予在 Webhook 中接收详细信息的权限。为此，请在发布商帐户的项目设置 > 
Webhooks> 高级设置部分中将所需开关设置为打开状态。


注：
如果是在2025年1月22日或之前注册的发布商帐户，可在项目设置> Webhooks> 测试 > 付款> 高级设置 部分中找到这些开关。




    
        开关
        描述
    


    
        仅发送不含敏感数据的必要用户参数
        Webhook中仅传递用户的以下信息：ID国家/地区
    
    
        发送自定义参数
        自定义令牌参数的信息在webhook中传递。

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)
    项目编号。您可以在您的[发布商帐户](https://publisher.xsolla.com/)项目名称旁边。

  - `user` (object)
    用户详情（对象）。

  - `user.country` (string)
    用户所在国家/地区。使用[ISO 3166-1 alpha-2 标准](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)规定的2字母组合表示国家/地区。

  - `user.email` (string)
    用户电子邮件。

  - `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