Back to Blog
TELEGRAM-STARS-API

Telegram Stars API оптом: звёзды и Premium без депозита

MyStars.tg TeamLast updated 7 min read

Telegram Stars API оптом ищут, когда звёзды нужно отправлять десятками и сотнями заказов из своего бота, магазина или игры. Через API MyStars для разработчиков ваш сервер создаёт заказ, переводит указанную сумму на кошелёк с комментарием, и звёзды или Telegram Premium приходят получателю через Fragment. Депозит, абонентская плата и минимальный объём для этого не нужны.

Telegram Stars API оптом: схема заказа через MyStars API, от котировки до вебхука о доставке
Заказ через MyStars API: котировка, проверка получателя, заказ и вебхук о доставке.

Кому нужен Telegram Stars API оптом

Чаще всего к API приходят три типа проектов. Реселлеры продают звёзды в своём боте или Mini App и закупают их под каждый заказ клиента. Агентства ведут клиентов, у которых десятки аккаунтов и каналов. А игры, конкурсы и креаторские платформы раздают звёзды как награды и не хотят, чтобы кто-то из команды делал это вручную в два часа ночи. Как это выглядит в живом проекте, мы разбирали на примере автоматических выплат призов в Telegram.

Тот же API отправляет и Telegram Premium на 3, 6 или 12 месяцев, так что подписки можно перепродавать без отдельной интеграции.

Если звёзды нужны вам самим или в подарок пару раз в месяц, API избыточен. Проще купить звёзды Телеграм на сайте или в боте @my_stars_tg_bot, а подписку оформить на странице Telegram Premium.

Без депозита, абонентской платы и минимального объёма

Многие оптовые поставщики работают через предоплаченный баланс: вы заранее пополняете счёт, а заказы списываются с него. Схема привычная, но неудобная. Деньги оказываются у поставщика ещё до того, как вы что-то купили. Баланс приходится держать с запасом, иначе он кончится ночью и выплаты встанут. А если с поставщиком что-то случится, вернуть остаток будет непросто.

В MyStars API баланса нет совсем. Вы платите за конкретный заказ в тот момент, когда он нужен, а до этого деньги лежат в вашем кошельке. Плата за подключение и ежемесячный платёж не нужны, обязательного объёма тоже нет. Можно начать с одного тестового заказа на 50 звёзд и дорасти до тысяч заказов в месяц, ничего не перенастраивая.

Предоплаченный баланс MyStars API
Когда вы платите заранее, пополняя счёт в момент создания заказа
Где деньги до заказа на счёте поставщика в вашем кошельке
Минимальный объём, абонентская плата бывают нет
Что делать с остатком выводить или держать у поставщика остатка не бывает

Ключи от кошелька остаются у вас

На это стоит смотреть в первую очередь, когда выбираете поставщика. Некоторые сервисы для покупки через Fragment просят передать им seed-фразу кошелька или сессию Fragment: так им проще подписывать транзакции от вашего имени. По сути, третья сторона получает полный доступ к вашим деньгам.

MyStars ваши ключи не запрашивает и не хранит. Оплата устроена просто. Когда вы создаёте заказ, API возвращает адрес кошелька, сумму и комментарий к платежу. Вы переводите ровно эту сумму на этот адрес с этим комментарием. Мы видим платёж, отправляем звёзды через Fragment и присылаем вебхук о доставке.

Отправить перевод можно как удобно: из своего платёжного сервиса, вручную из кошелька или через наш SDK для TON-кошелька. SDK подписывает транзакцию прямо на вашем сервере, и ключ никуда не уходит.

Актуальные цены только в ответе API

Цены на звёзды и Premium меняются, поэтому фиксированного прайса в API нет. Текущую стоимость всегда возвращает сам API. Для одного заказа это котировка через GET /v1/pricing. Если на витрине несколько пакетов, удобнее GET /v1/pricing/batch: он отдаёт до 200 позиций за один запрос. Сумма, которую нужно перевести, приходит в ответе на создание заказа.

Не зашивайте цены в код и не пересчитывайте их сами по курсу. Через час такой прайс уже разойдётся с реальностью.

Объёмы и лимиты

Перед тем как встраивать API в продукт, сверьтесь с этими параметрами. Данные из документации MyStars API на 28 октября 2026 года.

Параметр Значение
Звёзды в заказе от 50 до 1 000 000
Telegram Premium 3, 6 или 12 месяцев
Валюта оплаты GRAM (бывш. TON) или USDT в сети TON
Пакетная котировка до 200 позиций в одном запросе
Срок оплаты заказа 2 часа, точное время в поле expires_at
Лимиты поминутный бюджет запросов, дневной лимит заказов, защита от частых заказов на одного получателя
Котировки и проверки получателя до 30 запросов в минуту
События вебхука delivered, reversed, failed, expired

Дневной лимит заказов задан для каждого ключа. Если готовите крупную раздачу, прикиньте пиковую нагрузку заранее и напишите в поддержку. Ещё учтите защиту на получателя: серию частых заказов на один @username система остановит. Зато ошибка в цикле не превратится в десятки отправок одному человеку.

Подключение за пять шагов

1. Получите ключ. В @my_stars_tg_bot нажмите «API access». Ключ передаётся в заголовке X-Api-Key. Держите его только на сервере, не в Mini App и не в публичном репозитории.

2. Запросите котировку. Укажите товар, количество и валюту оплаты: ton для GRAM или usdt_ton для USDT.

3. Проверьте получателя. Вызовите POST /v1/recipients/check до того, как списывать деньги со своего клиента. Для звёзд и для Premium проверки разные. API покажет, какой профиль найден по @username, но опечатку в нике за клиента не заметит, поэтому покажите ему найденный профиль.

4. Создайте заказ. В POST /v1/orders передайте свой внутренний ID заказа как ключ идемпотентности. Если запрос оборвался по таймауту и вы повторили его с тем же ключом, API вернёт уже созданный заказ, а не создаст второй. При больших объёмах это главная защита от двойной отправки.

5. Оплатите и дождитесь вебхука. Переведите сумму из ответа на указанный адрес с комментарием. После доставки придёт подписанный вебхук delivered. Проверяйте подпись и не бойтесь повторов: вебхук может прийти несколько раз, обработка должна это выдерживать. На случай, если вебхук потеряется, держите запасной опрос через GET /v1/orders/{id}.

Какие данные хранить на своей стороне и что проверить перед запуском, подробно разобрано в статье B2B API Telegram Stars: продажа Stars и Premium.

Готовые SDK

Для TypeScript и Python есть SDK, в которых уже решены повторы запросов, идемпотентность, типизированные ошибки и проверка подписи вебхуков:

npm install @mystars-tg/faas-sdk
pip install mystars-faas

Для Node.js есть ещё опциональный SDK TON-кошелька. С ним интеграция работает без участия человека, пока на кошельке есть деньги. SDK для PHP и Go в планах, а из любого другого языка API вызывается обычными HTTPS-запросами. Установку и примеры кода мы собрали в гайде Fragment API SDK для ботов и приложений Telegram.

API или покупка на сайте

Задача Сайт или бот API
Купить звёзды себе или другу подходит избыточно
Десятки заказов в день на разных получателей долго вручную подходит
Продавать звёзды своим клиентам не подходит подходит
Автоматические награды и выплаты не подходит подходит
Статус доставки в вашей системе квитанция в Telegram вебхук и статус заказа

Если вы сравниваете нескольких поставщиков, пройдитесь по нашему списку вопросов к Telegram Stars API перед тем, как отправлять им деньги.

Что остаётся на вашей стороне

MyStars отвечает за выполнение заказа: приём оплаты и доставку звёзд или Premium получателю. Отношения с вашими клиентами, налоги и защита от мошенничества остаются за вашим бизнесом. Лучше продумать их до запуска, а не после первого спорного платежа.

С чего начать

Получите ключ в @my_stars_tg_bot, откройте документацию и сделайте тестовый заказ на 50 звёзд себе. Все возможности API и SDK собраны на странице Telegram Stars API для разработчиков.

Back to Blog