Validação do usuário

Validação do usuárioWebhook POST

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.

Você pode conceder permissões para receber informações detalhadas em webhooks. Para fazer isso, você pode definir as seguintes opções como On na Conta de Distribuidor na seção Project settings > Webhooks > 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: ID país
Enviar parâmetros personalizados	As informações sobre os parâmetros de token personalizados são passadas no webhook.

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:

ID
país

Enviar parâmetros personalizados

As informações sobre os parâmetros de token personalizados são passadas no webhook.

Request

Request Body schema: application/json

notification_type

required

string

Tipo de notificação.

object

Configurações personalizadas do projeto (objeto).

merchant_id	integer ID de comerciante.
project_id	integer ID do projeto. Você pode encontrar esse parâmetro em sua Conta de Distribuidor ao lado do nome do projeto.

object

Dados do usuário (objeto).

id required	string ID de usuário.
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.
email	string E-mail do usuário.
ip	string IP do usuário.
name	string Nome de usuário.
phone	string Telefone do usuário.

Responses

204

Retorne para indicar o processamento bem-sucedido.

400

Retorne em caso de erro nas informações fornecidas (por exemplo, um parâmetro obrigatório ausente, falha na autorização, etc.).

500

Retorne para indicar erros temporários com seus servidores.

Request samples

CURL
PHP
HTTP

curl -v 'https://your.hostname/your/uri' \
-X POST \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' \
-H 'Authorization: Signature 13342703ccaca5064ad33ba451d800c5e823db8f' \
-d '{
    "notification_type":"user_validation",
    "settings": {
      "project_id": 18404,
      "merchant_id": 2340
    },
    "user": {
        "ip": "127.0.0.1",
        "phone": "18777976552",
        "email": "email@example.com",
        "id": "1234567",
        "name": "John Smith",
        "country": "US"
    }
}'

Response samples

application/json

{"error": {"code": "INCORRECT_AMOUNT",
"message": "Incorrect amount"
}
}