Вебхуки
Вебхуки — это HTTP-запросы, которые приложение отправляет на ваш URL, когда в магазине что-то происходит: создан заказ, прошла оплата, начислены бонусы. Так внешняя система получает события без постоянного опроса API.
Подписка настраивается администратором в админ-панели, в разделе «Настройки приложения → Вебхуки». На каждое событие можно указать один адрес-подписчик.
Два режима событий
События делятся на два режима — они отличаются тем, влияют ли на ответ, который видит покупатель.
| Режим | Поведение | События |
|---|---|---|
| sync |
Запрос отправляется в момент обработки и блокирует ответ. Ваш ответ может изменить данные расчёта. Жёсткий таймаут; при ошибке, таймауте или ok:false расчёт продолжается по умолчанию. |
order.calculate, order.bonus.calculate, catalog.bonus.calculate |
| async | Доставляется в фоне, не задерживает покупателя. При ошибке повторяется с возрастающей паузой. |
order.created, order.paid, order.cancelled, bonus.* |
Подробнее о конверте, подписи и контракте ответа — в разделе Использование.
Список событий
| Событие | Режим | Когда срабатывает |
|---|---|---|
order.calculate |
sync | Перед оформлением заказа. Можно переопределить состав и итоговые суммы. |
order.bonus.calculate |
sync | При расчёте заказа. Возвращает бонусы к списанию и начислению. |
catalog.bonus.calculate |
sync | При выдаче списка товаров. Возвращает бонусы за каждый товар. |
order.created |
async | Заказ создан покупателем. |
order.paid |
async | Оплата заказа подтверждена. |
order.cancelled |
async | Заказ отменён покупателем. |
bonus.accrued |
async | Создано начисление бонусов (ожидает подтверждения). |
bonus.spent |
async | Бонусы списаны с баланса. |
bonus.expired |
async | Начисление сгорело по истечении срока. |
bonus.adjusted |
async | Баланс скорректирован администратором вручную. |
Полные схемы полей каждого события (payload запроса и ожидаемый ответ) — в OpenAPI-спецификации.
С чего начать
- Прочитайте Доступ и настройка — как зарегистрировать URL и получить секрет подписи.
- Прочитайте Использование — как проверять подпись и что отвечать на sync-события.
- Сверяйтесь со схемами полей в OpenAPI документации.
Связанные разделы
- Доступ и настройка
- Использование
- Настройки приложения — где находится вкладка «Вебхуки»
Обновлено 10.07.2026 09:33