Введение

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

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

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

Например, вы можете отменить платеж через API Иксоллы, либо платежная система может нас оповестить об оспариваемой операции.

Примеры действий в результате обработки вебхука:

  • Пополнение баланса пользователя
  • Предоставление новых предметов пользователю
  • Доставка физических товаров пользователю

Вы должны принимать вебхуки со следующих IP-адресов: 185.30.20.0/24, 185.30.21.0/24, 185.30.23.0/24.

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

Мы не гарантируем, что ваш обработчик получит все вебхуки. Поскольку интернет-соединение не является на 100% надежным, вебхуки могут теряться или задерживаться. Ваш обработчик вебхуков также может возвращать код статуса HTTP 5xx при временных проблемах на вашем сервере. Например, если пользователь совершил успешную покупку виртуального предмета, но она не была добавлена в инвентарь, обработчик вернет код статуса HTTP 500.

Чтобы уменьшить риск потери оповещений, в сервисе вебхуков Иксоллы действует механизм повторных вебхуков. Если оповещение не было доставлено, сервис начинает повторную отправку вебхуков по следующему расписанию:

  • 2 попытки с интервалом 5 минут;
  • 7 попыток с интервалом 15 минут;
  • 10 попыток с интервалом 60 минут.
Максимально сервис выполняет 20 попыток отправки вебхуков в течение 12 часов с момента первой попытки.

Примечание
Хотя интернет-соединение является частой причиной проблем с вебхуками, наиболее вероятной причиной все же является проблема в логике обработчика вебхуков.
Была ли статья полезна?
Спасибо!
Что может сделать страницу еще лучше? Сообщение
Жаль, что так произошло
Расскажите, почему статья не была полезна. Сообщение
Спасибо за обратную связь!
Ваши мысли и идеи помогут нам улучшить ваш пользовательский опыт.
Оценить страницу
Оценить страницу
Что может сделать страницу еще лучше?

В другой раз

Спасибо за обратную связь!
Последнее обновление: 15 сентября 2022

Нашли опечатку или ошибку в тексте? Выделите ее и нажмите Ctrl+Enter.

Сообщите о проблеме
Мы постоянно улучшаем качество нашей документации. Ваш отзыв поможет нам в этом.
Укажите email-адрес, чтобы мы могли связаться с вами
Спасибо за обратную связь!