TgSuperstarsПартнёры
Партнёрская программа

Поставщик звёзд Telegram и Premium оптом — для вашего магазина, бота или сервиса

TgSuperstars Partner — оптовый поставщик звёзд Telegram и Premium по REST API для магазинов, ботов и реселлеров. Звёзды — от 50 до 50 000 в заказе, Premium — на 3, 6 и 12 месяцев; зачисление по username обычно за пару минут. Оптовая цена одна для всех партнёров и заметно ниже нашей розничной.

Стать партнёром → Документация API

Вход бесплатный. Первое пополнение — от 10 USDT, следующие — от 5; сумма остаётся на счету, из неё оплачиваются ваши заказы.

partner.tgsuperstars.com
Дашборд партнёрского кабинета: заказы, финансы, статистика
дашборд кабинета — заказы, финансы, статистика
одна ценадля всех партнёров
до 50 000звёзд в одном заказе
3 · 6 · 12месяцев Premium
напрямую вамвыручка от покупателей
Кому подходит

Где это работает: магазин звёзд Telegram, бот или сервис

Три способа продавать — одна интеграция. Витрина, чат-бот и сайт тянут товар из общего каталога, цена для всех трёх одинаковая.

01 — Магазин

Магазин звёзд Telegram

Ваш магазин звёзд Телеграм обходится без склада и без своего TON-кошелька: курсовой риск мы держим на себе. Оплатил покупатель — заказ сразу ушёл в исполнение. За вами остаётся оформление витрины и ценник.

без склада без кошелька TON ваша розничная цена заказ в момент оплаты
Витрина магазина в Telegram: баланс и товары
02 — Бот

Бот для продажи звёзд в Telegram

Покупатель называет username и платит в вашем боте — дальше зачисление звёзд на нашей стороне. Логика зачисления остаётся на нас, охота за чужими исходниками отменяется. Даже если создать бота для продажи звёзд Телеграм с нуля, продающая часть это ровно два обращения к API.

создали ключ → POST /validate/recipient → POST /orders
выдача на нашей стороне идемпотентность вебхуки о статусах
03 — Сайт или сервис

Сайт или свой сервис

У вас уже что-то продаётся — добавьте туда звёзды одним REST-вызовом: на сайте, в кабинете клиента, в панели агентства. Продавать Telegram Premium получится тем же вызовом — вместо числа звёзд в запросе указывается срок: квартал, полгода или год.

один вызов Premium тем же ключом OpenAPI-спека
Как устроена продажа

Три обращения к API, и каждое снимает свой риск

01

Сверка адресата

На username приходит ответ с именем из профиля; для Premium добавляется отметка, есть ли подписка у человека уже сейчас. Ошибиться получателем сложно: покупатель видит, на чей аккаунт уйдёт покупка звёзд.

02

Заказ с ключом идемпотентности

Списание с баланса происходит здесь же. Сеть подвела, запрос ушёл дважды — при том же ключе вернётся первый заказ, второго списания не будет.

03

Итог приходит вебхуком

В заголовке X-Signature лежит HMAC-SHA256 от тела, подписанный вашим секретом, — подмену видно сразу. Вебхук не дошёл? Тогда статус забирается запросом по номеру заказа.

04

Как запустить продажи

Заведите кабинет, положите на баланс от 10 USDT, создайте API-ключ и отправьте первый заказ. Код на старте необязателен: покупайте в кабинете руками, а интеграцию отложите на потом.

Цена

Оптовая цена: одна для всех партнёров

Одна цифра для всех партнёров. Посчитать свою маржу можно на калькуляторе справа.

Цена не зависит ни от оборота, ни от стажа, ни от умения торговаться: она одинакова для каждого партнёра и пересчитывается вслед за рынком. Расчёты идут в USDT, курс рубля в цене не участвует.

Уровней, порогов оборота, персональных скидок и торга нет. Цены на звёзды и Premium видны сразу после входа в кабинет — на первом экране, до нажатия «Стать партнёром» и до любой оплаты; после пополнения те же актуальные цены есть в разделе «Купить» и в каталоге API.

Свежий прайс на Telegram Stars и три тарифа подписки лежит в каталоге с вашими ценами. Звёзды Телеграм оптом доступны сразу после первого пополнения: минимальный заказ — 50 звёзд, сумма считается от количества.

Чтобы посчитать наценку, отталкивайтесь от нашей же розничной цены звёзд — 1,60 ₽ за штуку. Зазор между этой цифрой и вашей закупкой и есть маржа; распорядиться им вы вольны как угодно.

Бывает, что цена на минуту недоступна. Тогда каталог прямо отвечает «сейчас не продаём», и заказ не принимается: продавать по неизвестной цене — плохая идея для обеих сторон.

Калькулятор прибыли

это пример — актуальную оптовую цену смотрите в кабинете: она в USDT и меняется вслед за рынком
1,60 ₽
закупка в месяц ≈ 140 000 ₽
≈ 12 600 ₽
продаёте по ≈ 1,526 ₽/★ · маржа 0,126 ₽/★
100 000
10 0001 000 000
9%
0%20%

Прикидка: по умолчанию стоит условная закупка 1,40 ₽/★, это не наша цена. Закупочную цену возьмите из кабинета, розничную вы задаёте сами. Ориентир розницы — 1,60 ₽/★ на нашей площадке.

настройка цен
Экран настройки наценки на каталог
экран настройки цен — наценка на весь каталог

Розничную цену ставите вы

С баланса списывается партнёрская цена заказа — та же, что у всех. Разницу вы держите у себя: на витрине или в прайсе для клиента. Разница между вашей ценой и закупкой остаётся вам целиком.

Деньги

Деньги: выручка сразу у вас

Оплата покупателей

Платят вам, а не нам

Покупатель платит вам, вашими же средствами приёма — эквайринг, СБП, крипта, что настроено. К нам приходит только оптовая часть: с закупочного баланса снимается партнёрская цена, всё сверху ваше.

своя кассасвоя розницамаржа не делится
Закупочный баланс

Предоплата в USDT

Баланс работает как предоплата и наполняется переводом USDT — реквизиты видны в кабинете, зачисление идёт само. Уходит он только на заказы; при провале выдачи списание возвращается туда же.

от 10 USDTзачисление автоматомкак пополнить
Что входит

Что входит в подключение

01

Telegram Stars от 50 до 50 000 в заказе. Номиналы не навязаны: какое количество звёзд указали в запросе, столько и посчитается по цене за штуку.

02

Premium на квартал, полгода и год. Оформляется по username тем же вызовом, что звёзды: отдельная интеграция под подписку не нужна.

03

Ключ выпускаете сами. В кабинете нажимаете «создать» и получаете pk_live_…; менеджер в этой цепочке не участвует. При желании ключ привязывается к списку IP.

04

Лимиты названы заранее. 120 запросов в минуту на ключ и всплески до 30 — цифры опубликованы, а не выясняются под нагрузкой на проде.

05

Отказ вместо ожидания. Денег на балансе не хватило — заказ отклоняется сразу, а не ждёт пополнения.

06

Возврат и досдача. Выдать не получилось — сумма заказа вернётся на баланс сама; если перевод ушёл, но не подтвердился, решаем после ручной проверки. Отвалилась сеть доставки — заказы дожидаются её и уходят позже.

07

Документация открыта. Методы, коды ошибок и OpenAPI-спека лежат в открытом виде: прикинуть объём интеграции можно до того, как вы что-то заплатите.

Своими силами

Почему к Fragment нельзя подключиться напрямую

Fragment наружу не открывает ничего — ни доступов, ни описания методов, ни тестового контура. Публичного API для покупки звёзд или Premium там нет. А то, что поисковик показывает по запросу «Fragment API», — сторонние разработки: Telegram их не выпускает.

Повторить это самому означает завести кошелёк, держать в нём запас TON под скачки курса, дежурить у выдачи и латать её каждый раз, когда мессенджер что-нибудь у себя переделает. Пока латаете — продажи стоят.

Эту работу мы уже сделали и держим хозяйство сами. За вашей витриной работает поставщик звёзд Телеграм и Premium, а не самодельный скрипт: с вашей стороны — HTTP-вызов и предоплаченный счёт. Считайте, что это и есть API звёзд Телеграм и подписки. Подробный разбор с методами и параметрами — в статье про Telegram Stars API.

Для кого

Кому это приносит деньги

Владельцы каналов и чатов

Аудитория собрана давно, доставка идёт сама — витрине остаётся превратить подписчиков в покупателей.

Продавцы на FunPay и маркетплейсах

Та комиссия, которую забирала площадка, превращается в вашу маржу, стоит покупателю прийти напрямую.

Разработчики сервисов

Один предсказуемый интерфейс вместо ручных закупок у посредников: заказы клиентов уходят сразу, без переписки в чатах.

Перепродажа без склада

Перепродажа звёзд обходится без склада и курьеров — нужны витрина и ценник. Партнёрская программа открыта: заявки не рассматриваем — вошли, пополнили баланс и работаете.

API

Один запрос — заказ выполнен

Предсказуемый REST: идемпотентные заказы, вебхуки о статусах, каталог с вашими ценами. Методы, коды ошибок и OpenAPI-спека открыты до подключения.

идемпотентные заказы вебхуки о статусах 120 запросов/мин до 50 000 звёзд
POST /api/partner/v1/orders
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

Цены видны сразу после входа, ключ API — после первого пополнения, документация уже открыта. Остальное — ваша витрина и ваша наценка.