Bots Billing — единая платёжная панель для ботов студии

Задача

Мы развиваем несколько Telegram-ботов на подписке (клиенты платят помесячно за пользование). Если каждый бот держит свою логику оплаты, свои чеки и свою обработку возвратов — быстро возникает хаос: где-то забыли отключить неоплатившего, где-то дважды списали, чеки приходится собирать руками. Отсюда идея — вынести биллинг в единый сервис.

Что проектируем

Централизованная система, к которой боты подключаются по единому API:

• API — каждый бот дёргает /subscribe, /check-active, /cancel. Логика везде одинаковая.
• Подписки — активные/просроченные/отменённые. Автосписание в назначенный день.
• Чеки — автоматическое формирование по 54-ФЗ, отправка клиенту.
• ЮКасса — интеграция с рекуррентными платежами. Клиент привязывает карту — списываем автоматически.
• Диспетчерская — отдельный Telegram-бот для нас: видим все платежи, отказы, возвраты, статусы подписок. Можем вручную продлевать, отменять, возвращать.

Стек

• FastAPI (Python) — для API
• PostgreSQL — хранение подписок, платежей, чеков
• Redis — кэш активных подписок (боты дёргают /check-active часто)
• ЮКасса API + рекуррентные платежи
• APScheduler для автосписаний
• Docker + docker-compose, деплой на VPS

Статус

Это внутренний проект студии, он в разработке и пока не запущен в полноценную эксплуатацию (ждём подключение платёжного токена). Поэтому цифр по оборотам и числу подключённых ботов мы не приводим — чтобы не выдумывать результаты. Что спроектировано и собирается:

• Единый API подписок, к которому боты подключаются одинаково
• Автоматическое формирование чеков по 54-ФЗ — без ручной работы
• Возвраты и отмены — из диспетчерской в пару кликов
• Аналитика в одном месте: активные подписчики, средний срок жизни, отток
• Быстрое подключение нового бота к биллингу

Почему это в портфолио

Это наш собственный опыт разработки SaaS-платформы для внутренних нужд. Если у вас похожая задача — агрегация платежей нескольких продуктов, единая подписка, диспетчерская — мы умеем это проектировать и делать, в том числе как часть Telegram-ботов. Показываем на этом проекте.