Журнал вебхуков

Журнал вебхуков — это техническая часть Журнала событий. Вебхук (webhook) — это автоматическое уведомление, которое одна система отправляет другой. Например, когда гость оплачивает бронь, платёжная система присылает StayBase сообщение «платёж прошёл» — это и есть вебхук.

Чаще всего администратору этот раздел нужен в одной ситуации: убедиться, что уведомление об оплате действительно дошло до системы. Если гость говорит, что заплатил, а бронь не подтвердилась — здесь видно, пришло ли уведомление от платёжной системы, прошла ли проверка подписи и с каким результатом StayBase его обработал.

Какие системы сюда пишут

В журнал попадают вызовы от всех внешних систем, с которыми связан StayBase:

Платёжный провайдер — FREEDOMPAY. Входящее уведомление о результате оплаты или возврата.
OTA-каналы — например OSTROVOK, BOOKING_COM. Уведомления о новых бронированиях и изменениях со стороны площадок.
Почта — POSTMARK. Статусы доставки писем (доставлено, отклонено, жалоба на спам).

Имя провайдера всегда пишется заглавными буквами. Добавление нового провайдера не меняет этот раздел — он подхватывается автоматически.

Колонки таблицы

Колонка	Описание
Провайдер	Система, от которой пришло уведомление (`FREEDOMPAY`, `POSTMARK`, OTA-канал и т. д.)
Направление	Входящий — уведомление пришло к нам; исходящий — мы отправили его сами. Слева от строки показана стрелка направления
Статус	Результат обработки: зелёный «Подпись ок» или «HTTP 200» — всё в порядке; красный бейдж («Подпись невалидна», «HTTP 4xx/5xx», «Ошибка») — была проблема; «—» — статус не определён
Связанный объект	К какой брони, платежу или письму относится уведомление (`Booking`, `Payment`, `EmailMessage`)
Итог	Краткое описание результата или текст ошибки
Когда	Время получения уведомления (при наведении — точная дата и время)

Строки с ошибкой выделены красной полосой слева. Ошибкой считается невалидная подпись, ответ с кодом 400 и выше или сохранённый текст ошибки.

Как проверить, что оплата прошла

Откройте вкладку «Webhooks».
При необходимости впишите имя провайдера в поле фильтра (например FREEDOMPAY) или выберите период.
Найдите входящее уведомление, относящееся к нужной брони или платежу (колонка «Связанный объект»).
Зелёный статус («Подпись ок» / «HTTP 200») означает, что уведомление получено, подпись проверена и обработка прошла корректно.

Нажмите на строку, чтобы открыть подробности конкретного вызова в боковой панели.

Подробности вызова

При клике на строку справа открывается панель с тремя вкладками:

Payload — тело уведомления (что именно прислал провайдер) в формате JSON. Есть кнопка «Копировать».
Headers — заголовки запроса (подпись, content-type) — для отладки. Если не сохранены, вкладка покажет соответствующую подсказку.
Детали — сводка: провайдер, направление, код HTTP, результат проверки подписи (валидна / невалидна / не проверялась), связанный объект, итог, текст ошибки, время получения и время обработки.

Фильтры

Фильтр	Описание
Период	Диапазон дат (есть пресеты: сегодня, последние 7/30 дней, этот/прошлый месяц)
Провайдер	Имя системы-отправителя (текстовое поле, например `FREEDOMPAY`)
Направление	Любое / Входящие / Исходящие
Подпись	Любая / Только валидные / Только невалидные уведомления

Кнопка «Очистить» сбрасывает все активные фильтры. Длинные списки подгружаются по кнопке «Загрузить ещё».