Telegram Stars

Происхождение и история термина

Telegram представил Stars 6 июня 2024 года как способ оплачивать цифровые товары и услуги в ботах и мини-приложениях. В анонсе упоминались электронные книги, онлайн-курсы и игровые предметы. Там же будущие возможности были отделены от функций, доступных на момент запуска. ^[1]

Исторический анонс объясняет появление механизма, но текущие правила берут из действующей документации и условий. К 2026 году условия также перечисляют платные материалы, подарки и поддержку создателей контента среди разрешённых способов использования личного баланса. ^[3] Telegram Stars и Telegram Premium не являются одним продуктом: Stars расходуются на отдельные действия, а Premium — это подписка, которая открывает дополнительные функции. ^{[3] [6]}

Суть и механизм

Платёжный путь начинается до цифрового заказа. Пользователь приобретает Stars через доступный ему канал; платёж может проводить сторонний посредник, а цена зависит от региона, налогов, комиссии и курса посредника. ^[3] После зачисления купленные Stars находятся на личном балансе пользователя.

Для продажи цифрового товара бот создаёт инвойс с тегом валюты XTR. Затем Telegram отправляет боту предварительный запрос pre_checkout_query. Бот принимает или отклоняет заказ, но положительный ответ ещё не подтверждает списание. Только сообщение с полем successful_payment подтверждает успешный платёж. После него продавец сохраняет идентификатор платежа и выдаёт товар или услугу. ^[2]

Эти шаги нельзя сливать в один статус «оплачено». Платёж может быть подтверждён, а файл, выпуск или доступ ещё не выдан из-за ошибки системы. И наоборот, ответ на предварительный запрос не даёт основания открыть покупку. Документация Telegram прямо требует дождаться successful_payment перед выдачей. ^[2]

Виды и классификации

Для редакционного проекта полезно разделять три объекта. Личный баланс показывает Stars, которыми располагает пользователь. Заказ связывает конкретное предложение, цену в Stars и подтверждённый платёж. Исполнение показывает, получил ли человек обещанный цифровой результат. Это редакционная модель учёта, а не официальная классификация Telegram.

Разделение помогает не переносить правила одного объекта на другой. Купленные Stars личного баланса нельзя свободно продавать, выводить или передавать за пределами способов, перечисленных в условиях. При этом бот или создатель может получить вознаграждение по отдельным правилам платформы. Возможность вознаграждения продавца не превращает личный баланс покупателя в свободно выводимые деньги. ^{[2] [3]}

Как применяется на практике

Учебный пример: редакция продаёт специальный цифровой выпуск через бота. До запуска она описывает состав выпуска, цену в Stars, срок выдачи и способ обратиться в поддержку. После события successful_payment система открывает выпуск, сохраняет связь заказа с идентификатором платежа и проверяет, что материал доступен с обычного читательского аккаунта. ^[2]

Для такого проекта удобно вести последовательность «заказ создан → платёж подтверждён → доступ выдан → выдача проверена». Ошибка выдачи получает отдельный статус. Благодаря этому сотрудник поддержки видит, завершился ли платёжный этап и что именно осталось исправить. Эта последовательность — рабочая схема редакции; Telegram не обещает готовый интерфейс с такими названиями статусов.

Для проекта с читателями из разных стран техническая последовательность остаётся той же, но доступные способы приобретения Stars, налоги и ограничения могут зависеть от региона и местного права. ^[3] Поэтому международный запуск проверяют отдельно по каждому целевому рынку, не перенося российские юридические выводы на другие юрисдикции.

Как измерить или проверить

Сначала задают период и единицу подсчёта. Пусть $S$ — число заказов с подтверждённым successful_payment за неделю, а $D$ — число этих заказов, по которым выдачу проверили. Доля проверенного исполнения равна

Если за неделю подтверждены 10 платежей и корректная выдача проверена по 9 заказам, то $E=9/10\times100\%=90\%$. Это результат учебного теста, а не рыночная норма и не допустимый уровень ошибок. Для сравнения периодов правила проверки должны оставаться одинаковыми.

Экономику считают отдельно. В одной колонке фиксируют цену предложения в Stars, в другой — фактическую стоимость приобретения Stars покупателем, в третьей — доступное продавцу вознаграждение по его условиям. Документация предупреждает, что цена для пользователя и чистое поступление разработчика могут различаться из-за налогов и других сборов. ^[2] Поэтому фиксированный рублёвый курс нельзя получать простым переносом одной величины на другую.

Ошибки, ограничения и спорные вопросы

Частая ошибка — выдать доступ после pre_checkout_query, не дожидаясь успешного платежа. Другая — обещать возврат самой покупки Stars на тех же условиях, что возврат цифрового заказа. Условия Telegram называют покупку Stars окончательной, но при недоставленном цифровом товаре разработчик может вернуть Stars за соответствующий заказ. ^[3]

Споры по цифровым товарам обрабатывает продавец. Бот должен отвечать на /paysupport, а продавец — разбирать запросы о платеже. Если законный возврат не выполнен, пользователь может взять идентификатор операции в разделе истории Stars и направить жалобу Telegram. ^{[2] [3]}

Для технического возврата Bot API предоставляет метод refundStarPayment. Он принимает идентификатор пользователя и идентификатор платежа Telegram и возвращает результат операции. ^[4] Этот метод не восстанавливает автоматически состояние доступа в системе продавца: после возврата нужно отдельно согласовать доступ, учёт заказа и сообщение пользователю.

Правовой аспект

Интерфейс инвойса для цифровых товаров не требует от пользователя вводить имя, адрес доставки или данные банковской карты. ^[2] Однако продавец может хранить идентификаторы пользователя, платежа, заказа и обращения в поддержку. Если российский оператор обрабатывает относящиеся к человеку сведения для собственной цели, он должен определить применимое основание обработки. Статья 6 Федерального закона № 152-ФЗ перечисляет такие основания; согласие является одним из них, но не единственным. Использована редакция закона от 26.07.2026, действующая 24.10.2026. ^[5]

Не следует считать технический идентификатор безусловно анонимным или собирать дополнительные сведения «на всякий случай». Состав данных, цель, сроки хранения и роли участников зависят от реализации. Для конкретной продажи необходима отдельная юридическая проверка; эта статья не определяет финансово-правовой статус Stars.

Частые вопросы

Связанные термины

• telegram-bot
• mini prilozheniya telegram
• telegram-kanal
• podpiska-na-smi
• konversiya
• personalnye-dannye