Lago: биллинг по подписке и расходу на своём сервере

Когда счета считают в таблице

Типичная картина. Есть сервис, SaaS или ИИ-бот, который берёт деньги по подписке и сверху за расход: за токены, звонки к API, гигабайты, активных пользователей. В конце месяца кто-то выгружает логи, сводит их в таблицу и руками выставляет счета. Или разработчик пишет скрипт на коленке, который потом никто не решается трогать.

Пока клиентов десять, это терпимо. На сотне уже появляются расхождения, возвраты и вопросы «почему в этом месяце дороже». Каждый месяц несколько часов уходит на сверки, а продуктом заняться некогда.

Ломается это всегда в одном месте. Клиент спорит о цифре, а доказать её нечем. Клиент превысил лимит тарифа, а система узнала об этом через неделю. Вы хотите сменить цену, а для этого надо переписывать код расчёта. Если вы уже считаете выручку по подписке, как в статье про MRR и ARR, то знаете, сколько стоит каждая такая ошибка.

Что такое Lago и как она работает

Lago живёт в репозитории github.com/getlago/lago. Проект создан в феврале 2022 года, на момент проверки у него около 10,6 тысячи звёзд и 765 форков, последнее обновление кода от 1 октября 2026 года. Свежий релиз v1.53.0 вышел 8 сентября 2026 года. Проект активный.

Цепочка из README выглядит так: события использования, учёт, цены и кредиты, права доступа, счета, платежи. Приложение отправляет событие в API, например «клиент потратил 5000 входных токенов». Lago дедуплицирует события по полю transaction_id, поэтому повторная отправка не увеличит счёт. Из событий строятся метрики, к ним применяются ценовые правила: за единицу, ступенями, пакетами, процентом, с минимальным обязательством.

Возьмём ИИ-сервис с тарифом «990 в месяц, включено миллион токенов, дальше по цене за тысячу». В Lago это план с подпиской и метрикой токенов. Клиент докупает предоплаченные кредиты, кредиты автоматически пополняются при низком остатке, а при приближении к лимиту срабатывает оповещение. Те же примитивы подходят для вызовов API, вычислительных ресурсов и активных пользователей. Цены меняются в интерфейсе без правок кода, а для отдельного клиента можно задать собственные условия.

Свой сервер: лицензия, версия, ресурсы

Ядро распространяется под AGPL-3.0. Если вы запускаете Lago как отдельный сервис и ходите к нему по API, это обычный сценарий. Если дорабатываете код и отдаёте результат пользователям по сети, условия AGPL требуют открыть изменения. Для коммерческого продукта это стоит заранее согласовать с юристом.

Платные варианты такие: облачная версия Lago Cloud с коммерческой поддержкой и отдельные Premium-возможности. По README это выбранные ассистенты, корпоративные интеграции, функции governance и встроенный биллинг для платформ. Конкретный состав зависит от функции, его надо уточнять. Цены не опубликованы, их надо спрашивать у разработчика.

Установка по README: клонировать репозиторий, сгенерировать RSA-ключ для подписи вебхуков в файле .env и выполнить docker compose up -d. В Compose-файле поднимаются PostgreSQL, Redis, API, фоновые воркеры, веб-интерфейс и сервис генерации PDF-счетов. Для больших нагрузок авторы советуют Helm-чарты и отдельные воркеры. Требований к ресурсам сервера в README и инструкции по Docker нет, поэтому размер машины определяют тестовым запуском под вашу нагрузку.

Для сравнения есть Kill Bill, платформа подписок и платежей на Java с лицензией Apache 2.0. Проекту больше десяти лет, последний релиз 0.24.22 вышел 29 сентября 2026 года. Он модульный и расширяется плагинами. Lago заточена под учёт потребления и ИИ-продукты, Kill Bill ближе к классическим подпискам и платёжному контуру. Есть ли готовые плагины под российские шлюзы, я не проверял.

Что важно учесть: оплата и чеки в России

В документации сказано прямо: Lago не является платёжным провайдером. Родные интеграции есть для Stripe, Adyen и GoCardless. ЮKassa, Т-Банка и других российских шлюзов в списке нет. Поддержки 54-ФЗ, онлайн-кассы, закрывающих документов и УПД из коробки тоже нет, в README и разделе платежей они не упоминаются.

Что из этого следует. Lago считает и выставляет счёт, а деньги принимает другая система. Для таких случаев документация предлагает вебхуки: Lago сообщает о новом счёте, ваш сервис создаёт платёж в российском шлюзе, а после оплаты помечает счёт оплаченным через API. Чек пробивает касса или сам шлюз, закрывающие документы формируются отдельным модулем или в 1С. Схема рабочая, но её нужно написать и поддерживать.

Есть ещё три ограничения. Интерфейс и PDF-счета рассчитаны на международный формат, российские реквизиты потребуют настройки шаблона. Продукт силён там, где расход меняется от месяца к месяцу: если у вас три фиксированных тарифа и сто клиентов, хватит платёжной формы с автосписанием. И наконец, это ещё одна система на вашем сервере: бэкапы базы, обновления, мониторинг.

Что можно сделать уже сейчас

Первый шаг: выписать, за что вы реально берёте деньги. Подписка, расход, пакеты, разовые доплаты. Если расхода нет, Lago вам, скорее всего, не нужна.

Второй шаг: поднять Lago на тестовой машине и отправить десяток событий по вашему образцу. В README есть демо с ИИ-запросами, оно запускается локально и показывает расчёт токенов и защиту от повторной отправки.

Третий шаг: решить, как вы принимаете деньги и пробиваете чеки. Это определяет объём работ больше, чем сама установка. Если вы продаёте ИИ-продукт и выбираете между разовой разработкой и абонементом, пригодится разбор моделей оплаты ИИ под ключ.

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

Частые вопросы

Lago бесплатна?

Код открыт под AGPL-3.0 и запускается бесплатно на своём сервере. Облачная версия и Premium-возможности платные, прайс не опубликован.

Можно ли принимать оплату картами российских банков?

Через встроенные интеграции нет. Но Lago отдаёт данные счёта по вебхукам, и платёж можно создавать в российском шлюзе своим кодом. Какой шлюз подойдёт, зависит от вашего договора и формы бизнеса.

Нужна ли Lago, если у меня только подписка?

Часто нет. Она оправдана, когда есть расход, кредиты, лимиты и персональные условия клиентов.

Коротко о главном

Lago закрывает расчётную часть: события, метрики, цены, кредиты, лимиты и счета. Всё это на своём сервере и под вашим контролем. Приём денег, онлайн-кассу и закрывающие документы в России подключают отдельно.

Мы разворачиваем Lago и подключаем платежи и чеки под РФ. Напишите в Telegram со словом «БИЛЛИНГ», и я расскажу, как это уложить в ваш продукт.