Telegram и MAX · рекуррентные списания · чеки по 54-ФЗ
Подключаю оплату к ботам Telegram и MAX: подписки с автопродлением, платный доступ к каналу или контенту, разовые платежи. Деньги, чеки и доступ сходятся без ручных операций, а каждую операцию можно объяснить постфактум.
Опыт из продакшена: платформа подписок на ~6 000 подписчиков с оборотом около 3 млн ₽ в месяц. Заказчик больше не участвует в приёме платежей.
Рекуррентные списания через провайдера и полный жизненный цикл подписки: оформление, продление, неудачное списание, отмена. Проектирую так, чтобы баланс сходился и любую операцию можно было объяснить постфактум.
рекуррентные платежи · тарифы · история операций
02
Платный доступ к каналу и контенту
После оплаты бот открывает доступ к закрытому каналу, разделу или материалам. Когда подписка заканчивается, доступ закрывается сам.
разграничение доступа · пригласительные ссылки
03
Разовые платежи
Оплата товара, консультации или доступа к материалу кнопкой или ссылкой прямо из диалога с ботом.
счёт · ссылка на оплату · подтверждение
04
Чеки по 54-ФЗ
Фискализация через облачную кассу провайдера в той же интеграции: чек уходит покупателю автоматически при каждом списании.
54-ФЗ · облачная касса
05
Защита от двойных списаний
Уведомления провайдера обрабатываются идемпотентно по идентификатору операции. Повторный вебхук не создаст второй платёж и не продлит подписку дважды: это заложено на уровне модели данных.
вебхуки · идемпотентность · external_id
06
Админ-панель и отчёты
Пользователи, подписки и платежи в одном месте: видно, кто платит и у кого подписка закончилась.
админ-панель · роли и права · выгрузки
Способы оплаты
выбираем под продукт
Способ
Где работает
Когда подходит
Платёжный провайдер по ссылке
Telegram и MAX
Подписки с автопродлением, оплата картой и через СБП, если провайдер её принимает. Деньги приходят на счёт бизнеса. В кейсе — CloudPayments и Rocketr.
Telegram Stars
Только Telegram
Цифровые товары и услуги через встроенные платежи Telegram: по правилам платформы такие платежи проходят только в Stars.
Встроенные платежи Telegram с провайдером
Только Telegram
Физические товары и услуги: покупатель платит, не выходя из чата.
Какой вариант допустим для вашего продукта, проверяем по правилам мессенджера и провайдера до начала разработки.
бот выдаёт ссылку→покупатель платит→провайдер шлёт вебхук→сервер проверяет и пишет платёж→бот открывает доступ
Пример задачи и архитектуры, а не проект из портфолио
Задача
Автор курса продаёт доступ к закрытому каналу с уроками и вручную проверяет переводы.
Как собрать
В Telegram доступ к курсу продаётся через встроенные платежи за Stars — так требуют правила Telegram для цифровых товаров. В MAX — ссылкой платёжного провайдера с подтверждением вебхуком. После оплаты бот выдаёт приглашение в канал, по окончании доступа снимает его. Все покупки — в одной админке.
Что получит заказчик
Продажи идут без ручной проверки, а доступ выдаётся и снимается сам в обоих мессенджерах.
Telegram Bot API · Stars · MAX API · платёжный провайдер
Как идёт работа
пять этапов
01
Разбор задачи
Созвон на двадцать минут: что продаёте, разово или по подписке, в каком мессенджере аудитория, какой провайдер уже подключён.
02
Выбор провайдера и схемы
Подбираем провайдера под продукт и правовую форму. Договор с провайдером заключает заказчик, я готовлю техническую часть.
03
Разработка
Модель подписок и платежей, обработка вебхуков, доступ к контенту, чеки, админ-панель.
04
Тесты и приёмка
Списания, продления и обработку ответов провайдера закрываю автотестами. Перед релизом прогоняю сценарии руками.
05
Запуск и поддержка
Мониторинг, разбор спорных операций, доработки под новые тарифы.
Сроки и стоимость
по задаче
Цена зависит от числа провайдеров и мессенджеров, сложности тарифов и того, есть ли уже бэкенд. После созвона присылаю оценку по этапам.
Для ориентира: платформа с админ-панелью, двумя ботами и двумя платёжными провайдерами ушла в продакшен за 1,5–2 месяца.
Частые вопросы
про оплату в ботах
Можно ли принимать оплату в боте без ИП?
Договор с платёжным провайдером заключает владелец бизнеса. Провайдеры подключают юрлиц и ИП, часть из них работает и с самозанятыми. Условия у каждого свои, поэтому провайдера выбираем до начала разработки.
Когда нужна оплата звёздами (Telegram Stars)?
Когда бот в Telegram продаёт цифровые товары или услуги через встроенные платежи: по правилам Telegram такие платежи проходят только в Stars. Для физических товаров и услуг можно подключать сторонних платёжных провайдеров. В MAX звёзд нет, оплата идёт через провайдера.
Можно ли принимать оплату по СБП?
Да, если провайдер принимает СБП. Для подписок отдельно проверяем, умеет ли он автосписания: от этого зависит, будет ли продление автоматическим.
Как работает бот для платного канала?
Бот принимает оплату, выдаёт доступ к закрытому каналу или разделу и снимает его, когда подписка заканчивается. В Telegram для этого бот получает права администратора канала и работает с пригласительными ссылками. В MAX набор методов для управления участниками другой, схему подбираю под актуальные ограничения API.
Что будет, если провайдер пришлёт уведомление об оплате дважды?
Ничего: каждое уведомление обрабатывается идемпотентно по идентификатору операции у провайдера. Повторное уведомление не создаст второй платёж и не продлит подписку дважды.
Нужны ли чеки по 54-ФЗ?
Если вы как ИП или компания принимаете оплату от физлиц, по 54-ФЗ нужен чек. Многие провайдеры формируют его через свою облачную кассу, это подключается в той же интеграции. Самозанятые выдают чеки через «Мой налог».
Подключим оплату
Напишите в Telegram, что продаёте и как сейчас принимаете деньги. Отвечу, какую схему выбрать и что войдёт в первую версию.