Telegram Stars API для автоматизированных продаж
Краткий ответ
Telegram Stars — внутриприложенческая валюта платформы Telegram, используемая для оплаты цифровых товаров в ботах и каналах, разблокировки Telegram Premium, отправки реакций и чаевых создателям контента. Реселлеры могут продавать Telegram Stars через API, принимая Telegram user ID покупателя и зачисляя Stars напрямую на его аккаунт. С более чем 900 миллионами пользователей Telegram по всему миру Stars — быстрорастущий продукт пополнения с высоким спросом от активных пользователей Telegram.
Определение: Перепродажа Telegram Stars через API означает оптовую закупку Telegram Stars у B2B-поставщика и их доставку напрямую на аккаунт покупателя по user ID — без активируемого кода, доставка аккаунт-в-аккаунт.
Главный вывод: Telegram Stars уникально позиционированы: канал продаж реселлера часто совпадает с платформой, где покупатели используют продукт. Telegram-бот, продающий Stars, — сам продукт Telegram: покупатель приобретает Stars внутри Telegram и сразу же их использует. Это создаёт бесшовный цикл покупки, недоступный другим цифровым товарам.
Для кого это руководство
- Операторы Telegram-ботов, добавляющие Stars как продукт пополнения
- Реселлеры, таргетирующие активную аудиторию Telegram
- Интернет-магазины, добавляющие Telegram Stars как SKU цифровых товаров
- Разработчики, строящие автоматизированные пайплайны продаж Telegram Stars
Как работают Telegram Stars
Telegram Stars (⭐) используются в экосистеме Telegram для:
| Кейс использования | Требуемые Stars |
|---|---|
| Покупка цифровых товаров в ботах | Устанавливает владелец бота |
| Подписка Telegram Premium | 1000 Stars/месяц (иллюстративно) |
| Разблокировка профильных эмодзи | Варьируется |
| Отправка Stars создателям контента | Любое количество (чаевые) |
| Оплата сервисов в мини-приложениях | Устанавливает сервис |
| Подарок другому пользователю | Любое количество |
Stars покупаются за реальные деньги через приложение Telegram (по стандартному курсу Telegram) или через сторонних реселлеров по потенциально более низким ценам — это и есть возможность для реселлера.
Флоу пополнения через API
В отличие от подарочных карт, пополнение Telegram Stars требует Telegram user ID покупателя:
Шаг 1: Покупатель указывает свой Telegram user ID
(Найти в Telegram: Настройки → нажать на область с именем → числовой ID виден
в некоторых клиентах, или через @userinfobot)
Шаг 2: Валидация user ID
POST /validate-user
{ "platform": "telegram", "user_id": "123456789" }
→ { "valid": true, "username": "@username" }
Шаг 3: Показать имя пользователя для подтверждения
«Пополнение @username — подтверждаете?»
Шаг 4: Принять платёж; разместить заказ
POST /topup
{ "platform": "telegram", "user_id": "123456789", "stars": 500 }
→ { "order_id": "ORD-005", "status": "processing" }
Шаг 5: Stars зачислены на аккаунт; подтвердить покупателю
Справочник по пакетам Stars (иллюстративно)
Stars продаются пакетами. Размеры пакетов и цены зависят от поставщика. Следующее иллюстративно.
| Пакет | Stars | Прибл. розничная цена |
|---|---|---|
| Стартовый | 50 | ~$1,00 |
| Малый | 100 | ~$2,00 |
| Средний | 250 | ~$4,50 |
| Стандартный | 500 | ~$8,50 |
| Большой | 1000 | ~$16,00 |
| Мега | 2500 | ~$37,00 |
| Ультра | 5000 | ~$70,00 |
При внутриприложенческом курсе Telegram (иллюстративный ориентир) Stars продаются примерно по $0,016–0,02 за Star. Реселлеры могут предлагать конкурентные ставки, что делает сторонние пополнения привлекательными для частых пользователей.
Структура маржи (иллюстративно)
Только иллюстративный пример. Реальная маржа зависит от цен поставщика.
500 Stars — Telegram-бот с TON/крипто-платежом:
| Переменная | Сумма |
|---|---|
| Платит клиент (розница) | $9,00 |
| Оптовая стоимость | $8,25 |
| Валовая маржа | $0,75 |
| Комиссия (крипто, 0,5%) | $0,05 |
| Чистая прибыль | $0,70 |
| Чистая маржа | 7,8% |
500 Stars — интернет-магазин, оплата картой:
| Переменная | Сумма |
|---|---|
| Платит клиент (розница) | $9,00 |
| Оптовая стоимость | $8,25 |
| Комиссия (2,5%) | $0,23 |
| Чистая прибыль | $0,52 |
| Чистая маржа | 5,8% |
Telegram-боты, принимающие TON (нативная криптовалюта Telegram) или крипто-платежи, имеют значительно меньшие затраты на обработку платежей, что существенно улучшает маржу для продуктов малого номинала.
Продажа Stars через Telegram-бот
Естественный канал для Telegram Stars — Telegram-бот. Полный флоу:
Пользователь отправляет /buy боту @StarResellBot
Бот: «Сколько Stars? 100 | 250 | 500 | 1000»
Пользователь: 500
Бот: «Введите ваш Telegram user ID»
Пользователь: 123456789
Бот: «Пополнение @username — верно?»
Пользователь: Да
Бот: «Выберите оплату: [TON] [Card] [Crypto]»
Пользователь: TON
Бот отправляет TON-инвойс; пользователь оплачивает
Бот вызывает API → заказ размещён → Stars зачислены
Бот: «✅ 500 Stars отправлено @username. Заказ #ORD-005»
Этот флоу полностью автоматизируемый. С API поставщика и фреймворком Telegram-бота (Python: aiogram/python-telegram-bot; Node.js: telegraf) бот можно собрать менее чем за неделю.
Способы оплаты для ботов Telegram Stars
| Способ оплаты | Интеграция | Комиссия | Лучше для |
|---|---|---|---|
| TON (Toncoin) | Нативная интеграция Telegram | ~0,1–0,5% | Крипто-аудитория |
| Telegram Payments (Stripe) | Встроенный | 2,5%+ | Некрипто-покупатели |
| Карта (внешний шлюз) | API-интеграция | 2–3% | Международные покупатели |
| Крипто (USDT, BTC через шлюз) | API-интеграция | 0,5–1% | Privacy-аудитория |
Ключевые отличия от других top-up продуктов
| Параметр | Telegram Stars | PUBG UC | ML Diamonds |
|---|---|---|---|
| Платформа | Telegram | Мобильная игра | Мобильная игра |
| Идентификатор аккаунта | Telegram user ID | Game ID + сервер | Game ID + зона |
| Подходящий канал продаж | Telegram-бот (нативный) | Любой канал | Любой канал |
| Подходящий платёж | TON / крипто | Локальный платёж | Локальный платёж |
| Аудитория | Активные пользователи Telegram | Мобильные геймеры | Мобильные геймеры (SEA) |
Чек-лист
- Подтвердить, что поставщик предлагает top-up API для Telegram Stars
- Реализовать сбор Telegram user ID в флоу покупки
- Валидировать user ID перед приёмом платежа (показать имя для подтверждения)
- Принять платёж (TON рекомендован для контекста Telegram-бота)
- Разместить заказ через API и опрашивать статус
- Подтвердить доставку покупателю с референсом заказа
- Обработать состояния ошибок: неверный user ID, отказ заказа
- Указать в условиях: доставка Stars — на подтверждённый аккаунт; необратима после доставки
- Протестировать полный флоу в sandbox до запуска