Гайд · Telegram Stars

Подписки за Telegram Stars в мини-приложении: как построить бизнес-модель

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

Опубликовано:

Подписки за Telegram Stars в мини-приложении: как построить бизнес-модель

Разовая покупка приносит деньги один раз. Подписка — каждый месяц. Поэтому в большом обновлении мини-приложений в ноябре 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%.

Начать