Проверьте не кнопку, а серверный endpoint применения промокода. Запрос со старой вкладки, мобильного клиента или повторённого network trace должен получить отказ, если заказ уже paid, canceled или refund_pending. Скрытая кнопка в интерфейсе бизнес-правило не обеспечивает.
Граница цены проходит в момент подтверждённого платежа. До неё корзина может пересчитываться; после неё subtotal, discount, tax, total и применённые promotion IDs становятся снимком сделки. Любая последующая уступка клиенту оформляется отдельным credit/refund, иначе заказ перестаёт совпадать с фактически списанной суммой.
Гонка возникает между двумя допустимыми запросами
| Последовательность | Что ломается | Нужная защита |
|---|---|---|
| Coupon проверен → payment успел раньше | Скидка записывается в paid-заказ | Повторная проверка state при commit |
| Payment создан на старую сумму → coupon меняет total | Provider amount и order total расходятся | Pricing version в payment attempt |
| Webhook пришёл дважды | Повторный переход и side effects | Inbox/dedup по event ID |
| Старый клиент повторил apply | UI не знает нового state | Server returns conflict и свежий order |
| Оператор применил скидку вручную | Нет финансового следа | Отдельный adjustment с причиной |
Версия расчёта связывает заказ и платёж
order.state = "payment_pending"
order.pricing_version = 17
order.total_minor = 8450
payment_attempt.order_id = "order_demo_71"
payment_attempt.pricing_version = 17
payment_attempt.amount_minor = 8450
accept success only when amount and pricing_version still matchЭто условная модель. pricing_version увеличивается при каждом разрешённом изменении цены. Созданный payment attempt хранит версию и сумму. Если пользователь успел применить промокод до фактической отправки на оплату, система создаёт новый attempt для новой версии; старый не подтверждает обновлённый заказ.
Переход paid выполняется атомарно
Обработчик успеха блокирует или условно обновляет ровно нужную версию заказа: разрешённый прежний state, ожидаемая pricing_version, ожидаемая amount/currency. Если условие не совпало, событие не игнорируется и не меняет total — оно уходит в reconciliation. Там выясняется, был ли списан старый attempt и требуется ли отмена или возврат.
Stripe описывает PaymentIntent как объект жизненного цикла платежа. После successful payment корректирующим действием служит refund, а не переписывание истории charge. OWASP отдельно рекомендует пересчитывать цену и скидки на сервере и проверять порядок шагов чувствительного business flow во всех entry points.
Endpoint промокода имеет короткий контракт
- Принимает coupon code и order ID, но не доверяет discount amount от клиента.
- Загружает актуальный order state и отклоняет любое состояние вне разрешённого набора.
- Проверяет срок, аудиторию, usage limit и совместимость промо на сервере.
- Пересчитывает весь денежный снимок и увеличивает pricing_version одной операцией.
- Возвращает новый total и version; клиент не склеивает сумму самостоятельно.
Защита от гонки нужна и для администратора, и для публичного API, и для повторной обработки очереди. Один «внутренний» endpoint без state check снова откроет paid-заказ. Проверьте все пути по журналу route/handler, а не только основной checkout.
Скидка после оплаты становится новой финансовой операцией
Если бизнес решил дать промо уже оплатившему клиенту, создайте adjustment с причиной, исходным promotion ID и одобрением, затем выполните частичный refund или начислите разрешённый credit. Старый order total и charge amount сохраняются. Так отчёт объясняет разницу, а повтор операции можно дедуплицировать.
- Заморозить изменение цены для paid и refund_pending на уровне доменной команды.
- Добавить pricing version в payment attempt и проверку на success webhook.
- Повторить гонку двумя параллельными запросами apply и pay.
- Убедиться, что выигрывает ровно один согласованный transition.
- Проверить старый клиент, admin API и повтор webhook тем же event ID.
Отрицательный тест доказывает границу
Сценарий готов, когда прямой запрос coupon endpoint к paid-заказу возвращает конфликт без изменения pricing_version, а параллельный тест не создаёт состояния «оплачено 8450, итог 7450». Дополнительно проверьте, что legitimate adjustment виден отдельной записью и не запускается дважды.
Для расследования нужны timeline заказа, прежние и текущие pricing versions, payment/refund IDs, суммы и event IDs без персональных данных. Код промокода можно заменить меткой. По хронологии видно, какое entry point обошло state machine и где отсутствует атомарная проверка.