Xsolla-logo

Проверка пользователейWebhook POST

Xsolla отправляет вебхук с типом user_validation на URL-адрес вебхука, чтобы удостовериться, что пользователь зарегистрирован в игре. В процессе оплаты запрос отправляется несколько раз:

  • при выборе способа оплаты в платежном интерфейсе;
  • вводе данных в форме оплаты, например, при вводе данных банковской карты или индекса для оплаты с помощью PayPal;
  • нажатии Далее для перехода к оплате;
  • завершении обработки платежа и переходе транзакции в статус done.

Запрос отправляется при оплате любыми способами.

Вы можете настроить получение дополнительной информации в вебхуке. Для этого в Личном кабинете в разделе Настройки проекта > Вебхуки > Расширенные настройки вы можете установить следующие переключатели в положение Вкл:

Переключатель Описание
Показывать только необходимую информацию о пользователе без чувствительных данных

В вебхуке о пользователе будет передаваться только следующая информация:

  • ID;
  • страна.
Передавать кастомные параметры В вебхуке будет передаваться информация о кастомных параметрах из токена.
Request
Request Body schema: application/json
notification_type
required
string

Тип оповещения.

object

Объект, содержащий настройки проекта.

merchant_id
integer

ID продавца.

project_id
integer

ID проекта. Вы можете найти этот параметр в Личном кабинете рядом с названием проекта.

object

Объект с информацией о пользователе.

id
required
string

ID пользователя.

country
string

Страна пользователя. Используется двухбуквенное обозначение страны согласно стандарту ISO 3166-1 alpha-2.

email
string

Email пользователя.

ip
string

IP адрес пользователя.

name
string

Имя пользователя.

phone
string

Номер телефона пользователя (в международном формате).

Responses
204

Верните, чтобы сообщить об успешной обработке вехбука.

400

Верните в случае ошибки в предоставленной информации (например, обязательный параметр не передан, или авторизация не прошла).

500

Верните, чтобы сообщить о временных ошибках на ваших серверах.

Request samples
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": {
    }
}