В биллинге опасны не «падения», а разрывы между тремя фактами: заказ создан, деньги списаны, подписка активирована. Если эти события живут в разных сервисах без общего правила фиксации, вы получаете revenue leakage, двойные списания или «бесплатный» доступ при ошибке маршрута.
Базовый паттерн — transaction outbox: сначала фиксируем бизнес-событие в той же транзакции, что и изменение состояния, затем асинхронно публикуем его в шину. Это снимает классическую проблему «в БД записали, в брокер не отправили». Для внешних вызовов нужен idempotency key, иначе повтор запроса после таймаута превращается в повторную оплату.
Отдельно проектируйте семантику повторов. Платежный шлюз, антифрод и entitlement-сервис должны уметь жить в режиме at-least-once: один и тот же charge request может прийти несколько раз, а финальное состояние обязано сходиться к одному ответу. Для этого держите явный state machine: pending → authorized → captured → failed → reversed, без прыжков через состояния.
Сложнее всего не happy path, а компенсации: частичный возврат, отмена после активации, расхождение между ledger и operational DB, задержка событий в очереди. Здесь помогает правило: источник истины для денег — ledger, источник истины для доступа — entitlement, а между ними только проверяемые переходы и аудит изменений.
Если в системе нет идемпотентности, outbox и формализованных компенсаций, она не распределенная, а просто недоописанная. Идемпотентность в биллинге — это не рекомендация, а базовый вопрос выживания системы.
Подписки: биллинг-лаб
@subscriptions_billing_lab_arb
Распределенный биллинг ломается не на оплате, а на границах консистентности данных
Этот пост опубликован в Telegram-канале Подписки: биллинг-лаб (@subscriptions_billing_lab_arb). Все его публикации — на странице канала.
Открыть в Telegram