Для повторного запуска храните подтверждённый вход отдельно от истории попыток и выполненных бизнес-действий. Одна строка «ошибка» с копией JSON не объяснит, был ли уже отправлен запрос во внешнюю систему. До кнопки «повторить» определите идентичность события, область его источника и доказательство каждого необратимого эффекта.

Начните с теста: обработчик выполнил действие, но упал до отметки об успехе. Повтор должен восстановить понятный итог без второго действия либо остановиться для сверки, если исход неизвестен. Успех повторного разбора JSON ещё не означает безопасность replay.

Три записи вместо перезаписываемого статуса

СущностьЧто сохраняетЧто нельзя терять
Входное событиеПроверенный источник, исходные байты и версию форматаСмысл и происхождение входа
Попытка обработкиВерсию обработчика, начало, конец и исходПричину каждого запуска
Бизнес-эффектКлюч действия и подтверждённый результатЗащиту от повторного воздействия

Это предлагаемая модель приложения, а не требование единого стандарта webhook. Ключ эффекта выбирают по бизнес-смыслу: несколько разных событий иногда сообщают об одном действии, а одно событие способно требовать нескольких независимых действий. Запрет повтора только по delivery_id не заменяет такую модель. Внешний API также должен иметь проверяемый способ повторить действие или выяснить его итог.

Архивный запрос не становится новой сетевой доставкой

Stripe формирует новые timestamp и подпись при новой попытке доставки. Проверено по документации 16 октября 2026 года. Поэтому отправка старых байтов со старой подписью в публичный endpoint может не пройти допустимое окно времени. Не расширяйте это окно без ограничения и не отключайте проверку подписи ради архива.

Внутренний повтор запускают отдельным авторизованным процессом для ранее принятого события с сохранённым результатом первоначальной проверки. Он не должен превращаться в публичный обход валидации. Сомнительное происхождение архивного файла не разрешает считать его доверенным: понадобится новая штатная доставка или иной предусмотренный способ восстановления.

Условный запрос оператора на replay:
event_ref: внутренний безопасный ID
reason: причина запуска
handler_revision: выбранная версия
allowed_actions: ограниченный набор
preview: предполагаемые действия без эффекта
approval: по принятой модели полномочий

Старое событие и новый код могут означать разное

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

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

  • Завершённое событие не повторяет тот же эффект.
  • Незавершённая попытка допускает восстановление по известной границе.
  • Неизвестный внешний исход требует сверки, а не слепого повтора.
  • Два оператора не запускают конфликтующие попытки одновременно.
  • Старая схема проходит явную совместимую обработку или объяснимый отказ.

Если replay уже создал неверные действия, остановка процесса лишь прекращает новые. Отдельно составьте перечень эффектов и допустимые компенсации: удаление строки попытки не отменяет отправленное уведомление или изменение внешнего объекта. Для обсуждения механизма повтора полезнее схема состояний и результаты этих пяти тестов, чем выгрузка реальных payload.

Проверенные источники