Определение
Вебхук — способ для одной системы уведомить другую о событии почти в реальном времени, отправив HTTP-запрос на URL, который получатель зарегистрировал заранее. Вместо того чтобы получатель повторно опрашивал API с вопросом «что-нибудь изменилось?», система-источник шлёт небольшой payload — тип события, идентификаторы, метку времени, часто подпись — на эндпоинт получателя в момент, когда событие происходит.
Вебхуки — стандартный механизм событийной интеграции между сервисами в современном вебе.
Надёжный дизайн вебхуков имеет известные требования: payload должен быть подписан, чтобы получатель мог проверить его подлинность; получатель должен отвечать быстро и обрабатывать асинхронно; доставка должна повторяться с backoff при сбое; и получатель должен быть идемпотентным, потому что одно и то же событие может быть доставлено больше одного раза. Без этого вебхук-интеграции теряют или дублируют события под нагрузкой.
В контексте
В iGaming вебхуки и их близкий родственник аффилиатный постбэк несут события, от которых зависят деньги. Платёжный провайдер шлёт вебхук, когда депозит проходит или поднимается чарджбэк; KYC-вендор шлёт его, когда верификация проходит или падает; игровой провайдер или агрегатор шлёт события раундов и джекпотов; CRM или платформа шлёт события регистрации, первого депозита и самоисключения в нижние инструменты.
Аффилиатный S2S-постбэк — по сути вебхук от оператора к трекеру аффилиата, объявляющий регистрацию, квалифицированный депозит или событие дохода.
Поскольку комиссии, бонусы и комплаенс-действия запускаются этими сообщениями, требования надёжности не опциональны. Пропущенный FTD-вебхук означает, что аффилиату не платят, а игрок может не получить бонус; дублированный может дважды засчитать конверсию; неподписанный может быть подделан для фейковых конверсий.
Операторы и аффилиаты поэтому защищают вебхуки подписями или IP-белыми списками, логируют каждое полученное событие, сверяют счётчики на вебхуках против отчётов источника истины по расписанию и строят инструменты повтора, чтобы пропущенный пакет можно было переслать. Большинство платёжных споров аффилиат-оператор, которые не о качестве трафика, сводятся к пробелам доставки вебхуков или постбэков, поэтому тестирование этого слоя на этапе интеграции — стандартная практика.
Разобранный пример
FTD-вебхук оператора к аффилиат-сети тихо падает на шесть часов во время сбоя провайдера. Поскольку обе стороны логируют события и сверяются ежедневно, пробел ловится на следующее утро; оператор повторяет пропущенные события, трекер сети дедуплицирует против своих логов, а конверсии и комиссия аффилиата исправляются без спора.
Частые вопросы
Смотрите полный глоссарий iGaming и арбитража — сотни терминов EN/RU с примерами.
← Назад к глоссарию