# Validação do usuário

A Xsolla envia um webhook com o tipo user_validation para o URL do webhook 
para verificar se um usuário está cadastrado no jogo. A solicitação é enviada 
várias vezes como parte do processo de pagamento:

* Quando um usuário escolhe uma forma de pagamento na interface de pagamento.
* Quando um usuário insere dados no formulário de pagamento. Por exemplo, dados 
  de cartão bancário ou o CEP ao pagar via PayPal.
* Quando um usuário clica em Pagar agora para prosseguir com o pagamento.
* Quando o processo de pagamento for concluído e o status da transação for 
  alterado para done.

A solicitação é enviada ao pagar com qualquer método de pagamento.

Ao salvar o URL do webhook na Conta de Distribuidor, você pode conceder 
permissões para receber informações detalhadas nos webhooks. Para fazer isso, 
defina as opções necessárias como ativas na Conta de Distribuidor na seção Project 
settings > Webhooks > Advanced settings.


Observação
Se você se registrou na Conta de Distribuidor no dia 22 de janeiro de 2025 ou antes, você encontrará as opções na seção Project settings > Webhooks > Testing > Payments > Advanced settings.




    
        Opção
        Descrição
    


    
        Enviar apenas os parâmetros de usuário necessários sem dados confidenciais
        Somente as seguintes informações sobre o usuário são passadas no webhook:IDpaís
    
    
        Enviar parâmetros personalizados
        As informações sobre os parâmetros de token personalizados são passadas no webhook.

Endpoint: POST user-validation
Version: 1.0

## Request fields (application/json):

  - `notification_type` (string, required)
    Tipo de notificação.

  - `settings` (object)
    Configurações personalizadas do projeto (objeto).

  - `settings.merchant_id` (integer)
    ID de comerciante.

  - `settings.project_id` (integer)
    ID do projeto. Você pode encontrar esse parâmetro em sua [Conta de Distribuidor](https://publisher.xsolla.com/) ao lado do nome do projeto.

  - `user` (object)
    Dados do usuário (objeto).

  - `user.country` (string)
    País do usuário. Código de país de duas letras maiúsculas, de acordo com o [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).

  - `user.email` (string)
    E-mail do usuário.

  - `user.id` (string, required)
    ID de usuário.

  - `user.ip` (string)
    IP do usuário.

  - `user.name` (string)
    Nome de usuário.

  - `user.phone` (string)
    Telefone do usuário.

## Response 400 fields (application/json):

  - `error` (object)

  - `error.code` (string)

  - `error.message` (string)


## Response 204 fields

## Response 500 fields