Зафиксировать результат операции

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

Спроектировать повторную обработку

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

Разделить приём события и тяжёлую работу

Webhook сначала проходит проверку подписи и сохраняется. Доставка файла, письмо или пересчёт отчёта могут выполняться в очереди. Если письмо временно не отправилось, повторяется отправка письма; платёж и заказ не должны создаваться заново. Настройка повторов зависит от операции и ограничений конкретного API.

Оставить способ сверить состояние

Журнал ошибок помогает найти сбой, но для восстановления нужна связь между локальной записью и объектом провайдера. Полезно заранее предусмотреть сверку зависших операций и безопасный ручной повтор. Проверять стоит потерю ответа, дубликат события, нарушение порядка и недоступность внешнего сервиса — вместе с обычным успешным сценарием.

Источники