Магазин звёзд Telegram
Ваш магазин звёзд Телеграм обходится без склада и без своего TON-кошелька: курсовой риск мы держим на себе. Оплатил покупатель — заказ сразу ушёл в исполнение. За вами остаётся оформление витрины и ценник.
TgSuperstars Partner — оптовый поставщик звёзд Telegram и Premium по REST API для магазинов, ботов и реселлеров. Звёзды — от 50 до 50 000 в заказе, Premium — на 3, 6 и 12 месяцев; зачисление по username обычно за пару минут. Оптовая цена одна для всех партнёров и заметно ниже нашей розничной.
Вход бесплатный. Первое пополнение — от 10 USDT, следующие — от 5; сумма остаётся на счету, из неё оплачиваются ваши заказы.
Три способа продавать — одна интеграция. Витрина, чат-бот и сайт тянут товар из общего каталога, цена для всех трёх одинаковая.
Ваш магазин звёзд Телеграм обходится без склада и без своего TON-кошелька: курсовой риск мы держим на себе. Оплатил покупатель — заказ сразу ушёл в исполнение. За вами остаётся оформление витрины и ценник.
Покупатель называет username и платит в вашем боте — дальше зачисление звёзд на нашей стороне. Логика зачисления остаётся на нас, охота за чужими исходниками отменяется. Даже если создать бота для продажи звёзд Телеграм с нуля, продающая часть это ровно два обращения к API.
У вас уже что-то продаётся — добавьте туда звёзды одним REST-вызовом: на сайте, в кабинете клиента, в панели агентства. Продавать Telegram Premium получится тем же вызовом — вместо числа звёзд в запросе указывается срок: квартал, полгода или год.
На username приходит ответ с именем из профиля; для Premium добавляется отметка, есть ли подписка у человека уже сейчас. Ошибиться получателем сложно: покупатель видит, на чей аккаунт уйдёт покупка звёзд.
Списание с баланса происходит здесь же. Сеть подвела, запрос ушёл дважды — при том же ключе вернётся первый заказ, второго списания не будет.
В заголовке X-Signature лежит HMAC-SHA256 от тела, подписанный вашим секретом, — подмену видно сразу. Вебхук не дошёл? Тогда статус забирается запросом по номеру заказа.
Заведите кабинет, положите на баланс от 10 USDT, создайте API-ключ и отправьте первый заказ. Код на старте необязателен: покупайте в кабинете руками, а интеграцию отложите на потом.
Одна цифра для всех партнёров. Посчитать свою маржу можно на калькуляторе справа.
Цена не зависит ни от оборота, ни от стажа, ни от умения торговаться: она одинакова для каждого партнёра и пересчитывается вслед за рынком. Расчёты идут в USDT, курс рубля в цене не участвует.
Уровней, порогов оборота, персональных скидок и торга нет. Цены на звёзды и Premium видны сразу после входа в кабинет — на первом экране, до нажатия «Стать партнёром» и до любой оплаты; после пополнения те же актуальные цены есть в разделе «Купить» и в каталоге API.
Свежий прайс на Telegram Stars и три тарифа подписки лежит в каталоге с вашими ценами. Звёзды Телеграм оптом доступны сразу после первого пополнения: минимальный заказ — 50 звёзд, сумма считается от количества.
Чтобы посчитать наценку, отталкивайтесь от нашей же розничной цены звёзд — 1,60 ₽ за штуку. Зазор между этой цифрой и вашей закупкой и есть маржа; распорядиться им вы вольны как угодно.
Бывает, что цена на минуту недоступна. Тогда каталог прямо отвечает «сейчас не продаём», и заказ не принимается: продавать по неизвестной цене — плохая идея для обеих сторон.
Прикидка: по умолчанию стоит условная закупка 1,40 ₽/★, это не наша цена. Закупочную цену возьмите из кабинета, розничную вы задаёте сами. Ориентир розницы — 1,60 ₽/★ на нашей площадке.
С баланса списывается партнёрская цена заказа — та же, что у всех. Разницу вы держите у себя: на витрине или в прайсе для клиента. Разница между вашей ценой и закупкой остаётся вам целиком.
Покупатель платит вам, вашими же средствами приёма — эквайринг, СБП, крипта, что настроено. К нам приходит только оптовая часть: с закупочного баланса снимается партнёрская цена, всё сверху ваше.
Баланс работает как предоплата и наполняется переводом USDT — реквизиты видны в кабинете, зачисление идёт само. Уходит он только на заказы; при провале выдачи списание возвращается туда же.
Telegram Stars от 50 до 50 000 в заказе. Номиналы не навязаны: какое количество звёзд указали в запросе, столько и посчитается по цене за штуку.
Premium на квартал, полгода и год. Оформляется по username тем же вызовом, что звёзды: отдельная интеграция под подписку не нужна.
Ключ выпускаете сами. В кабинете нажимаете «создать» и получаете pk_live_…; менеджер в этой цепочке не участвует. При желании ключ привязывается к списку IP.
Лимиты названы заранее. 120 запросов в минуту на ключ и всплески до 30 — цифры опубликованы, а не выясняются под нагрузкой на проде.
Отказ вместо ожидания. Денег на балансе не хватило — заказ отклоняется сразу, а не ждёт пополнения.
Возврат и досдача. Выдать не получилось — сумма заказа вернётся на баланс сама; если перевод ушёл, но не подтвердился, решаем после ручной проверки. Отвалилась сеть доставки — заказы дожидаются её и уходят позже.
Документация открыта. Методы, коды ошибок и OpenAPI-спека лежат в открытом виде: прикинуть объём интеграции можно до того, как вы что-то заплатите.
Fragment наружу не открывает ничего — ни доступов, ни описания методов, ни тестового контура. Публичного API для покупки звёзд или Premium там нет. А то, что поисковик показывает по запросу «Fragment API», — сторонние разработки: Telegram их не выпускает.
Повторить это самому означает завести кошелёк, держать в нём запас TON под скачки курса, дежурить у выдачи и латать её каждый раз, когда мессенджер что-нибудь у себя переделает. Пока латаете — продажи стоят.
Эту работу мы уже сделали и держим хозяйство сами. За вашей витриной работает поставщик звёзд Телеграм и Premium, а не самодельный скрипт: с вашей стороны — HTTP-вызов и предоплаченный счёт. Считайте, что это и есть API звёзд Телеграм и подписки. Подробный разбор с методами и параметрами — в статье про Telegram Stars API.
Аудитория собрана давно, доставка идёт сама — витрине остаётся превратить подписчиков в покупателей.
Та комиссия, которую забирала площадка, превращается в вашу маржу, стоит покупателю прийти напрямую.
Один предсказуемый интерфейс вместо ручных закупок у посредников: заказы клиентов уходят сразу, без переписки в чатах.
Перепродажа звёзд обходится без склада и курьеров — нужны витрина и ценник. Партнёрская программа открыта: заявки не рассматриваем — вошли, пополнили баланс и работаете.
Предсказуемый REST: идемпотентные заказы, вебхуки о статусах, каталог с вашими ценами. Методы, коды ошибок и OpenAPI-спека открыты до подключения.
curl -X POST https://pay.tgsuperstars.com/api/partner/v1/orders \ -H "Authorization: Bearer pk_live_..." \ -d '{ "type": "stars", "params": { "quantity": 100, "recipient": "username" }, "idempotency_key": "a1b2c3" }'
За вход не берём ничего. Расход один — первое пополнение закупочного баланса, от 10 USDT; следующие — от 5. Сумма остаётся вашей, а не превращается в наш сбор: из неё оплачиваются заказы.
Нет. TgSuperstars Partner — оптовая программа: вы закупаете у нас звёзды и Premium по API и перепродаёте их. У Telegram есть своя программа для ботов и мини-приложений — она отдельная, как и реферальная программа нашего розничного сайта tgsuperstars.com. TgSuperstars не аффилирован с Telegram и не является его партнёром.
Мы поставщик звёзд Телеграм с прайсом в API: цена одна для всех партнёров, без торга и «особых условий», и пересчитывается вслед за рынком. Сразу после входа в кабинет её видно на первом экране (до нажатия «Стать партнёром»), после пополнения — в разделе «Купить» и в каталоге API; в созданном заказе цена фиксируется.
Да. Хватит кабинета, API-ключа и денег на закупочном счёте — договора и реквизитов компании мы не спрашиваем.
Ради этого всё и устроено: закупка идёт по оптовой цене, розница на ваше усмотрение, потолка по заработку нет. Как считать выручку и что съедает маржу — в статье про сборку бота для продажи звёзд.
Нет. Зачисление целиком на нашей стороне: ваш код создаёт заказ и слушает вебхук. Собственная обвязка выдачи и чужие исходники не понадобятся — мы разобрали три публичные сборки по коду и показали, чего в них нет.
Нет. В Bot API нет метода, чтобы купить звёзды за деньги и отправить их другому человеку. Подарить Premium можно методом giftPremiumSubscription, но оплачивается он звёздами с баланса самого бота — 1000 за 3 месяца, 1500 за 6, 2500 за 12, — а купить звёзды на этот баланс через API тоже нельзя. Поэтому магазины закупают звёзды и Premium у поставщика: мы зачисляем их на username получателя, оплата — с вашего предоплаченного баланса.
Нельзя: Fragment не выдаёт программных доступов — ни токенов, ни описания методов. Сервисы с «Fragment API» в названии — сторонние, Telegram их не выпускает. У нас на этом месте запрос и предоплаченный баланс.
Сумма заказа вернётся на баланс сама, в вебхуке придёт финальный статус. Если перевод ушёл, но выдача не подтвердилась, заказ проверяем вручную: дошёл — закрываем как выполненный, не дошёл — возвращаем сумму на баланс.
При том же ключе идемпотентности — нет. Придёт первый заказ, списание останется одно, так что повтор после таймаута безопасен.
Telegram Stars, Premium на квартал, полгода или год и NFT-подарки — коллекционные подарки Telegram с оплатой с отдельного NFT-баланса в TON.
Заказ всё равно принимается, сумма списывается сразу, а подписка оформится сама, когда закончится текущая; если за 365 дней она так и не оформилась, сумма вернётся на баланс автоматически. Второй незавершённый заказ на тот же аккаунт отклоняется, а ожидающий заказ отменяется только через поддержку. При заказе через API, если ждать не подходит, сначала вызовите validate/recipient: для Premium он вернёт already_premium.
Нет, это предоплата под товар: она расходуется на заказы. Если заказ не выполнился, его сумма возвращается на баланс.
Обычно минуты: звёзды приходят на аккаунт получателя, и он видит их в самом Telegram. Итоговый статус всё равно принесёт вебхук.
Цены видны сразу после входа, ключ API — после первого пополнения, документация уже открыта. Остальное — ваша витрина и ваша наценка.