Подписки за Telegram Stars в мини-приложении: как построить бизнес-модель
Как спланировать подписку за Telegram Stars в мини-приложении или боте: ценность, тарифы, цена, удержание и вывод дохода — с учётом ограничений Bot API.
Опубликовано:

Разовая покупка приносит деньги один раз. Подписка — каждый месяц. Поэтому в большом обновлении мини-приложений в ноябре 2024 года Telegram дал разработчикам подписки за Telegram Stars в мини-приложении: ежемесячная оплата за многоуровневый контент и функции. Это руководство не про техническую интеграцию (она — в нашем гайде по XTR-инвойсам), а про то, как построить модель.
1. Ценность: за что платят каждый месяц
Подписка работает, только если ценность возвращается снова и снова: новый контент, повышенные лимиты, пакет AI-запросов, режим без рекламы. Разовую пользу, упакованную в подписку, обычно быстро отменяют.
2. Тарифы
Bot API разрешает одному пользователю несколько параллельных подписок, поэтому тарифы легко собрать на отдельных ссылках на инвойс.
| Тариф | Что даёт | Для кого |
|---|---|---|
| Basic | Повышенные базовые лимиты | Пробующие |
| Pro | Все функции | Активные пользователи |
| Team / доп. пакет | Отдельной подпиской | Продвинутые пользователи |
3. Цена и технические ограничения
| Параметр | Правило Bot API |
|---|---|
| Валюта | XTR (Telegram Stars) |
| subscription_period | Пока только 2592000 (30 дней) |
| Максимальная цена | 10000 Stars |
| Признак повторного платежа | is_recurring, is_first_recurring |
| Окончание срока | subscription_expiration_date |
Назначая цену, учитывайте, сколько Stars стоят пользователю: как купить Stars и Premium за USDT.
4. Удержание
- Отслеживайте первый платёж (is_first_recurring) отдельно — он показывает качество онбординга.
- Напоминайте до окончания срока.
- Давайте ушедшим вернуться через editUserStarSubscription.
- Быстро отвечайте на /paysupport: Telegram требует от разработчика своевременной поддержки.
5. Доход
Заработанные Stars можно тратить на Telegram Ads или обменивать на вознаграждение через Fragment; перед получением действует период ожидания: 21-дневное удержание.
Сторона пользователя
Если подписчики держат запас Stars, продление не прерывается. Как владелец мини-приложения вы можете подсказать им, где купить Stars: в PayStars за USDT, от 50 Stars. Если нужно раздавать Stars многим пользователям: PayStars API.
Частые вопросы
Можно назначить цену подписки в долларах?
Для цифровых товаров валюта должна быть XTR (Telegram Stars); долларовый эквивалент можно указать в описании.
Может ли бот сам отменить подписку?
В Bot API есть метод editUserStarSubscription — бот может отменить или снова включить подписку пользователя.
Как распознать повторный платёж?
В successful_payment приходят поля is_recurring и is_first_recurring, а также subscription_expiration_date.
Источники
Покупайте Stars и Premium за USD (USDT)
Через API-ключ: 0% (цена Fragment). Через сайт: 5%.
Другие новости
Политика возвратов для бота с Telegram Stars: шаблон и примерыЧто должна включать политика возвратов бота с Telegram Stars: условия, срок, /paysupport и refundStarPayment, а также пример текста, который можно адаптировать.Читать →
Что происходит с Telegram Stars, если вы потеряли доступ к аккаунтуStars принадлежат аккаунту Telegram, а не телефону. Узнайте, что с ними будет при потере доступа, как вернуть вход и как защитить свой баланс.Читать →
Учёт доходов в Telegram Stars для автора или бизнесаКак вести понятный учёт доходов в Telegram Stars: что записывать, как фиксировать вывод через Fragment, как отделить личное от бизнеса и что спросить у бухгалтера.Читать →