25 lines
1.9 KiB
Markdown
25 lines
1.9 KiB
Markdown
# D-009. Заказы, платежи, движения по счёту; всё через баланс
|
|
|
|
Статус: принято, 20.10.2026.
|
|
|
|
## Контекст
|
|
|
|
У пользователя есть счёт. Заказ можно оплатить картой, с баланса или частично. Нужна ручная оплата из админки, которая запускает те же действия, что и настоящая.
|
|
|
|
## Решение
|
|
|
|
1. Три сущности: Заказ (что покупают), Платёж (деньги извне), Движение по счёту (неизменяемые записи «+» и «−»).
|
|
2. Любой успешный платёж зачисляется на баланс, любой заказ списывается с баланса.
|
|
3. Одна точка проведения `processPayment`, идемпотентная.
|
|
4. Ручная оплата — платёжная система `manual`. Платёж проводится, когда получает статус `succeeded`. Галочки «провести как реальную» нет.
|
|
5. Корректировка баланса — отдельная операция: только движение, без цепочки действий.
|
|
|
|
## Рассмотренные варианты
|
|
|
|
1. Одна сущность «транзакция» — смешивает коммерческий документ, деньги провайдера и баланс; сложно с частичной оплатой и повторами вебхуков.
|
|
2. Галочка «провести как реальную оплату» — не нужна: проведение запускает смена статуса.
|
|
|
|
## Последствия
|
|
|
|
Правило «списывается только разница с балансом» получается само. Подробно — [04-billing.md](../04-billing.md).
|