Уведомление о возврате пришло раньше оплаты: как запоздалое событие меняет статус
Представим систему, которая учитывает полную оплату и полный возврат одного платежа. Провайдер создал событие об успешной оплате, а затем — об успешном возврате. Но в локальный обработчик уведомление о возврате пришло первым, а уведомление об оплате задержалось.
Если каждое сообщение безусловно перезаписывает статус, получается так. Сначала приходит возврат — локальный статус становится «возвращён». Затем приходит оплата — статус меняется на «оплачен».
Порядок получения | Событие | Локальный статус |
|---|---|---|
1 | Возврат завершён | Возвращён |
2 | Оплата завершена | Оплачен |
Второе сообщение может быть новым для нашей системы, хотя описывает более ранний этап. Проверка идентификатора события помогает отсеять повторную доставку того же события, но не определяет порядок двух разных событий. Провайдер также может прислать разные события об одном объекте; чтобы защитить бизнес-операцию, нужно учитывать его контракт и идентификатор самой операции. Здесь рассматриваем учебную модель, а не схему определённого провайдера.
В документации Stripe прямо указано, что порядок доставки событий не гарантирован. Другие системы могут определять другой контракт — его нужно проверять отдельно. Документация Stripe.
Как не потерять возврат
Для этой модели можно хранить факты отдельно: успешная оплата и успешный полный возврат. Позднее получение факта оплаты не удаляет уже сохранённый факт возврата. Итоговое состояние вычисляется из обоих фактов по правилам продукта.
Возьмём правило учебного примера: доступ зависит только от одной этой покупки и разрешён, если оплата подтверждена, а полный возврат ещё не известен. Полученные события уже проверены и относятся к одному платежу. Для него последовательная модель выглядит так:
def apply(state, event_id, event_type):
if event_id in state["seen"]:
return False
if event_type == "paid":
state["paid"] = True
elif event_type == "refunded":
state["refunded"] = True
else:
raise ValueError("unknown event")
state["seen"].add(event_id)
return True
def allowed(state):
return state["paid"] and not state["refunded"]
for events in [
[("e1", "paid"), ("e2", "refunded")],
[("e2", "refunded"), ("e1", "paid")],
]:
state = {"paid": False, "refunded": False, "seen": set()}
results = []
for event_id, event_type in events:
apply(state, event_id, event_type)
results.append(allowed(state))
# Повторяем каждую доставку и проверяем, что она пропущена.
for event_id, event_type in events:
assert apply(state, event_id, event_type) is False
print(results, allowed(state), len(state["seen"]))
Ожидаем [True, False] False 2 и [False, False] False 2. В первом случае доступ допустим после оплаты и до получения возврата. Во втором известный возврат не даёт поздней оплате вернуть право доступа. Повтор каждого события возвращает False и не добавляет новую запись в набор идентификаторов. Код можно сохранить в events_demo.py и запустить командой python3 events_demo.py. Это проверка последовательной логики для одного объекта в памяти, а не обработчик webhook или проверка параллельности.
Если после оплаты создаётся задача на выдачу доступа, сохранённый статус сам по себе не остановит уже отправленное внешнее действие. Перед выполнением нужно повторно учитывать актуальное право доступа. Но даже после проверки возврат может прийти, пока выполняется внешний запрос. Поэтому нужно предусмотреть сверку и устранение расхождений с учётом возможностей конкретного API.
Если провайдер предоставляет надёжную версию объекта или позволяет запросить его актуальное состояние, можно использовать и эти механизмы. Время получения webhook не говорит о том, каким было последнее состояние у провайдера. Проверка только времени события тоже требует понять контракт: что именно оно обозначает и как сравнивать события с одинаковым временем.
В варианте с одной базой отметку принятого события, обновление фактов и запись задачи на последующее действие можно сохранять в одной транзакции. Для этого нужен уникальный ключ события в области, определённой контрактом провайдера. До обработки входящего webhook следует проверить его подлинность по правилам провайдера; в примере проверка опущена.
Внешнее действие выполняется отдельно. Транзакция базы не делает это действие однократным. Если факт возврата пришёл раньше локальной записи платежа, его нельзя молча отбросить: понадобится сохранить событие для повторной обработки или согласовать состояние с источником.
Какие сценарии проверить
Возьмём один идентификатор платежа и два разных идентификатора событий. Для исходного состояния проверим оба порядка: оплата, затем возврат и возврат, затем оплата. В выбранной модели конечный результат должен отражать полный возврат. Отдельно повторим каждое событие и убедимся, что повторная доставка не создаёт дополнительный возврат.
При тестировании фиксируйте и промежуточные результаты: статус после первого сообщения, сохранённые факты, число записей и итог после второго. Если каждое сообщение запускает внешнее действие, для него нужны собственные правила повтора; одна транзакция локальной базы не делает внешний вызов автоматически однократным.
Частичные возвраты, несколько списаний и спорные платежи требуют более подробной модели. Если доступ оплачен несколькими покупками, возврат одной из них не обязательно должен его отменять: нужно пересчитать все действующие права пользователя.
Вывод следующий: два разных события могут прийти в разном порядке. Поэтому успешная дедупликация ≠ правильное итоговое состояние.
KioskNews shows a cleaned-up reading view extracted from the publisher’s page — the original always lives on their site, not ours.