Доставка webhook с контролем повторов
Надёжная обработка webhook: очереди, повторы и сверка
Проектируем приём и отправку событий так, чтобы сбои можно было обнаружить, повторить и сверить с источником.

Контур обработки
Проверяем подпись, сохраняем исходное событие и отвечаем источнику. Бизнес-операция выполняется в очереди с ключом идемпотентности. Отдельно учитываем порядок событий и позднее получение старого состояния.
Абсолютной гарантии внешней доставки сеть не даёт. Практическая задача — подтвердить приём, сохранить событие и обеспечить повторяемую обработку без дублирования результата.
Одно событие может приехать дважды
Внешняя система вправе повторить уведомление, если не получила своевременный ответ. Приёмник сохраняет событие, подтверждает приём и передаёт обработку в очередь; уникальный ключ защищает бизнес-операцию от повтора. Если события связаны порядком, фиксируем правила для опоздавшего или пропущенного состояния.
- Временная ошибка
- Задача повторяется с ограничением частоты и числа попыток.
- Некорректные данные
- Событие уходит на разбор, сохраняя исходную нагрузку и причину отказа.
- Неизвестный итог
- Сверяемся с источником, прежде чем повторно создавать заказ, платёж или изменение доступа.
Панель диагностики позволяет найти цепочку по идентификатору события и безопасно повторить выбранную обработку.
Очередь необработанных событий должна быть видна ответственному. Для ручного повтора сохраняем причину и сотрудника, а сам повтор проходит те же проверки идемпотентности. Срок хранения исходного сообщения выбираем с учётом чувствительных данных и периода возможной сверки. Секрет подписи и персональные сведения не включаем в открытые диагностические ответы.