Как принимать оплату Telegram Stars в своём боте (руководство 2026)

Что такое Telegram Stars

Telegram Stars: внутренняя валюта Telegram. Пользователи покупают звёзды пакетами и тратят их на цифровые вещи внутри Telegram: платный контент от ботов и мини-приложений, подарки, платные реакции и посты в каналах и так далее. Для владельца бота Stars: это официальный способ брать плату за цифровые товары и услуги. Bot API Telegram работает со Stars как с валютой с кодом XTR, а условия сервиса требуют, чтобы все платежи за цифровые товары и услуги внутри приложений Telegram проходили через Stars. Это удерживает ботов в рамках правил App Store и Google Play.

От того, где пользователь покупает Stars, зависит, сколько он заплатит. В приложениях для iOS и Android покупка проходит через Apple или Google, и по состоянию на сентябрь 2026 года одна звезда там стоит примерно два цента США. Покупка в веб-версии и настольных приложениях Telegram или на Fragment, собственной площадке Telegram, заметно дешевле, потому что комиссия магазина приложений в цену не входит. Цены зависят от региона, Telegram может добавлять местные налоги, а состав пакетов меняется, поэтому считайте эти цифры ориентировочными и проверяйте актуальную цену в своём приложении.

С вашей стороны сделки условия Telegram для разработчиков ботов прямо указывают, сколько звезда стоит для вас: вы можете потратить Stars на Telegram Ads по курсу 0,02 USD рекламного кредита за звезду или запросить вознаграждение, которое Telegram обрабатывает через Fragment и выплачивает в Toncoin в эквиваленте 0,013 USD за звезду. Те же условия говорят, что Stars на вашем балансе могут стать доступными в срок до 21 дня после получения. Разница между тем, что платит пользователь, и тем, что получаете вы, и есть цена всей системы: комиссия магазина приложений, доля Telegram и выплата в криптовалюте. При небольших объёмах это всё равно дешевле и куда проще большинства карточных процессингов, но рассчитывайте цены исходя из 0,013, а не из розничной стоимости.

Как выглядит оплата Stars для пользователя

Именно это делает Stars удобными для небольших продавцов. Нет страницы оформления заказа и ввода карты. Весь процесс происходит в чате:

1. Пользователь отправляет команду или нажимает кнопку, и ваш бот отвечает коротким превью: что он получит и какова цена в Stars.
2. Он нажимает Купить. Telegram показывает сообщение со счётом и встроенное окно подтверждения. Если звёзд на балансе не хватает, Telegram тут же предлагает пополнить его.
3. Одно нажатие для подтверждения. Telegram просит ваш бот одобрить покупку (это шаг предварительной проверки, и у бота есть 10 секунд на ответ), затем списывает Stars.
4. Ваш бот получает уведомление об успешной оплате и доставляет контент или сообщает покупателю, что вы с ним свяжетесь.

Для покупателя это ощущается как покупка набора стикеров или подарка Premium. Именно благодаря такому низкому порогу чаевые и небольшие платные разблокировки в Stars конвертируются намного лучше, чем внешняя ссылка на форму с картой.

Что можно продавать за Stars

Всё цифровое, что бот может передать сам или что вы можете доставить онлайн. Самые частые сценарии:

• Платные команды и закрытый контент. Команда, которая отвечает полностью только после оплаты: чек-лист в PDF, набор шаблонов, приватная ссылка на приглашение, запись, набор изображений, промокод. Пользователь видит тизер, платит, и полный ответ доставляется ему.
• Пожертвования и чаевые. Команда /donate с несколькими готовыми суммами и возможностью ввести свою. Идеально для авторов, open source проектов, администраторов сообществ и подкастеров, которым в основном нужно сказать «поддержите то, что я делаю».
• Цифровые продукты. Электронные книги, пресеты, наборы уроков, рабочие тетради, мини-курсы, обои, аудио. Если вы уже продаёте это где-то ещё, версия за Stars внутри Telegram: вторая витрина почти без настройки.
• Услуги, оказываемые онлайн. Слот на консультацию, разбор портфолио, персональный план питания. Бот принимает оплату, а вы выполняете работу вручную.
• Подписки. Telegram поддерживает регулярные подписки за Stars для ботов и каналов с периодическим списанием. TeleMinute сейчас продаёт разовые разблокировки и пожертвования, а не регулярные подписки, поэтому для автоматически продлеваемого членства понадобится собственный код или другой инструмент для этой части.

Если вы ведёте онлайн-курс, наше руководство по Telegram-ботам для онлайн-курсов рассказывает, как выстроить уроки и потоки; Stars: естественный способ брать за них плату. Более широкий обзор моделей дохода от ботов смотрите в статье как зарабатывать на Telegram-ботах.

Правила: только цифровое, а возвраты на вас

Два правила важнее всех остальных. Первое: Stars предназначены только для цифровых товаров и услуг. Условия Telegram по Stars описывают их как способ покупать цифровые товары и услуги у ботов и мини-приложений, а условия для разработчиков требуют, чтобы цифровые продажи проходили исключительно через Stars. Футболка, доставка еды или услуга с личным присутствием: это не продукт для Stars. Для физических товаров вы по-прежнему подключаете обычного платёжного провайдера через Bot API или даёте ссылку на свою страницу оплаты, и платные функции TeleMinute здесь не помогут.

Второе: возвраты лежат на продавце. Telegram заявляет, что продажи Stars пользователям окончательны, но от разработчика ожидается возврат средств покупателю, который не получил обещанное в оговорённый срок, и Telegram не выступает посредником в спорах. В Bot API есть отдельный метод возврата платежей в Stars, так что возврат: одно действие, а не тикет в поддержку. Но следите, чтобы ваши превью честно описывали, что и когда получит покупатель.

Ещё несколько мелочей, о которых стоит знать: Stars на балансе бота не являются вашей собственностью в юридическом смысле, это баланс, который вы можете конвертировать; если аккаунт владельца бота удалён, баланс теряется; Fragment может быть не в состоянии выплачивать вознаграждение пользователям в некоторых странах. Прочитайте актуальные условия один раз, прежде чем строить на этом бизнес.

Советы по ценам в Stars

• Используйте круглые числа. 25, 50, 100, 250, 500. Пользователи мыслят пакетами, а цена вроде 73 звёзд выглядит как пересчёт из другой валюты.
• Считайте по 0,013, а не по 0,02. Продукт за 100 звёзд приносит вам примерно 1,30 USD в виде вознаграждения, а не 2 USD. Оценивайте свою работу соответственно.
• Помните, где покупает ваша аудитория. Мобильная аудитория платит цену магазина приложений; аудитория с компьютера может купить дешевле в вебе или на Fragment. Сказать пользователям, что Stars дешевле в вебе, честно, и это часто ценят.
• Учитывайте региональную покупательную способность. За кулисами Stars оцениваются в долларах. 500 звёзд: лёгкие чаевые на одном рынке и серьёзная покупка на другом. Если аудитория глобальная, держите низкий уровень (25 или 50 звёзд) рядом с основной ценой.
• Предлагайте уровень чаевых, даже если продаёте продукты. Часть пользователей не купит продукт, но с радостью отправит 50 звёзд после полезного ответа.
• Планируйте с учётом удержания. Пока Stars станут доступными, может пройти до 21 дня, так что это не деньги на этой неделе. Относитесь к ним как к ежемесячной выплате.

Как принимать Stars в TeleMinute без кода

TeleMinute это конструктор Telegram-ботов без кода: команды, ответы по ключевым словам, кнопки, формы для сбора заявок, рассылки, статистика, ежедневный отчёт и автопостинг RSS, в вебе и в нативных приложениях для iOS и Android, с интерфейсом на 10 языках. Оплата Stars встроена в редактор и доступна на тарифе Premium ($3.99 в неделю, $9.99 в месяц или $49.99 навсегда, региональные скидки применяются автоматически). Вот вся настройка целиком.

1. Подключите бота. Создайте аккаунт TeleMinute и вставьте токен из BotFather (наше руководство по BotFather показывает, как это сделать) или начните с демо-бота на 15 минут из пула TeleMinute и добавьте свой токен позже. Для платежей нужен бот, которым владеете вы, поэтому добавьте свой токен до запуска.
2. Создайте то, что продаёте, как команду. В редакторе бота добавьте команду, например /checklist, и поместите в её ответ сам продукт: текст, до 4 изображений и кнопки, которые могут открывать URL, например ссылку на скачивание или приватное приглашение.
3. Включите «Платный контент». У той же команды включите переключатель Платный контент. Укажите Цена (Stars): любое целое число от 1 до 100 000. Напишите Текст превью, тизер, который пользователи видят до оплаты; оставьте пустым, и TeleMinute покажет стандартную заметку о закрытом контенте. Выберите Доставка: Автоматическая отправляет содержимое команды сразу после оплаты, и покупатель сохраняет доступ, поэтому повторная отправка команды возвращает контент без второго списания; Ручная означает, что вы сами связываетесь с покупателем и выполняете доставку, что подходит для консультаций и работы на заказ.
4. Добавьте пожертвования и магазин на вкладке «Платежи». В разделе Пожертвования включите функцию, оставьте или переименуйте команду пожертвований (по умолчанию /donate), введите до трёх готовых сумм, например 50, 100 и 250 звёзд, решите, разрешать ли произвольную сумму, и напишите сообщение благодарности. В разделе Магазин включите команду магазина (по умолчанию /store), которая перечисляет все платные команды в одном меню, чтобы пользователи могли посмотреть, что вы продаёте.
5. Сохраните и протестируйте со своего аккаунта. Откройте бота в Telegram, отправьте платную команду и проверьте превью и кнопку «Купить». Один раз заплатите своими Stars, чтобы увидеть счёт и доставку ровно так, как их увидит клиент. После этого можно сделать возврат самому себе.
6. Расскажите об этом. Упомяните платную команду в сообщении /start, добавьте кнопку, которая её запускает, и сообщите существующим пользователям через рассылку. Ответы по ключевым словам могут направлять тех, кто пишет «цена» или «купить», к команде магазина.
7. Отслеживайте продажи. Страница Продажи у каждого бота показывает общий заработок, общую сумму возвратов и количество продаж, а также строку по каждому платежу: покупатель, товар, сумма, дата и статус. Покупки с ручной доставкой помечаются как «Ожидает доставки», пока вы их не обработаете. У каждой строки есть Ответить, чтобы написать покупателю через вашего бота, и Вернуть, чтобы вернуть звёзды покупателю. Ежедневный отчёт может включать продажи за Stars, так что каждое утро вы будете получать сводку в Telegram.
8. Выведите средства. Stars поступают прямо на Telegram-баланс вашего бота, а не в TeleMinute; TeleMinute не берёт комиссию с ваших продаж. Когда Stars станут доступными, используйте их для Telegram Ads или запросите вознаграждение через Fragment, следуя актуальным условиям Telegram.

За кулисами TeleMinute отправляет счёт в XTR, отвечает на запрос предварительной проверки, сверяет сумму, записывает платёж, чтобы повторное уведомление не привело к двойной доставке, и помнит, кто что уже разблокировал. Вам ничего из этого трогать не нужно.

Часто задаваемые вопросы

Сколько стоит одна звезда Telegram?

Зависит от того, с какой стороны платежа вы находитесь. Пользователи покупают Stars пакетами, и по состоянию на сентябрь 2026 года одна звезда стоит примерно два цента США в приложениях для iOS и Android, а при покупке через веб-версию Telegram или на Fragment дешевле, потому что там нет комиссии магазина приложений. Со стороны владельца бота условия Telegram для разработчиков ботов устанавливают вознаграждение в эквиваленте 0,013 USD за звезду или 0,02 USD рекламного кредита, если вы тратите Stars на Telegram Ads. Цены зависят от региона и меняются со временем, поэтому сверяйтесь с актуальными условиями Telegram.

Можно ли продавать физические товары за Telegram Stars?

Нет. Условия Telegram отводят Stars только для цифровых товаров и услуг: контент, доступ, загрузки, консультации, членство, бонусы внутри бота. Физические товары и услуги, оказываемые офлайн, нужно продавать через обычного платёжного провайдера, подключённого к Telegram Bot API, или по ссылке на вашу собственную страницу оплаты. Платные команды, пожертвования и магазин в TeleMinute работают только со Stars и, следовательно, только с цифровыми продуктами.

Как вывести Stars, которые зарабатывает мой бот?

Stars, оплаченные вашему боту, попадают на собственный баланс Stars бота в Telegram, а не в TeleMinute. Условия Telegram для разработчиков говорят, что Stars могут стать доступными в срок до 21 дня после получения, после чего вы можете либо потратить их на Telegram Ads, либо запросить вознаграждение через Fragment, который выплачивает его в Toncoin в эквиваленте 0,013 USD за звезду. Fragment может быть недоступен в некоторых странах, и может действовать минимальная сумма, поэтому сверьтесь с актуальными условиями Telegram, прежде чем на это рассчитывать.

Нужно ли писать код, чтобы принимать Stars через TeleMinute?

Нет. В редакторе TeleMinute вы включаете «Платный контент» у любой команды, вводите цену в Stars, при желании добавляете текст превью и выбираете автоматическую или ручную доставку. Вкладка «Платежи» добавляет команду пожертвований с готовыми суммами и команду магазина, которая перечисляет все платные команды. Счета, подтверждение перед оплатой, доставка, страница «Продажи» с возвратами и ответами покупателям: всё это делается за вас. Платные функции требуют тарифа Premium.