Что входит в платный доступ, кроме оплаты
Платёж подтверждает, что человек заплатил. Дальше бот должен сделать то, ради чего платили: впустить в закрытый канал или чат, выдать материалы, включить функции. А когда срок закончился — всё это забрать. Именно жизненный цикл подписки, а не сам платёж, чаще всего ломается в продакшене.
Сам приём платежей, счета и подтверждение разобраны в статье про платежи в Telegram-ботах. Здесь о том, что происходит после успешной оплаты и через месяц.
- Оплата и запись подписки: кто, до какого срока, какой тариф.
- Выдача доступа: ссылка-приглашение, заявка на вступление или включение функций в самом боте.
- Напоминания о скором окончании срока.
- Продление: автоматическое или по кнопке.
- Снятие доступа по истечении срока и обработка отказов.
- Ручные действия администратора: выдать доступ, продлить, вернуть деньги.
Подписка как набор состояний в вашей базе
Источник правды о том, оплачен ли доступ, — ваша база данных, а не состав участников канала. Для каждого пользователя хранят тариф, дату начала, дату окончания и статус. Бот работает от этих данных: решает, пускать ли человека, кому напомнить, кого убрать.
Удобно описать подписку как конечный набор состояний: ожидает оплаты, активна, истекает скоро, истекла, отменена. Переходы между ними происходят по событиям: пришла оплата, наступила дата, администратор вмешался. Так проще проверять логику и не путаться в частных случаях. Схожий подход к диалогам описан в статье про состояние диалога бота.
- Дата окончания хранится явно, а не вычисляется «от последней оплаты» по памяти.
- Каждый платёж записывается отдельной строкой с идентификатором из платёжной системы.
- История изменений статуса сохраняется: пригодится при спорах с клиентом.
- Продление добавляет срок к текущей дате окончания, если подписка ещё активна, а не к дате оплаты: так клиент не теряет оплаченные дни.
Два способа продавать подписку
У Telegram есть собственные платные подписки на канал в Telegram Stars: бот создаёт специальную ссылку-приглашение с ценой, и Telegram сам списывает плату по расписанию. По документации Bot API период такой подписки сейчас всегда 30 дней, а цена задаётся в Stars (от 1 до 10000). Это самый простой путь для канала, но он привязан к Stars и к монолитному 30-дневному циклу.
Второй путь — собственная логика поверх обычных платежей: вы сами решаете тарифы, сроки (неделя, квартал, год), промокоды и пробный период, а срок и напоминания ведёте в своей базе. Он гибче и подходит, когда нужны фиатные платёжные провайдеры или нестандартные условия, но всю работу по продлению и отзыву доступа вы делаете сами. Какие провайдеры доступны, зависит от страны и их условий, это проверяют до старта.
- Нативная подписка Telegram: проще, цикл 30 дней, оплата в Stars, только для канала.
- Собственные тарифы на обычных платежах: любые сроки и условия, но своя логика продления и напоминаний.
- Можно сочетать: Stars для цифрового доступа, провайдер для остального.
Как выдавать доступ в закрытый канал или чат
Бот должен быть администратором канала или чата с правом приглашать пользователей. Дальше есть два основных подхода. Первый — одноразовая ссылка-приглашение: бот создаёт ссылку со сроком действия и ограничением числа участников, равным одному, и отправляет её оплатившему. Так ссылкой нельзя поделиться с другими.
Второй — ссылка с заявкой на вступление: человек подаёт заявку, а бот проверяет по своей базе, оплачен ли доступ, и одобряет или отклоняет заявку. Этот вариант надёжнее, потому что решение принимается в момент вступления по актуальным данным. Учтите, что в ссылке с заявкой нельзя одновременно задать лимит участников.
- Бот — администратор с правом приглашать пользователей.
- Одноразовая ссылка: срок жизни и лимит в одного участника.
- Либо заявка на вступление с проверкой по базе.
- Ссылку после использования отзывают, чтобы она не гуляла.
Как снимать доступ, когда срок вышел
Telegram сам не знает о вашей подписке, поэтому убирать человека должен бот по расписанию. Раз в определённый интервал фоновая задача находит подписки с истёкшим сроком и удаляет пользователей из канала или чата. Это удобно делать через фоновые задачи и очереди, чтобы сбой одного вызова не останавливал остальных.
Есть тонкость с методами. Бан участника не даёт ему вернуться по ссылке, пока его не разбанили. Разбан без условия на пользователе, который сейчас в чате, удаляет его из чата, но позволяет вступить снова по новой ссылке. Для подписки обычно нужен именно второй вариант: убрали по сроку, а после продления человек может вернуться. Постоянный бан оставляют для нарушителей.
- Фоновая задача регулярно ищет истёкшие подписки.
- Удаление из чата выполняется повторяемо: повторный вызов не должен ломать процесс.
- Об истечении срока человека предупреждают заранее и сообщают после снятия доступа.
- Чтобы видеть выход и вступление участников, бот должен явно запросить обновления об участниках чата; по умолчанию их нет.
Сбои оплаты и продление
Деньги могут не пройти: недостаточно средств, карта заблокирована, платёж прерван. Для собственной логики стоит заранее решить льготный период: сколько времени после окончания срока человек сохраняет доступ, пока бот напоминает о продлении. Это снижает число обиженных клиентов и ручных обращений.
У нативной подписки в Stars своя логика: бот получает обновление об изменении состояния подписки — отмена, возобновление или сбой — и должен на него реагировать, а не считать, что подписка вечна. Пользователь может отменить продление, и доступ сохраняется до конца оплаченного периода. Обработку повторных доставок обновлений и дублей платежей описывает статья про идемпотентность и повторы.
- Льготный период после окончания срока: да или нет, и сколько.
- Повторное платёжное событие не продлевает подписку второй раз.
- Отмена продления не отнимает уже оплаченные дни.
- Возврат и ручное продление администратором записываются в историю.
Что решить до начала разработки
Большая часть стоимости и сроков уходит в детали правил, а не в код приёма платежа. Перед разработкой согласуйте их с заказчиком, чтобы не переделывать данные после запуска.
Если вы выбираете между разработкой и готовым решением, сравните варианты в статье заказать Telegram-бота или сделать самому. Мы делаем такие боты в рамках услуги разработки телеграм-ботов.
- Что продаётся: доступ в канал, чат, материалы или функции бота.
- Тарифы и сроки, пробный период, промокоды.
- Нужно ли автопродление и как напоминать об окончании.
- Льготный период и правила возврата.
- Кто управляет подписками вручную и где это видно: админ-панель или команды бота.
- Какая платёжная система подходит для вашей аудитории и страны.