# Вебхуки

# Основные положения

Вебхуки — это оповещения о происходящих в системе событиях. При наступлении 
определенного события Xsolla отправляет HTTP-запрос к вашему приложению, в 
котором передаются данные о событии. Чаще всего отправляется POST-запрос в 
JSON-формате.

<strong>Примеры событий:</strong>
- взаимодействие пользователя с каталогом товаров;
- оплата или отмена заказа.

Когда происходит настроенное событие, Xsolla через вебхук оповещает вашу 
систему об этом. В результате вы можете:
- пополнить баланс пользователя;
- выполнить возврат платежа;
- начислить новые предметы пользователю или списать их;
- начать предоставление подписки;
- заблокировать пользователя в случае подозрения в мошенничестве.

<b>Пример работы вебхука обработки платежей:</b>

![Вебхук обработки 
платежей](https://cdn.xsolla.net/developers/current/images/api_docs/webhooks-general.svg)

<div class="note">
<p><strong>Примечание</strong></p><p>В зависимости от используемого решения и типа интеграции набор вебхуков и последовательность взаимодействия могут отличаться от приведенного примера.</p>
</div>

<b>Видеоинструкция по интеграции вебхуков Xsolla:</b>

<div style="position: relative; padding-bottom: 56.25%; height: 0; overflow: hidden; border-radius: 15px; overflow: hidden;">
  <iframe src="https://player.vimeo.com/video/1034591338" style="position: absolute; top:0; left: 0; width: 100%; height: 100%; border:0; border-radius: 15px;" allowfullscreen></iframe>
</div>


<b>Настройка вебхуков при работе с продуктами и решениями Xsolla:</b>

<table>
<thead>
    <tr>
        <th>Продукт/ Решение</th>
        <th>Обязательно/ Опционально</th>
        <th>Для чего нужны вебхуки</th>
    </tr>
</thead>
<tbody>
    <tr>
        <td>Payments</td>
        <td>Обязательно</td>
        <td>
          <ul>
            <li>Валидация пользователей.</li>
            <li>Получение информации о деталях транзакции в случаях успешного платежа или возврата платежа.</li>
            <li>Начисление купленных товаров пользователю и списание товаров в случае отмены заказа.</li>
          </ul>
        </td>
    </tr>
    <tr>
        <td>In-Game Store</td>
        <td>Обязательно</td>
        <td>
          <ul>
            <li>Валидация пользователей.</li>
            <li>Получение информации о деталях транзакции в случаях успешного платежа или возврата платежа.</li>
            <li>Начисление купленных товаров пользователю и списание товаров в случае отмены заказа.</li>
          </ul>
        </td>
    </tr>
    <tr>
        <td>Game Sales</td>
        <td>Опционально</td>
        <td>Для продажи ключей не требуется валидация пользователя и начисление ему товаров. Вы можете подключить вебхуки, если вы хотите получать информацию о событиях, например об оплате или отмене заказа.<br />Если вы подключите вебхуки, важно обрабатывать все поступающие <a href="/ru/webhooks/overview/#section/List-of-required-webhooks">обязательные вебхуки</a>.
</td>
    </tr>
    <tr>
        <td>Subscriptions</td>
        <td>Опционально</td>
        <td>Получение информации о создании, изменении или отмене подписки. Альтернативный вариант — <a href="/doc/subscriptions/integration-guide/get-subscription-information/#guides_subscriptions_get_subscription_information_set_up_via_api">запрос информации с помощью API</a>.
</td>
    </tr>
    <tr>
        <td>Web Shop</td>
        <td>Обязательно</td>
        <td>
          <ul>
            <li>Валидация пользователей.</li>
            <li>Получение информации о деталях транзакции в случаях успешного платежа или возврата платежа.</li>
            <li>Начисление купленных товаров пользователю и списание товаров в случае отмены заказа.</li>
            <li>Аутентификация пользователей, если вы используете аутентификацию через ID пользователя. Альтернативный вариант — использование <a href="/solutions/web-shop/authentication-and-analytics/set-up-authentication/#web_shop_guide_shop_with_auth_set_up_auth_xsolla_login_how_to_get_it">аутентификации пользователей через Xsolla Login</a>.</li>
          </ul>
        </td>
    </tr>
    <tr>
        <td>Digital Distribution Hub</td>
        <td>Обязательно</td>
        <td>
          <ul>
            <li>Валидация пользователей.</li>
            <li>Связывание ID транзакции со стороны Xsolla с ID транзакции в вашей системе.</li>
            <li>Передача дополнительных параметров транзакции в заказе.</li>
            <li>Начисление купленных товаров пользователю и списание их в случае отмены заказа.</li>
          </ul>
          <p>Подробная информация по настройке вебхуков для Digital Distribution Hub приведена в <a href="/solutions/ddh/#integration_guide_ddh_webhook">инструкции</a>.</p>
        </td>
    </tr>
    <tr>
        <td>Login</td>
        <td>Опционально</td>
        <td>
          <p>Получение информации о наступлении события:</p>
          <ul>
            <li>регистрация/ авторизация пользователей;</li>
            <li>подтверждение пользователем email-адреса;</li>
            <li>привязка аккаунта социальной сети пользователя.</li>
          </ul>
          <p>Подробная информация о настройке вебхуков приведена в <a href="/api/login/operation/add-webhook-for-event/">документации Login</a>.</p>
        </td>
    </tr>
</tbody>
</table>

# Список обязательных вебхуков
Если вы используете продукты и решения, для которых работа с вебхуками 
обязательна, <a href="/webhooks/overview/#section/Set-up-webhooks-in-Publisher-
Account">подключите и протестируйте вебхуки в Личном кабинете</a> и <a 
href="/webhooks/overview/#section/Webhook-listener">настройте их обработку</a>. 
При наступлении определенных событий вебхуки отправляются последовательно. 
Поэтому, если вы не обработаете какой-то из вебхуков, последующие вебхуки не 
будут отправлены. Список необходимых вебхуков представлен ниже.

## In-Game Store и Payments
На стороне Xsolla настроено 2 варианта отправки вебхуков при покупке и возврате 
товаров на сайте — информация с данными платежа и транзакции и информация о 
купленных товарах может приходить отдельно или может быть объединена в один 
вебхук.

<b>Получение информации в объединенных вебхуках:</b>

Если вы зарегистрировались в <a href="https://publisher.xsolla.com/">Личном 
кабинете</a> после 22 января 2025 г., вы получаете всю информацию в вебхуках <a 
href="/webhooks/operation/successful-order-payment">Успешная оплата заказа</a> 
(`order_paid`) и<a href="/webhooks/operation/order-cancellation"> Отмена 
заказа</a> (`order_canceled`). В этом случае вам не требуется обрабатывать 
вебхуки <a href="/webhooks/operation/payment">Успешный платеж</a> (`payment`) и 
<a href="/webhooks/operation/refund">Возврат платежа</a> (`refund`).

<b>Получение информации в отдельных вебхуках:</b>

Если вы зарегистрировались в <a href="https://publisher.xsolla.com/">Личном 
кабинете</a> до 22 января 2025 г. включительно, вы получаете вебхуки:
- <a href="/webhooks/operation/payment">Успешный платеж</a> (`payment`) и <a 
  href="/webhooks/operation/refund">Возврат платежа</a> (`refund`) с информацией 
  о данных платежа и детали транзакции.
- <a href="/webhooks/operation/successful-order-payment-separate">Успешная оплата 
  заказа </a> (`order_paid`) и <a href="/webhooks/operation/order-cancellation-
  separate">Отмена заказа</a> (`order_canceled`) с информацией о купленных 
  товарах.

Вам необходимо обрабатывать все поступающие вебхуки. Для перехода к новому 
варианту с получением объединенных вебхуков обратитесь к персональному 
менеджеру проекта или напишите на <a 
href="mailto:csm@xsolla.com">csm@xsolla.com</a>.

Для полноценной работы внутриигрового магазина и управления платежами, 
необходимо реализовать обработку основных вебхуков:

<b>Если вы получаете объединенные вебхуки</b>:

<table>
<thead>
    <tr>
        <th>Название и тип вебхука</th>
        <th>Описание</th>
    </tr>
</thead>
<tbody>
    <tr>
        <td>Проверка пользователей &gt; <a href="/webhooks/operation/user-validation/">Проверка существования пользователя</a> (<code>user_validation</code>)</td>
        <td>Отправляется на разных этапах оплаты, чтобы удостовериться, что пользователь зарегистрирован в игре.</td>
    </tr>
    <tr>
        <td>Игровые сервисы &gt; Объединенные вебхуки &gt; <a href="/webhooks/operation/successful-order-payment">Успешная оплата заказа</a> (<code>order_paid</code>)</td>
        <td>Данные платежа, детали транзакции и информация о купленных товарах. Используйте данные вебхука для начисления товаров пользователю.</td>
    </tr>
    <tr>
        <td>Игровые сервисы &gt; Объединенные вебхуки &gt; <a href="/webhooks/operation/order-cancellation">Отмена заказа</a> (<code>order_canceled</code>)</td>
        <td>Данные отмененного платежа, детали транзакции и информацию о купленных товарах. Используйте данные вебхука для списания купленных товаров у пользователя.</td>
    </tr>
</tbody>
</table>


<b>Если вы получаете отдельные вебхуки</b>:

<table>
<thead>
    <tr>
        <th>Название и тип вебхука</th>
        <th>Описание</th>
    </tr>
</thead>
<tbody>
    <tr>
        <td>Проверка пользователей &gt; <a href="/webhooks/operation/user-validation/">Проверка существования пользователя</a> (<code>user_validation</code>)</td>
        <td>Отправляется на разных этапах оплаты, чтобы удостовериться, что пользователь зарегистрирован в игре.</td>
    </tr>
    <tr>
        <td>Платежи &gt; <a href="/webhooks/operation/payment">Успешный платеж</a> (<code>payment</code>)</td>
        <td>Данные платежа и детали транзакции.</td>
    </tr>
    <tr>
        <td>Игровые сервисы &gt; Отдельные вебхуки &gt; <a href="/webhooks/operation/successful-order-payment-separate">Успешная оплата заказа</a> (<code>order_paid</code>)</td>
        <td>Информация о купленных товарах. Используйте данные вебхука для начисления товаров пользователю.</td>
    </tr>
    <tr>
        <td>Платежи &gt; <a href="/webhooks/operation/refund">Возврат платежа</a> (<code>refund</code>)</td>
        <td>Данные платежа и детали транзакции.</td>
    </tr>
    <tr>
        <td>Игровые сервисы &gt; Отдельные вебхуки &gt; <a href="/webhooks/operation/order-cancellation-separate">Отмена заказа</a> (<code>order_canceled</code>)</td>
        <td>Информация о купленных товарах. Используйте данные вебхука для списания купленных товаров у пользователя.</td>
    </tr>
</tbody>
</table>

Если вы используете <a href="/doc/in-game-
store/features/personalization">персонализацию</a> каталога товаров, 
реализованную на стороне вашего приложения, настройте обработку вебхука <a 
href="/webhooks/operation/personalized-partner-catalog">Персонализация каталога 
на стороне партнера</a>.

<div class="note">
<p><strong>Примечание</strong></p>
<p>Чтобы принимать реальные платежи, достаточно <a href="/doc/in-game-store/integration-guide/sign-licensing-agreement/">подписать лицензионный договор</a> и реализовать обработку вебхуков:</p>
<p><ul><li><a href="/webhooks/operation/payment">Успешный платеж</a>, <a href="/webhooks/operation/successful-order-payment-separate">Успешная оплата заказа</a> и <a href="/webhooks/operation/user-validation/">Проверка существования пользователя</a>, если вы получаете отдельные вебхуки.</li><li><a href="/webhooks/operation/successful-order-payment">Успешная оплата заказа</a> и <a href="/webhooks/operation/user-validation/">Проверка существования пользователя</a>, если вы получаете объединенные вебхуки.</li></ul></p>
</div>

## Subscriptions
Для автоматического управления планами подписок необходимо реализовать 
обработку основных вебхуков:
- <a href="/webhooks/operation/user-validation/">Проверка существования 
  пользователя</a> (`user_validation`) — отправляется на разных этапах оплаты, 
  чтобы удостовериться, что пользователь зарегистрирован в игре.
- <a href="/webhooks/operation/payment">Успешный платеж</a> (`payment`) — 
  отправляется, когда заказ оплачен, и содержит информацию о данных платежа и 
  детали транзакции.
- <a href="/webhooks/operation/created-subscription/">Создание подписки</a> 
  (`create_subscription`) — отправляется, когда был получен ответ об успешной 
  обработке вебхука <a href="/webhooks/operation/payment">Успешный платеж</a> или 
  пользователь приобрел подписку с пробным периодом. Содержит детали купленной 
  подписки и данные пользователя. Используйте данные вебхука для добавления 
  подписки пользователю.
- <a href="/webhooks/operation/updated-subscription/">Изменение подписки</a> 
  (`update_subscription`) — отправляется при продлении или изменении подписки, 
  когда был получен ответ об успешной обработке вебхука <a 
  href="https://developers.xsolla.com/ru/webhooks/operation/payment">Успешный 
  платеж</a>. Содержит детали купленной подписки и данные пользователя. 
  Используйте данные вебхука для продления подписки пользователю или изменения 
  параметров подписки.
- <a href="/webhooks/operation/refund">Возврат платежа</a> (`refund`) — 
  отправляется, когда заказ был отменен, и содержит информацию о данных 
  отмененного платежа и детали транзакции.
- <a href="/webhooks/operation/canceled-subscription/">Отмена подписки</a> 
  (`cancel_subscription`) — отправляется, если был получен ответ об успешной 
  обработке вебхука <a href="/webhooks/operation/refund">Возврат платежа</a> или 
  подписка была отменена по другой причине. Содержит информацию о подписке и 
  данные пользователя. Используйте данные вебхука для списания купленных подписок 
  у пользователя. 

# Настройка вебхуков в Личном кабинете

## Общие настройки

Чтобы включить получение вебхуков:
1. В проекте в Личном кабинете перейдите в раздел <a 
   href="https://publisher.xsolla.com/0/projects/0/edit/webhooks/">Настройки 
   проекта &gt; Вебхуки</a>.
2. В поле <b>Сервер для вебхуков</b> укажите URL-адрес вашего сервера для 
   получения вебхуков в формате `https://example.com`. Вы также можете ввести 
   URL-адрес из инструмента для тестирования вебхуков.

<div class="notice">
<p><strong>Внимание</strong></p>
<p>Для передачи данных используется протокол HTTPS, протокол HTTP не поддерживается.</p>
</div>

<p></p>

3. Секретный ключ проекта для подписи вебхуков генерируется по умолчанию. Если вы 
   хотите изменить его, нажмите значок обновления.
4. Нажмите <b>Получать вебхуки</b>.

![Настроить 
вебхуки](https://cdn.xsolla.net/developers/current/images/api_docs/enable.png)

<div class="note">
<p><strong>Примечание</strong></p>
<p>Для тестирования вебхуков вы можете выбрать любой специализированный сайт, например <a href="https://webhook.site/#!/">webhook.site</a>, или платформу, например <a href="https://ngrok.com/">ngrok</a>.</p>
</div>

<p></p>

<div class="notice">
<p><strong>Внимание</strong></p>
<p>Вы не можете отправлять вебхуки на разные URL-адреса одновременно. Однако вы можете сначала указать в Личном кабинете URL-адрес для тестирования, а затем изменить его на боевой.</p>
</div>

Чтобы отключить получение вебхуков:
1. В проекте в Личном кабинете перейдите в раздел <a 
   href="https://publisher.xsolla.com/0/projects/0/edit/webhooks/">Настройки 
   проекта &gt; Вебхуки</a>.
2. Нажмите <b>Отключить вебхуки</b>.

## Расширенные настройки

Для вебхуков раздела <a href="/webhooks/overview/#section/Test-webhooks-in-
Publisher-Account/Store">Payments and Store</a> доступны расширенные настройки. 
Они автоматически отобразятся под блоком <a href="/webhooks/overview/#section
/Set-up-webhooks-in-Publisher-Account/General-settings">Общие настройки</a> 
после того, как вы нажмете кнопку <b>Получать вебхуки</b>.

<div class="note">
<p><strong>Примечание</strong></p>
<p>Если расширенные настройки не отображаются, убедитесь, что получение вебхуков подключено в общих настройках и вы находитесь на вкладке <b>Тестирование &gt; Payments and Store</b>.</p>
</div>

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

<table>
<thead>
    <tr>
        <th>Переключатель</th>
        <th>Описание</th>
    </tr>
</thead>
<tbody>
    <tr>
        <td>Показывать информацию о сохраненном платежном аккаунте</td>
        <td>Информация о сохраненном способе оплаты передается в кастомном объекте <code>payment_account</code>.</td>
    </tr>
    <tr>
        <td>Показывать информацию о транзакциях сохраненными способами оплаты</td>
        <td><p>В вебхуке будет передаваться информация в кастомных параметрах:</p><ul><li><code>saved_payment_method</code>:<ul><li><code>0</code> — сохраненный способ оплаты не используется;</li><li><code>1</code> — способ оплаты был сохранен при совершении текущей транзакции;</li><li><code>2</code> — используется ранее сохраненный способ оплаты.</li></ul></li><li><code>payment_type</code>:<ul><li><code>1</code> — единоразовый платеж;</li><li><code>2</code> — рекуррентный платеж.</li></ul></li></ul></td>
    </tr>
    <tr>
        <td>Добавить объект order в вебхук</td>
        <td>В вебхуке <a href="/webhooks/operation/payment/">Успешный платеж</a> будет передаваться информация о заказе в объекте <code>order</code>.</td>
    </tr>
    <tr>
        <td>Показывать только необходимую информацию о пользователе без чувствительных данных</td>
        <td><p>В вебхуке о пользователе будет передаваться только следующая информация:</p><ul><li>ID;</li><li>страна.</li></ul></td>
    </tr>
    <tr>
        <td>Передавать кастомные параметры</td>
        <td>В вебхуке будет передаваться информация о <a href="/api/pay-station/operation/create-token/">кастомных параметрах из токена</a>.</td>
    </tr>
    <tr>
        <td>Показывать БИН карты и последние 4 цифры ее номера</td>
        <td><p>В вебхуке будет передаваться следующая информация о номере карты:</p><ul><li>первые 6 цифр в параметре <code>card_bin</code>;</li><li>последние 4 цифры в параметре <code>card_suffix</code>.</li></ul></td>
    </tr>
    <tr>
        <td>Показывать бренд карты</td>
        <td>Бренд карты, с которой была совершена оплата. Например, Mastercard или Visa.</td>
    </tr>
</tbody>
</table>

![Расширенные 
настройки](https://cdn.xsolla.net/developers/current/images/api_docs/advanced-settings-upd.png)

# Тестирование вебхуков в Личном кабинете

Тестирование вебхуков помогает убедиться в корректной настройке проекта как на 
вашей стороне, так и на стороне Xsolla.

Если вебхуки <a href="/webhooks/overview/#section/Set-up-webhooks-in-Publisher-
Account">настроены</a> успешно, ниже блока настройки вебхуков отобразится блок 
тестирования вебхуков.

![Раздел тестирования 
вебхуков](https://cdn.xsolla.net/developers/current/images/api_docs/testing.png)

Содержание блока зависит от варианта получения вебхуков.

<b>Если вы получаете объединенные вебхуки</b>:

<table>
<thead>
    <tr>
        <th>Название вкладки для тестирования вебхуков</th>
        <th>Название и тип вебхука</th>
    </tr>
</thead>
<tbody>
    <tr>
        <td><b>Payments and Store</b></td>
        <td>Проверка пользователей &gt; <a href="/webhooks/operation/user-validation/">Проверка существования пользователя</a> (<code>user_validation</code>)</td>
    </tr>
    <tr>
        <td></td>
        <td>Игровые сервисы &gt; Объединенные вебхуки &gt; <a href="/webhooks/operation/successful-order-payment">Успешная оплата заказа</a> (<code>order_paid</code>)</td>
    </tr>
    <tr>
        <td></td>
        <td>Игровые сервисы &gt; Объединенные вебхуки &gt; <a href="/webhooks/operation/order-cancellation">Отмена заказа</a> (<code>order_canceled</code>)</td>
    </tr>
    <tr>
        <td><b>Subscriptions</b></td>
        <td>Проверка пользователей &gt; <a href="/webhooks/operation/user-validation/">Проверка существования пользователя</a> (<code>user_validation</code>)</td>
    </tr>
    <tr>
        <td></td>
        <td>Платежи &gt; <a href="/webhooks/operation/payment">Успешный платеж</a> (<code>payment</code>)</td>
    </tr>
</tbody>
</table>


<b>Если вы получаете отдельные вебхуки</b>:

<table>
<thead>
    <tr>
        <th>Название вкладки для тестирования вебхуков</th>
        <th>Название и тип вебхука</th>
    </tr>
</thead>
<tbody>
    <tr>
        <td><b>Store</b></td>
        <td>Игровые сервисы &gt; Отдельные вебхуки &gt; <a href="/webhooks/operation/successful-order-payment-separate">Успешная оплата заказа</a> (<code>order_paid</code>)</td>
    </tr>
    <tr>
        <td></td>
        <td>Игровые сервисы &gt; Отдельные вебхуки &gt; <a href="/webhooks/operation/order-cancellation-separate">Отмена заказа</a> (<code>order_canceled</code>)</td>
    </tr>
    <tr>
        <td><b>Payments</b></td>
        <td>Проверка пользователей &gt; <a href="/webhooks/operation/user-validation/">Проверка существования пользователя</a> (<code>user_validation</code>)</td>
    </tr>
    <tr>
        <td></td>
        <td>Платежи &gt; <a href="/webhooks/operation/payment">Успешный платеж</a> (<code>payment</code>)</td>
    </tr>
    <tr>
        <td><b>Subscriptions</b></td>
        <td>Проверка пользователей &gt; <a href="/webhooks/operation/user-validation/">Проверка существования пользователя</a> (<code>user_validation</code>)</td>
    </tr>
    <tr>
        <td></td>
        <td>Платежи &gt; <a href="/webhooks/operation/payment">Успешный платеж</a> (<code>payment</code>)</td>
    </tr>
</tbody>
</table>

<div class="note">
<p><strong>Примечание</strong></p>
<p>Если в блоке тестирования отобразилось предупреждение, что тест не пройден, проверьте настройки ответа на вебхук в вашем <a href="/webhooks/overview/#section/Webhook-listener">обработчике вебхуков</a>. Причины ошибок в тестировании указаны в результатах тестирования.</p>
<p><b>Пример:</b></p>
<p>Для тестирования вы используете специализированный сайт <a href="https://webhook.site/#!/">webhook.site</a>.</p>
<p>В разделе <b>Тестирование ответа на неверную подпись</b> отображается ошибка.</p>
<p>Это происходит, потому что Xsolla отправляет вебхук с неверной подписью и ожидает, что ваш обработчик ответит <code>4xx</code> HTTP-кодом с указанием кода ошибки <code>INVALID_SIGNATURE</code>.</p>
<p><a href="https://webhook.site/#!/">webhook.site</a> отправляет <code>200</code> HTTP-код в ответ на все вебхуки, в том числе на вебхук с неверной подписью. Ожидаемый <code>4xx</code> HTTP-код не может быть получен, поэтому в результате тестирования отображается ошибка.</p>
</div>

![Ошибка тестирования](https://cdn.xsolla.net/developers/current/images/api_docs/test-error.png)

Далее описан процесс тестирования для сценария с объединенными вебхуками.

## Payments and Store

На вкладке <b>Payments and Store</b> вы можете протестировать работу следующих 
вебхуков:
- <a href="/webhooks/operation/user-validation/">Проверка пользователей</a> 
  (`user_validation`)
- <a href="/webhooks/operation/successful-order-payment">Успешная оплата 
  заказа</a> (`order_paid`)
- <a href="/webhooks/operation/order-cancellation">Отмена заказа</a> 
  (`order_canceled`)

Чтобы протестировать вебхуки:
1. В блоке тестирования вебхуков перейдите на вкладку <b>Payments and Store</b>.
2. В раскрывающемся списке выберите тип товара. Если выбранный тип товара еще не 
   настроен в Личном кабинете, нажмите:
   * <b>Подключить</b> – если модуль с товарами данного типа еще не подключен;
   * <b>Настроить</b> – если вы ранее уже подключали модуль, но не завершили 
     настройку.<br/>При нажатии кнопки вы будете перенаправлены в раздел Личного 
     кабинета, соответствующий типу выбранного товара. После создания товара 
     вернитесь в раздел тестирования вебхуков и перейти к следующему шагу.
3. Заполните необходимые поля: <ol type="a"> <li>Выберите артикул товара из 
   раскрывающегося списка и укажите его количество. Вы можете выбрать несколько 
   товаров. Для этого нажмите <b>+</b> и добавьте товары в новой строке.</li> 
   <li><b>ID пользователя</b> — при тестировании вы можете указать любую 
   комбинацию букв и цифр.</li> <li><b>Public user ID</b> — ID, который известен 
   пользователю, например, email или никнейм. Это поле отображается, если public 
   user ID включен в вашем проекте в разделе <b>Pay Station &gt; 
   Настройки</b>.</li> <li>Укажите произвольное значение в поле <b>ID заказа 
   Xsolla</b>.</li> <li><b>ID заявки в Xsolla</b> — ID транзакции на стороне 
   Xsolla. При тестировании вы можете указать любое числовое значение.</li> 
   <li><b>Invoice ID</b> — ID транзакции на стороне вашей игры. При тестировании 
   вы можете указать любую комбинацию букв и цифр. Для успешной оплаты это не 
   обязательный параметр, но вы можете передать его, чтобы связать ID транзакции 
   на вашей стороне с ID транзакции на стороне Xsolla.</li> <li><b>Количество</b> 
   — сумма платежа. При тестировании вы можете указать любое числовое 
   значение.</li> <li><b>Валюта</b> — выберите валюту из раскрывающегося 
   списка.</li> </ol>

4. Нажмите <b>Проверить вебхук</b>.


На URL-адрес сервера вебхуков придут вебхуки <a href="/webhooks/operation/user-
validation/">Проверка существования пользователя</a>, <a 
href="/webhooks/operation/successful-order-payment">Успешная оплата заказа</a> 
и <a href="/webhooks/operation/order-cancellation">Отмена заказа</a> с 
указанными данными. Ниже кнопки <b>Проверить вебхук</b> отобразятся результаты 
тестирования каждого типа вебхука.

Если в вашем проекте включен public user ID, в результатах тестирования также 
отобразится проверка поиска пользователя.

Для каждого вебхука вам необходимо настроить обработку обоих сценариев: 
успешного и с ошибкой.

![Раздел тестирования 
платежей](https://cdn.xsolla.net/developers/current/images/api_docs/payments-tab.png)

## Subscriptions
На вкладке <b>Subscriptions</b> вы можете протестировать работу следующих 
вебхуков при управлении подписками:
- <a href="/webhooks/operation/user-validation/">Проверка пользователей</a> 
  (`user_validation`)
- <a href="/webhooks/operation/payment">Успешный платеж</a> (`payment`)

<div class="note">
<p><strong>Примечание</strong></p>
<p>В Личном кабинете вы можете протестировать только базовые вебхуки Проверка существования пользователей и Успешный платеж. Для тестирования остальных вебхуков перейдите к разделам:</p>
<p><ul><li><a href="/doc/subscriptions/integration-guide/get-subscription-information/#guides_subscriptions_get_subscription_set_up_webhooks_test_payment">тестирование покупки подписки;</a></li><li><a href="/doc/subscriptions/integration-guide/get-subscription-information/#guides_subscriptions_get_subscription_set_up_webhooks_test_renewal">тестирование продления подписки;</a></li><li><a href="/doc/subscriptions/integration-guide/get-subscription-information/#guides_subscriptions_get_subscription_set_up_webhooks_test_cancelation">тестирование отмены подписки.</a></li></ul></p>
</div>

<p></p>

<div class="note">
<p><strong>Примечание</strong></p>
<p>Для тестирования вебхуков у вас должен быть <a href="/doc/subscriptions/integration-guide/set-up-plan/">создан хотя бы один план подписки</a> в разделе <b>Личный кабинет&gt; Subscriptions &gt; Планы подписки</b>.</p>
</div>

Чтобы выполнить тестирование: <ol> <li>В блоке тестирования вебхуков перейдите 
на вкладку <b>Subscriptions</b>.</li> <li>Заполните необходимые поля: <ol 
type="a"> <li><b>ID пользователя</b> — при тестировании вы можете указать любую 
комбинацию букв и цифр.</li> <li><b>ID заявки в Xsolla</b> — ID транзакции на 
стороне Xsolla. При тестировании вы можете указать любое числовое 
значение.</li> <li><b>Public user ID</b> — ID, который известен пользователю, 
например, email или никнейм. Это поле отображается, если public user ID включен 
в вашем проекте в разделе Pay Station &gt; Settings &gt; Additional settings 
section.</li> <li><b>Валюта</b> — выберите валюту из раскрывающегося 
списка.</li> <li><b>ID плана</b> — план подписки. Выберите план из 
раскрывающегося списка.</li> <li><b>Продукт подписки</b>— выберите продукт из 
раскрывающегося списка (опционально).</li> <li><b>Сумма </b> — сумма платежа. 
При тестировании вы можете указать любое числовое значение.</li> <li><b>Invoice 
ID</b>— ID транзакции на стороне вашей игры. При тестировании вы можете указать 
любую комбинацию букв и цифр.Для успешной оплаты это не обязательный параметр, 
но вы можете передать его, чтобы связать ID транзакции на вашей стороне с ID 
транзакции на стороне Xsolla.</li> <li><b>Пробный период</b>. Для тестирования 
<a href="/doc/subscriptions/integration-guide/get-subscription-information/#guides_subscriptions_get_subscription_set_up_webhooks_sandbox">покупки подписки без пробного периода</a> или тестирования <a 
href="/doc/subscriptions/integration-guide/get-subscription-information/#guides_subscriptions_get_subscription_set_up_webhooks_test_renewal">продления подписки</a>, укажите значение <code>0</code>.</li> </ol> </li> 
<li>Нажмите <b>Тестировать вебхуки</b>.</li> </ol>

На указанный URL-адрес придут вебхуки с введенными данными. Ниже кнопки 
<b>Тестировать вебхуки</b> отобразятся результаты тестирования каждого вебхука 
как для успешного сценария, так и для случая возникновения ошибки.

<a id="webhook-listener"></a>

# Обработчик вебхуков

Обработчик вебхуков – это программный код, который позволяет принимать 
поступающие вебхуки на указанный URL-адрес, <a href="/webhooks/overview/#section
/Webhook-listener/Generation-of-signature">генерировать подпись</a> и <a 
href="/webhooks/overview/#section/Webhook-listener/Sending-responses-to-
webhook">отправлять ответ</a> на вебхук на сервер Xsolla.

<div class="note">
<p><strong>Примечание</strong></p>
<p>Вы можете использовать <a href="https://developers.xsolla.com/ru/sdk/php/">библиотеку Pay Station PHP SDK</a>, которая содержит готовые классы для обработки вебхуков.</p>
</div>

<!-- IMPORTANT! Changing the list of IP addresses should be coordinated with the administrators. Request for Director of Infrastructure and IT approval in the ticket for changing the IP address list. -->

На стороне вашего приложения реализуйте прием вебхуков со следующих IP-адресов:
- `185.30.20.0/24`;
- `185.30.21.0/24`;
- `185.30.22.0/24`;
- `185.30.23.0/24`;
- `34.102.38.178`;
- `34.94.43.207`
- `35.236.73.234`;
- `34.94.69.44`;
- `34.102.22.197`.

Если у вас подключен продукт <a href="/doc/login/">Login</a>, дополнительно 
добавьте обработку вебхуков со следующих IP-адресов:

- `34.94.0.85`;
- `34.94.14.95`;
- `34.94.25.33`;
- `34.94.115.185`;
- `34.94.154.26`;
- `34.94.173.132`;
- `34.102.48.30`;
- `35.235.99.248`;
- `35.236.32.131`;
- `35.236.35.100`;
- `35.236.117.164`.

Ограничения:
- В базе данных вашего приложения не должно быть нескольких успешных транзакций с 
  одинаковым ID.
- Если обработчик вебхуков получил вебхук с ID, который уже существует в базе, 
  необходимо вернуть результат предыдущей обработки данной транзакции. Не 
  рекомендуется зачислять пользователю повторную покупку и создавать дублирующие 
  записи в базе данных.

## Генерация подписи

Чтобы обеспечить безопасную передачу данных, вам необходимо убедиться, что 
вебхук действительно был отправлен с сервера Xsolla и не был изменен в процессе 
передачи. Для этого сгенерируйте собственную подпись на основе тела запроса и 
сравните ее с подписью, полученной в заголовке `authorization` этого же 
запроса. Если подписи совпадают, вебхук является подлинным и его можно 
обрабатывать.

Шаги верификации:

1. Получите подпись из заголовка `authorization` входящего запроса вебхука. Формат 
   заголовка: `Signature <signature_value>`.
2. Получите тело запроса вебхука в формате JSON. <div 
   class="notice"><p><strong>Внимание</strong></p><p>Используйте JSON в полученном 
   виде. Не парсите и не перекодируйте данные, так как это изменит форматирование 
   и приведет к ошибке проверки подписи.</p></div><p></p>

3. Сгенерируйте собственную подпись для сравнения:<ol type="a"> <li>Конкатенируйте 
   JSON из тела запроса и секретный ключ проекта, т. е. объедините две строки, 
   добавив секретный ключ проекта в конец строки.</li> <li>Примените к полученной 
   строке криптографическую хэш-функцию SHA-1. В результате вы получите 
   шестнадцатеричную строку в нижнем регистре.</li> </ol>
4. Сравните полученную строку с подписью из заголовка `authorization`. Если 
   подписи совпадают, вебхук является подлинным.

Ниже вы можете найти примеры реализации генерации подписи для следующих языков: 
C#, C++, Go, PHP и Node.js.

### Пример вебхука (HTTP):

```http
POST /your_uri HTTP/1.1
host: your.host
accept: application/json
content-type: application/json
content-length: 165
authorization: Signature 52eac2713985e212351610d008e7e14fae46f902
{
  "notification_type":"user_validation",
  "user":{
      "ip":"127.0.0.1",
      "phone":"18777976552",
      "email":"email@example.com",
      "id":1234567,
      "name":"Xsolla User",
      "country":"US"
  }
}
```

### Пример вебхука (curl):

```bash
curl -v 'https://your.hostname/your/uri' \
-X POST \
-H 'authorization: Signature 52eac2713985e212351610d008e7e14fae46f902' \
-d '{
  "notification_type":
    "user_validation",
    "user":
      {
        "ip": "127.0.0.1",
        "phone": "18777976552",
        "email": "email@example.com",
        "id": 1234567,
        "name": "Xsolla User",
        "country": "US"
      }
    }'
```

### Пример реализации генерации подписи для C# (универсальный пример):

<div class="note">
<p><strong>Примечание</strong></p>
<p>Этот пример кода совместим с .NET Framework 4.0 и выше, а также с .NET Core и другими современными версиями .NET. Для проверки подписи реализовано сравнение с постоянным временем выполнения с помощью метода <code>ConstantTimeEquals</code>, что помогает предотвратить атаки по времени.</p>
</div>

```csharp
using System;
using System.Security.Cryptography;
using System.Text;
public static class XsollaWebhookSignature
{
    public static string ComputeSha1(string jsonBody, string secretKey)
    {
        // Concatenation of the JSON from the request body and the project's secret key
        string dataToSign = jsonBody + secretKey;
        using (SHA1 sha1 = SHA1.Create())
        {
            byte[] hashBytes = sha1.ComputeHash(Encoding.UTF8.GetBytes(dataToSign));
            // Convert hash bytes to lowercase hexadecimal string
            var hexString = new StringBuilder(hashBytes.Length * 2);
            foreach (byte b in hashBytes)
            {
                hexString.Append(b.ToString("x2"));
            }
            return hexString.ToString();
        }
    }
    public static bool VerifySignature(string jsonBody, string secretKey, string receivedSignature)
    {
        string computedSignature = ComputeSha1(jsonBody, secretKey);
        string receivedSignatureLower = receivedSignature.ToLower();
        // Use constant-time comparison to prevent timing attacks
        return ConstantTimeEquals(computedSignature, receivedSignatureLower);
    }
    private static bool ConstantTimeEquals(string a, string b)
    {
        if (a.Length != b.Length)
        {
            return false;
        }
        int result = 0;
        for (int i = 0; i < a.Length; i++)
        {
            result |= a[i] ^ b[i];
        }
        return result == 0;
    }
}
```

### Пример реализации генерации подписи для C# (.NET 5.0 и выше):

<div class="note">
<p><strong>Примечание</strong></p>
<p>Чтобы использовать метод <code>Convert.ToHexString</code>, вам необходима версия .NET 5.0 или выше.<p></p>Если у вас версия .NET 7.0 или выше, вы также можете использовать метод <code>CryptographicOperations.FixedTimeEquals</code> вместо <code>ConstantTimeEquals</code>.</p>
</div>

```csharp
// For .NET 5.0 and later, you can use the more concise Convert.ToHexString method:
using System;
using System.Security.Cryptography;
using System.Text;
public static class XsollaWebhookSignature
{
    public static string ComputeSha1(string jsonBody, string secretKey)
    {
        string dataToSign = jsonBody + secretKey;
        using var sha1 = SHA1.Create();
        byte[] hashBytes = sha1.ComputeHash(Encoding.UTF8.GetBytes(dataToSign));
        return Convert.ToHexString(hashBytes).ToLower();
    }
    public static bool VerifySignature(string jsonBody, string secretKey, string receivedSignature)
    {
        string computedSignature = ComputeSha1(jsonBody, secretKey);
        string receivedSignatureLower = receivedSignature.ToLower();
        // Use constant-time comparison to prevent timing attacks
        return ConstantTimeEquals(computedSignature, receivedSignatureLower);
    }
    private static bool ConstantTimeEquals(string a, string b)
    {
        if (a.Length != b.Length)
        {
            return false;
        }
        int result = 0;
        for (int i = 0; i < a.Length; i++)
        {
            result |= a[i] ^ b[i];
        }
        return result == 0;
    }
}
```

### Пример реализации генерации подписи для C# (.NET 7.0 и выше):

<div class="note">
<p><strong>Примечание</strong></p>
<p>Если у вас версия .NET 7.0 или выше, вы можете использовать метод <code>CryptographicOperations.FixedTimeEquals</code>.</p>
</div>

```csharp
// For .NET 7.0+, you can use the built-in CryptographicOperations.FixedTimeEquals:
using System.Security.Cryptography;
public static bool VerifySignature(string jsonBody, string secretKey, string receivedSignature)
{
    string computedSignature = ComputeSha1(jsonBody, secretKey);
    byte[] computedBytes = Encoding.UTF8.GetBytes(computedSignature);
    byte[] receivedBytes = Encoding.UTF8.GetBytes(receivedSignature.ToLower());
    return CryptographicOperations.FixedTimeEquals(computedBytes, receivedBytes);
}
```

### Пример реализации генерации подписи для C++:

```c++
#include <string>
#include <sstream>
#include <iomanip>
#include <openssl/sha.h>
class XsollaWebhookSignature {
public:
    static std::string computeSha1(const std::string& jsonBody, const std::string& secretKey) {
        // Concatenation of the JSON from the request body and the project's secret key
        std::string dataToSign = jsonBody + secretKey;
        unsigned char digest[SHA_DIGEST_LENGTH];
        // Create SHA1 hash
        SHA1(reinterpret_cast<const unsigned char*>(dataToSign.c_str()),
             dataToSign.length(), digest);
        // Convert to lowercase hexadecimal string
        std::ostringstream hexStream;
        hexStream << std::hex << std::setfill('0');
        for (int i = 0; i < SHA_DIGEST_LENGTH; ++i) {
            hexStream << std::setw(2) << static_cast<unsigned int>(digest[i]);
        }
        return hexStream.str();
    }
    static bool verifySignature(const std::string& jsonBody, const std::string& secretKey, const std::string& receivedSignature) {
        std::string computedSignature = computeSha1(jsonBody, secretKey);
        // Timing-safe comparison
        if (computedSignature.length() != receivedSignature.length()) {
            return false;
        }
        volatile unsigned char result = 0;
        for (size_t i = 0; i < computedSignature.length(); ++i) {
            result |= (computedSignature[i] ^ receivedSignature[i]);
        }
        return result == 0;
    }
};
```

### Пример реализации генерации подписи для Go:

```go
package main
import (
	"crypto/sha1"
    "crypto/subtle"
	"encoding/hex"
	"strings"
)
type XsollaWebhookSignature struct{}
func (x *XsollaWebhookSignature) ComputeSha1(jsonBody, secretKey string) string {
	// Concatenation of the JSON from the request body and the project's secret key
	dataToSign := jsonBody + secretKey
	// Create SHA1 hash
	h := sha1.New()
	h.Write([]byte(dataToSign))
	signature := h.Sum(nil)
	// Convert to lowercase hexadecimal string
	return strings.ToLower(hex.EncodeToString(signature))
}
func (x *XsollaWebhookSignature) VerifySignature(jsonBody, secretKey, receivedSignature string) bool {
	computedSignature := x.ComputeSha1(jsonBody, secretKey)
	receivedSignatureLower := strings.ToLower(receivedSignature)
	// Use constant time comparison to prevent timing attacks
	return subtle.ConstantTimeCompare([]byte(computedSignature), []byte(receivedSignatureLower)) == 1
}
```

### Пример реализации генерации подписи для PHP:

```php
<?php
class XsollaWebhookSignature
{
    /**
     * Compute SHA1 signature from webhook JSON body and secret key
     *
     * @param string $jsonBody The raw JSON body from webhook
     * @param string $secretKey The project's secret key
     * @return string The lowercase SHA1 signature
     */
    public static function computeSha1(string $jsonBody, string $secretKey): string
    {
        // Concatenation of the JSON from the request body and the project's secret key
        $dataToSign = $jsonBody . $secretKey;
        // Generate SHA1 signature
        $signature = sha1($dataToSign);
        return strtolower($signature);
    }
    /**
     * Verify webhook signature using timing-safe comparison
     *
     * @param string $jsonBody The raw JSON body from webhook
     * @param string $secretKey The project's secret key  
     * @param string $receivedSignature The signature from authorization header
     * @return bool True if signature is valid, false otherwise
     */
    public static function verifySignature(string $jsonBody, string $secretKey, string $receivedSignature): bool
    {
        $computedSignature = self::computeSha1($jsonBody, $secretKey);
        // Use hash_equals for timing-safe comparison
        return hash_equals($computedSignature, strtolower($receivedSignature));
    }
}
?>
```

### Пример реализации генерации подписи для Node.js:

```js
const crypto = require('crypto');
class XsollaWebhookSignature {
    // IMPORTANT: jsonBody must be the raw JSON string exactly as received from Xsolla
    static computeSha1(jsonBody, secretKey) {
        // Concatenation of the JSON from the request body and the project's secret key
        const dataToSign = jsonBody + secretKey;
        // Create SHA1 hash
        const hash = crypto.createHash('sha1');
        hash.update(dataToSign, 'utf8');
        // Convert to lowercase hexadecimal string
        return hash.digest('hex').toLowerCase();
    }
    static verifySignature(jsonBody, secretKey, receivedSignature) {
        const computedSignature = this.computeSha1(jsonBody, secretKey);
        const cleanReceivedSignature = receivedSignature.toLowerCase();
        // Check if signatures have the same length before using timingSafeEqual
        if (computedSignature.length !== cleanReceivedSignature.length) {
            return false;
        }
        try {
            return crypto.timingSafeEqual(
                Buffer.from(computedSignature, 'hex'),
                Buffer.from(cleanReceivedSignature, 'hex')
            );
        } catch (error) {
            // Return false if there's any error (e.g., invalid hex characters)
            return false;
        }
    }
}
```

## Отправка ответов на вебхук

Чтобы подтвердить получение вебхука, ваш сервер должен вернуть:
* `200`, `201`, или `204` HTTP-код в случае успешного ответа.
* `400` HTTP-код с <a href="/webhooks/overview/#section/Oshibki">описанием 
  проблемы</a>, если указанный пользователь не был найден или если передана 
  недействительная подпись. Ваш обработчик вебхуков также может возвращать `5xx` 
  HTTP-код при временных проблемах на вашем сервере.

Если на вебхуки <a href="/webhooks/operation/successful-order-payment">Успешная 
оплата заказа</a> и <a href="/webhooks/operation/order-cancellation">Отмена 
заказа</a> сервер Xsolla не получил ответ или получил ответ с кодом `5xx`, 
осуществляется повторная отправка вебхуков по следующему расписанию:
* 2 попытки с интервалом 5 минут;
* 7 попыток с интервалом 15 минут;
* 10 попыток с интервалом 60 минут.

Максимально осуществляется 20 попыток отправки вебхуков в течение 12 часов с 
момента первой попытки.

Логика повторной отправки вебхуков <a 
href="/webhooks/operation/payment">Успешный платеж</a> и <a 
href="/webhooks/operation/refund">Возврат платежа</a> описана на странице 
соответствующего вебхука.

<div class="notice">
<p><strong>Внимание</strong></p>
<p>При одновременном выполнении следующих условий платеж все равно будет возвращен пользователю:<ul><li>Инициатор возврата — Xsolla.</li><li>На вебхук получен ответ с кодом <code>4xx</code>, или после всех повторных попыток ответ не был получен, или был получен код <code>5xx</code>.</li></ul></p>
</div>

Если на вебхук <a href="/webhooks/operation/user-validation/">Проверка 
существования пользователя</a> сервер Xsolla не получил ответ или получил ответ 
с `400` или `5xx` HTTP-кодом, повторная отправка вебхука <a 
href="/webhooks/operation/user-validation/">Проверка существования 
пользователя</a> не осуществляется. Пользователь увидит ошибку, вебхуки <a 
href="/webhooks/operation/payment">Успешный платеж</a> и <a 
href="/webhooks/operation/successful-order-payment">Успешная оплата заказа</a> 
отправлены не будут.

# Ошибки

Коды ошибок для HTTP-кода 400:

<table>
<thead>
    <tr>
        <th>Код</th>
        <th>Описание</th>
    </tr>
</thead>
<tbody>
    <tr>
        <td>INVALID_USER</td>
        <td>Неверный пользователь</td>
    </tr>
    <tr>
        <td>INVALID_PARAMETER</td>
        <td>Неверный параметр</td>
    </tr>
    <tr>
        <td>INVALID_SIGNATURE</td>
        <td>Подпись неверна</td>
    </tr>
    <tr>
        <td>INCORRECT_AMOUNT</td>
        <td>Некорректная сумма</td>
    </tr>
    <tr>
        <td>INCORRECT_INVOICE</td>
        <td>Неверный заказ</td>
    </tr>
</tbody>
</table>

```
HTTP/1.1 400 Bad Request
{
    "error":{
        "code":"INVALID_USER",
        "message":"Invalid user"
    }
}
```

# Список вебхуков

<div class="note">
<p><strong>Примечание</strong></p>
<p>Тип оповещения передается в параметре <code>notification_type</code>.</p>
</div>

<table>
<thead>
    <tr>
        <th>Вебхук</th>
        <th>Тип оповещения</th>
        <th>Описание</th>
    </tr>
</thead>
<tbody>
    <tr>
        <td><a href="/webhooks/operation/user-validation/">Проверка существования пользователя</a></td>
        <td><code>user_validation</code></td>
        <td>Проверка существования пользователя в игре.</td>
    </tr>
    <tr>
        <td><a href="/webhooks/operation/user-search/">Поиск пользователя</a></td>
        <td><code>user_search</code></td>
        <td>Получение информации о пользователе по публичному ID пользователя.</td>
    </tr>
    <tr>
        <td><a href="/webhooks/operation/payment/">Успешный платеж</a></td>
        <td><code>payment</code></td>
        <td>Оповещение об успешном платеже.</td>
    </tr>
    <tr>
        <td><a href="/webhooks/operation/refund/">Возврат платежа</a></td>
        <td><code>refund</code></td>
        <td>Оповещение об отмене платежа.</td>
    </tr>
    <tr>
        <td><a href="/webhooks/operation/partial-refund/">Частичный возврат платежа</a></td>
        <td><code>partial_refund</code></td>
        <td>Оповещение о частичном возврате платежа.</td>
    </tr>
    <tr>
        <td><a href="/webhooks/operation/payment-declined/">Отмена платежа</a></td>
        <td><code>ps_declined</code></td>
        <td>Оповещение об отмене транзакции платежной системой.</td>
    </tr>
    <tr>
        <td><a href="https://developers.xsolla.com/ru/webhooks/operation/afs-rejected-transaction/">Транзакция отклонена при проверке AFS</a></td>
        <td><code>afs_reject</code></td>
        <td>Оповещение об отмене транзакции системой расширенного антифрода.</td>
    </tr>
    <tr>
      <td><a href="https://developers.xsolla.com/ru/webhooks/operation/afs-rejected-blocklist/">Обновление черного списка AFS</a></td>
      <td><code>afs_black_list</code></td>
      <td>Оповещение об изменении черного списка AFS.</td>
    </tr>
    <tr>
      <td><a href="https://developers.xsolla.com/ru/webhooks/operation/created-subscription/">Создание подписки</a></td>
      <td><code>create_subscription</code></td>
      <td>Оповещение о создании подписки.</td>
    </tr>
    <tr>
      <td><a href="https://developers.xsolla.com/ru/webhooks/operation/updated-subscription/">Изменение подписки</a></td>
      <td><code>update_subscription</code></td>
      <td>Оповещение о продлении подписки или о смене каких-либо параметров внутри подписки.</td>
    </tr>
    <tr>
      <td><a href="https://developers.xsolla.com/ru/webhooks/operation/canceled-subscription/">Отмена подписки</a></td>
      <td><code>cancel_subscription</code></td>
      <td>Оповещение об отмене подписки.</td>
    </tr>
    <tr>
      <td><a href="https://developers.xsolla.com/ru/webhooks/operation/nonrenewing-subscription/">Непродлеваемая подписка</a></td>
      <td><code>non_renewal_subscription</code></td>
      <td>Оповещение о смене статуса на непродлеваемый.</td>
    </tr>
    <tr>
      <td><a href="https://developers.xsolla.com/ru/webhooks/operation/add-payment-account/">Добавление платежного аккаунта</a></td>
      <td><code>payment_account_add</code></td>
      <td>Оповещение о добавлении или сохранении платежного аккаунта.</td>
    </tr>
    <tr>
      <td><a href="https://developers.xsolla.com/ru/webhooks/operation/remove-payment-account/">Удаление платежного аккаунта</a></td>
      <td><code>payment_account_remove</code></td>
      <td>Оповещение об удалении платежного аккаунта.</td>
    </tr>
    <tr>
      <td><a href="https://developers.xsolla.com/ru/webhooks/operation/user-validation-in-webshop">Проверка пользователя в Web Shop</a></td>
      <td><code>-</code></td>
      <td>Отправлено из Web Shop для проверки существования пользователя в игре.</td>
    </tr>
    <tr>
      <td><a href="https://developers.xsolla.com/ru/webhooks/operation/personalized-partner-catalog">Персонализация каталога на стороне партнера</a></td>
      <td><code>partner_side_catalog</code></td>
      <td>Отправляется, когда пользователь взаимодействует с магазином.</td>
    </tr>
    <tr>
      <td><a href="https://developers.xsolla.com/ru/webhooks/operation/successful-order-payment">Успешная оплата заказа</a></td>
      <td><code>order_paid</code></td>
      <td>Отправляется, когда заказ оплачен.</td>
    </tr>
    <tr>
      <td><a href="https://developers.xsolla.com/ru/webhooks/operation/order-cancellation">Отмена заказа</a></td>
      <td><code>order_canceled</code></td>
      <td>Отправляется, когда заказ отменен.</td>
    </tr>
    <tr>
      <td><a href="https://developers.xsolla.com/ru/webhooks/operation/dispute">Диспут</a></td>
      <td><code>dispute</code></td>
      <td>Оповещение об открытии нового диспута.</td>
    </tr>
</tbody>
</table>


Version: 1.0

## Servers

```
https://api.xsolla.com/merchant/v2
```

## Download OpenAPI description

[Вебхуки](https://developers.xsolla.com/_bundle/@l10n/ru/webhooks/index.yaml)

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

### Поиск пользователя

 - [POST user-search](https://developers.xsolla.com/ru/webhooks/user-validation/user-search.md): Public User ID — параметр, по которому можно однозначно идентифицировать пользователя и который хорошо известен пользователю в отличие от User ID (в качестве Public User ID может быть email, никнейм и т. д.). Xsolla отправляет вебхук с типом user_search, когда оплата совершается вне игры (например, при оплате в терминале).

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

 - [POST user-validation](https://developers.xsolla.com/ru/webhooks/user-validation/user-validation.md): Xsolla отправляет вебхук с типом user_validation на URL-адрес вебхука, чтобы 
удостовериться, что пользователь зарегистрирован в игре. В процессе оплаты 
запрос отправляется несколько раз:

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

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

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


Примечание
Если вы зарегистрировались в Личном кабинете до 22 января 2025 г. (включительно), переключатели располагаются в разделе Настройки проекта &gt; Вебхуки &gt; Тестирование &gt; Payments &gt; Расширенные настройки.




    
        Переключатель
        Описание
    


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

### Проверка пользователя в Web Shop

 - [POST user-validation-in-webshop](https://developers.xsolla.com/ru/webhooks/user-validation/user-validation-in-webshop.md): Xsolla отправляет вебхук с сайта интернет-магазина на URL-адрес вебхука для проверки существования пользователя в игре. Вебхук поступает с IP-адреса 34.102.38.178.
Примечание Вебхук используется только для
проверки пользователя в Web Shop. Дополнительные сведения о настройке вебхука вы можете найти в инструкции.

## Payments

### Добавление платежного аккаунта

 - [POST add-payment-account](https://developers.xsolla.com/ru/webhooks/payments/add-payment-account.md): Когда пользователь добавляет платежный аккаунт вручную или сохраняет платежный аккаунт при совершении покупки, Xsolla отправляет вебхук с типом payment_account_add на URL-адрес вебхука. Чтобы получать вебхук, обратитесь к персональному менеджеру проекта или напишите на csm@xsolla.com.

### Частичный возврат платежа

 - [POST partial-refund](https://developers.xsolla.com/ru/webhooks/payments/partial-refund.md): При частичном возврате платежа Xsolla отправляет детали отмененной транзакции в 
вебхуке с типом partial_refund на URL-адрес вебхука. Подробная информация о 
процессе частичного возврата платежа приведена в инструкции.

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


Примечание
Если вы зарегистрировались в Личном кабинете до 22 января 2025 г. (включительно), переключатели располагаются в разделе Настройки проекта &gt; Вебхуки &gt; Тестирование &gt; Payments &gt; Расширенные настройки.




    
        Переключатель
        Описание
    


    
        Показывать информацию о транзакциях сохраненными способами оплаты
        В вебхуке будет передаваться информация в кастомных параметрах:saved_payment_method:0 — сохраненный способ оплаты не используется;1 — способ оплаты был сохранен при совершении текущей транзакции;2 — используется ранее сохраненный способ оплаты.payment_type:1 — единоразовый платеж;2 — рекуррентный платеж.
    



Коды отмены:


    
    
        Код
        Причина отмены
        Описание
    
    
    
    
        1
        Cancellation by the user request / the game request
        Используется, если отмена произошла из Личного кабинета.
    
    
        3
        Integration error
        Используется в случае проблем с интеграцией между Xsolla и игрой.В этом случае мы не рекомендуем заносить пользователя в черный список.
    
    
        5
        Test payment
        Используется в случае совершения тестового платежа с последующей отменой.В этом случае мы не рекомендуем заносить пользователя в черный список.
    
    
        7
        Fraud notification from PS
        Используется, если платежная система не произвела выплату по транзакции из-за потенциального фрода.В этом случае мы рекомендуем добавить пользователя в черный список.
    
    
        9
        Cancellation by the user request
        Используется, если игра или заказ не удовлетворяют требованиям пользователя по каким-либо причинам.В этом случае мы не рекомендуем заносить пользователя в черный список.
    
    
        10
        Cancellation by the game request
        Используется, когда игра просит отменить транзакцию.В этом случае мы не рекомендуем заносить пользователя в черный список.

### Успешный платеж

 - [POST payment](https://developers.xsolla.com/ru/webhooks/payments/payment.md): Когда пользователь успешно совершает оплату, Xsolla отправляет детали платежа в 
вебхуке с типом payment на URL-адрес вебхука.

Ожидаемые коды ответов описаны в разделе Responses, но вы можете 
использовать и другие коды:


    
    
        Код ответа
        Описание
    
    
    
    
        200, 201, 204
        Успешный ответ.
    
    
        4xx
        Возникновение ошибки. Например, если указанный пользователь не был найден или если передана недействительная подпись.
    
    
        5xx
        Временная ошибка на сервере. При получении этого ответа Xsolla отправляет вебхук повторно с увеличенным интервалом, пока ваш обработчик не подтвердит их получение. Максимальное количество попыток — 12 в течение 48 часов.
    
    


После сохранения URL-адреса вебхука в Личном 
кабинете вы можете настроить получение дополнительной информации в вебхуке.


Примечание
Если вы зарегистрировались в Личном кабинете до 22 января 2025 года (включительно), вы можете найти переключатели в проекте в разделе Настройки &gt; Вебхуки &gt; Тестирование &gt; Payments &gt; Расширенные настройки.




    
        Переключатель
        Описание
    


    
        Показывать информацию о сохраненном платежном аккаунте
        Информация о сохраненном способе оплаты передается в кастомном объекте payment_account.
    
    
        Показывать информацию о транзакциях сохраненными способами оплаты
        В вебхуке будет передаваться информация в кастомных параметрах:saved_payment_method:0 — сохраненный способ оплаты не используется;1 — способ оплаты был сохранен при совершении текущей транзакции;2 — используется ранее сохраненный способ оплаты.payment_type:1 — единоразовый платеж;2 — рекуррентный платеж.
    
    
        Добавить объект order в вебхук
        В вебхуке Успешный платеж будет передаваться информация о заказе в объекте order.
    
    
        Показывать только необходимую информацию о пользователе без чувствительных данных
        В вебхуке о пользователе будет передаваться только следующая информация:ID;страна.
    
    
        Показывать БИН карты и последние 4 цифры ее номера
        В вебхуке будет передаваться следующая информация о номере карты:первые 6 цифр в параметре card_bin;последние 4 цифры в параметре card_suffix.
    
    
        Показывать бренд карты
        Бренд карты, с которой была совершена оплата. Например, Mastercard или Visa.
    




Внимание
Набор полей, отправляемых в вебхуке, зависит:от расширенных настроек, которые вы установили в Личном кабинете;кастомных настроек, которые были заданы на стороне Xsolla.При возникновении вопросов обратитесь к персональному менеджеру проекта или напишите на csm@xsolla.com.

### Отмена платежа

 - [POST payment-declined](https://developers.xsolla.com/ru/webhooks/payments/payment-declined.md): Если транзакция была отклонена платежной системой, Xsolla присылает детали 
транзакции в вебхуке с типом ps_declined на URL-адрес вебхука. Вебхук 
отправляется на этапе авторизации или обработки платежа. Вебхук 
payment\ order_paid при этом отправлен не будет.

Типичные причины отклонения транзакции платежной системой:

* Авторизация карты не удалась (пример: платежная система не смогла завершить 
  процесс авторизации из-за технического сбоя или отсутствия ответа от банка) или 
  была отклонена (пример: банк ответил, но отказал в операции из-за недостатка 
  средств или неверных данных карты).
* Проверка 3-D Secure не удалась, не была завершена или истекло время ожидания 
  подтверждения пользователем.
* Процессор или банк-эквайер временно недоступен или возвращает жесткий отказ 
  (hard decline) из-за необратимой ошибки: например, закрытого счета или 
  недействительного номера карты. Повторная попытка без устранения причины ошибки 
  не приведет к успешному результату.

Следует отличать:

* От отклонений транзакции со стороны антифрод-системы, информация о которых 
  передается в вебхуке 
  afs_reject.
* Возврата и частичного возврата платежа после успешной оплаты, информация о 
  котором передается в вебхуках 
  refund и 
  partial_refund.


Примечание
Чтобы получать вебхук ps_declined, обратитесь к персональному менеджеру проекта или напишите на csm@xsolla.com.

### Возврат платежа

 - [POST refund](https://developers.xsolla.com/ru/webhooks/payments/refund.md): При отмене платежа Xsolla отправляет детали отмененной транзакции в вебхуке с 
типом refund на URL-адрес вебхука.

Механизм повторной отправки вебхуков зависит от инициатора возврата платежа:
* Если возврат был инициирован на вашей стороне, повторная отправка не 
  выполняется. Платеж возвращается пользователю вне зависимости от полученного 
  ответа на вебхук.
* Если возврат был инициирован третьей стороной, например платежной системой или 
  службой поддержки Xsolla, и на вебхук был получен ответ с кодом 5xx, вебхуки 
  отправляются повторно. Максимально выполняется 12 попыток с увеличивающимся 
  интервалом в течение 48 часов с момента первой попытки.

Подробная информация о процессе возврата платежа приведена в инструкции.


Внимание
При одновременном выполнении следующих условий платеж все равно будет возвращен пользователю:Инициатор возврата — Xsolla.На вебхук получен ответ с кодом 4xx, или после всех повторных попыток ответ не был получен, или был получен код 5xx.


После сохранения URL-адреса вебхука в Личном 
кабинете вы можете настроить получение дополнительной информации в вебхуке.


Примечание
Если вы зарегистрировались в Личном кабинете до 22 января 2025 года (включительно), вы можете найти переключатели в проекте в разделе Настройки &gt; Вебхуки &gt; Тестирование &gt; Payments &gt; Расширенные настройки.




    
        Переключатель
        Описание
    


    
        Показывать информацию о транзакциях сохраненными способами оплаты
        В вебхуке будет передаваться информация в кастомных параметрах:saved_payment_method:0 — сохраненный способ оплаты не используется;1 — способ оплаты был сохранен при совершении текущей транзакции;2 — используется ранее сохраненный способ оплаты.payment_type:1 — единоразовый платеж;2 — рекуррентный платеж.
    



Коды отмены:


    
    
        Код
        Причина отмены
        Описание
    
    
    
    
        1
        Cancellation by the user request / the game request
        Используется, если отмена произошла из Личного кабинета.
    
    
        2
        Chargeback
        Используется, если по транзакции был chargeback.
    
    
        3
        Integration error
        Используется в случае проблем с интеграцией между Xsolla и игрой.В этом случае мы не рекомендуем заносить пользователя в черный список.
    
    
        4
        Potential fraud
        Используется в случае потенциального фрода.В этом случае мы рекомендуем добавить пользователя в черный список.
    
    
        5
        Test payment
        Используется в случае совершения тестового платежа с последующей отменой.В этом случае мы не рекомендуем заносить пользователя в черный список.
    
    
        6
        User invoice expired
        Используется, если был выбран способ оплаты с системой отложенного платежа.
    
    
        7
        Fraud notification from PS
        Используется, если платежная система не произвела выплату по транзакции из-за потенциального фрода.В этом случае мы рекомендуем добавить пользователя в черный список.
    
    
        8
        Cancellation by the PS request
        Используется, когда платежная система запросила отмену транзакции.В этом случае мы не рекомендуем заносить пользователя в черный список.
    
    
        9
        Cancellation by the user request
        Используется, если игра или заказ не удовлетворяют требованиям пользователя по каким-либо причинам.В этом случае мы не рекомендуем заносить пользователя в черный список.
    
    
        10
        Cancellation by the game request
        Используется, когда игра просит отменить транзакцию.В этом случае мы не рекомендуем заносить пользователя в черный список.
    
    
        11
        Account holder called to report fraud
        Используется, когда владелец аккаунта сообщил, что не совершал данный платеж.
    
    
        12
        Friendly fraud
        Используется, если нам сообщили о friendly fraud.
    
    
        13
        Duplicate
        Используется, если произошла попытка повторной оплаты по счету.

### Удаление платежного аккаунта

 - [POST remove-payment-account](https://developers.xsolla.com/ru/webhooks/payments/remove-payment-account.md): Когда пользователь удаляет платежный аккаунт из сохраненных, Xsolla отправляет вебхук с типом payment_account_remove на URL-адрес вебхука. Чтобы получать вебхук, обратитесь к персональному менеджеру проекта или напишите на csm@xsolla.com.

## Объединенные вебхуки

### Отмена заказа (с деталями платежа и транзакции)

 - [POST order-cancellation](https://developers.xsolla.com/ru/webhooks/combined-webhooks/order-cancellation.md): Xsolla отправляет вебхук order_canceled на указанный URL-адрес, 
когда платеж отменен пользователем, партнером или автоматически. В вебхуке 
содержится информация о возвращенных товарах, платежные данные и детали 
отмененного заказа.

Вебхук не отправляется, если оплата не была успешной, например:
* платежный интерфейс был открыт, но пользователь не оплатил заказ;
* платежный интерфейс был открыт, но при оплате возникли ошибки.

Рекомендуемое время обработки вебхука — до 3 секунд.

### Успешная оплата заказа (с деталями платежа и транзакции)

 - [POST successful-order-payment](https://developers.xsolla.com/ru/webhooks/combined-webhooks/successful-order-payment.md): Xsolla отправляет вебхук order_paid на указанный URL-адрес, когда 
пользователь успешно оплатил заказ.

В вебхуке order_paid содержится информация о купленных товарах, 
данные платежа и детали транзакции.

Вебхук order_paid не отправляется, если оплата неуспешна, например:
* форма оплаты была открыта, но пользователь не оплатил заказ;
* форма оплаты была открыта, но при оплате возникли ошибки.

Рекомендуется обеспечить время обработки вебхука order_paid менее 
3 секунд.


Внимание
Набор полей, отправляемых в вебхуке, зависит от настроек, которые:вы установили в Личном кабинете в разделе Настройки проекта &gt; Вебхуки &gt; Расширенные настройки;были заданы на стороне Xsolla.При возникновении вопросов обратитесь к персональному менеджеру проекта или напишите на csm@xsolla.com.


Ожидаемые коды ответов описаны в разделе Responses. Вы можете 
использовать другие коды ответов. В зависимости от кода ответа и подключения 
функциональности автоматического возврата платежа логика обработки вебхука на 
стороне Xsolla следующая:


    
    
        Код ответа
        Автоматический возврат платежа не включен (по умолчанию)
        Автоматический возврат платежа включен
    
    
    
    
        400, 401, 402, 403, 404, 409, 422, 415
        Нет действий
        Автоматический возврат средств пользователю.
    
    
        200, 201, 204
        Нет действий
        Нет действий
    
    
        Другой код или отсутствие ответа на вебхук
        Многократная отправка вебхуков через заданный временной промежуток: 2 попытки с шагом 5 минут, 7 попыток с шагом 15 минут, 10 попыток с шагом 60 минут.
        Многократная отправка вебхуков через заданный временной промежуток: 2 попытки с шагом 5 минут, 7 попыток с шагом 15 минут, 10 попыток с шагом 60 минут. Если все вебхуки отправлены, а успешный ответ не получен, осуществляется автоматический возврат средств пользователю.
    
    


Для подключения функциональности автоматических возвратов обратитесь к 
персональному менеджеру проекта или напишите на csm@xsolla.com

## Отдельные вебхуки

### Отмена заказа (без деталей платежа и транзакции)

 - [POST order-cancellation-separate](https://developers.xsolla.com/ru/webhooks/separate-webhooks/order-cancellation-separate.md): Xsolla отправляет вебхук order_canceled на указанный URL-адрес, 
когда платеж отменен пользователем, партнером или автоматически. В вебхуке 
содержится информация о возвращенных товарах и детали отмененного заказа.

Вебхук не отправляется, если оплата не была успешной, например:
* платежный интерфейс был открыт, но пользователь не оплатил заказ;
* платежный интерфейс был открыт, но при оплате возникли ошибки.

Рекомендуемое время обработки вебхука — до 3 секунд.

### Успешная оплата заказа (без деталей платежа и транзакции)

 - [POST successful-order-payment-separate](https://developers.xsolla.com/ru/webhooks/separate-webhooks/successful-order-payment-separate.md): Xsolla отправляет вебхук order_paid на указанный URL-адрес, когда 
выполнены условия:
1. Пользователь успешно оплатил заказ.
2. Xsolla получила ответ об успешной обработке вебхука 
   payment.

В вебхуке order_paid содержится информация о купленных товарах и 
детали транзакции.

Вебхук order_paid не отправляется, если:
* Оплата не была успешной, например:
  * форма оплаты была открыта, но пользователь не оплатил заказ;
  * форма оплаты была открыта, но при оплате возникли ошибки.
* Ответ об успешной обработке вебхука payment не 
  получен.

Рекомендуется обеспечить время обработки вебхука order_paid менее 
3 секунд.

Ожидаемые коды ответов описаны в разделе Responses. Вы можете 
использовать другие коды ответов. В зависимости от кода ответа и подключения 
функциональности автоматического возврата платежа логика обработки вебхука на 
стороне Xsolla следующая:


    
    
        Код ответа
        Автоматический возврат платежа не включен (по умолчанию)
        Автоматический возврат платежа включен
    
    
    
    
        400, 401, 402, 403, 404, 409, 422, 415
        Нет действий
        Автоматический возврат средств пользователю.
    
    
        200, 201, 204
        Нет действий
        Нет действий
    
    
        Другой код или отсутствие ответа на вебхук
        Многократная отправка вебхуков через заданный временной промежуток: 2 попытки с шагом 5 минут, 7 попыток с шагом 15 минут, 10 попыток с шагом 60 минут.
        Многократная отправка вебхуков через заданный временной промежуток: 2 попытки с шагом 5 минут, 7 попыток с шагом 15 минут, 10 попыток с шагом 60 минут. Если все вебхуки отправлены, а успешный ответ не получен, осуществляется автоматический возврат средств пользователю.
    
    


Для подключения функциональности автоматических возвратов обратитесь к 
персональному менеджеру проекта или напишите на csm@xsolla.com

## Вебхук персонализации

### Персонализация каталога на стороне партнера

 - [POST personalized-partner-catalog](https://developers.xsolla.com/ru/webhooks/personalization/personalized-partner-catalog.md): Xsolla при взаимодействии пользователя с магазином отправит вебхук 
partner_side_catalog, который содержит параметры пользователя и 
проекта, на URL-адрес вебхука.

В ответе вам следует вернуть список item_id или артикулов 
предметов, которые доступны пользователю. При этом вы также можете передать 
информацию о том, что конкретный пользователь может купить определенный товар 
заданное количество раз. Эта возможность позволяет регулировать количество и 
вид товаров, которые пользователь может добавить в корзину и купить.

Рекомендуется обеспечить время обработки вебхука 
partner_side_catalog менее 3 секунд.

## Антифрод

### Обновление черного списка системы Anti-fraud

 - [POST afs-rejected-blocklist](https://developers.xsolla.com/ru/webhooks/anti-fraud/afs-rejected-blocklist.md): При обновлении черного списка системы Anti-fraud (добавление или удаление параметра) Xsolla отправляет вебхук с типом afs_black_list на URL-адрес вебхука. Добавление параметра выполняется автоматически на стороне Xsolla или по запросу. Удаление параметра возможно только по запросу. Чтобы получать вебхук, добавить или удалить параметр, обратитесь к персональному менеджеру проекта или напишите на csm@xsolla.com.

### Транзакция отклонена при проверке системой Anti-fraud

 - [POST afs-rejected-transaction](https://developers.xsolla.com/ru/webhooks/anti-fraud/afs-rejected-transaction.md): Если транзакция была отклонена при проверке системой Anti-fraud, Xsolla 
присылает детали транзакции в вебхуке с типом afs_reject URL-адрес вебхука. 
Чтобы получать вебхук, обратитесь к персональному менеджеру проекта или 
напишите на csm@xsolla.com.

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


Примечание
Если вы зарегистрировались в Личном кабинете до 22 января 2025 г. (включительно), переключатели располагаются в разделе Настройки проекта &gt; Вебхуки &gt; Тестирование &gt; Payments &gt; Расширенные настройки.




    
        Переключатель
        Описание
    


    
        Показывать информацию о транзакциях сохраненными способами оплаты
        В вебхуке будет передаваться информация в кастомных параметрах:saved_payment_method:0 — сохраненный способ оплаты не используется;1 — способ оплаты был сохранен при совершении текущей транзакции;2 — используется ранее сохраненный способ оплаты.payment_type:1 — единоразовый платеж;2 — рекуррентный платеж.

### Диспут

 - [POST dispute](https://developers.xsolla.com/ru/webhooks/anti-fraud/dispute.md): При открытии нового диспута или изменении статуса диспута Xsolla отправляет вебхук с типом dispute на URL-адрес вебхука. Чтобы получать вебхук, обратитесь к персональному менеджеру проекта или напишите на csm@xsolla.com.

## Subscriptions

### Отмена подписки

 - [POST canceled-subscription](https://developers.xsolla.com/ru/webhooks/subscriptions/canceled-subscription.md): Когда подписка отменяется по каким-либо причинам, Xsolla отправляет вебхук с типом cancel_subscription на URL-адрес вебхука.

### Создание подписки

 - [POST created-subscription](https://developers.xsolla.com/ru/webhooks/subscriptions/created-subscription.md): Когда пользователь создает подписку, Xsolla отправляет вебхук с типом create_subscription на URL-адрес вебхука.

### Непродлеваемая подписка

 - [POST nonrenewing-subscription](https://developers.xsolla.com/ru/webhooks/subscriptions/nonrenewing-subscription.md): Если статус подписки меняется на непродлеваемый, Xsolla отправляет вебхук с типом non_renewal_subscription на URL-адрес вебхука. Чтобы получать вебхук, обратитесь к персональному менеджеру проекта или напишите на csm@xsolla.com.

### Изменение подписки

 - [POST updated-subscription](https://developers.xsolla.com/ru/webhooks/subscriptions/updated-subscription.md): В случае изменения каких-либо параметров (plan_id, date_next_charge) подписки и в случае каждого продления подписки, Xsolla отправляет вебхук с типом update_subscription на URL-адрес вебхука.