Бизнес

Что такое Telegram Stars API и как подключиться? (2026)

Telegram Stars API — REST/JSON API для автопродажи Stars, Premium и Gifts. Как работает, кому подходит и как подключиться через StarsPaymee Business — полное руководство и 27 вопросов‑ответов.

Краткий ответ

Telegram Stars API — программный интерфейс для автоматической продажи Telegram Stars, Premium и Gifts. Через StarsPaymee Business вы получаете REST/JSON‑ключ и подключаете его к своему боту или сайту: заказ создаётся, оплата принимается, а Stars доставляются на @username в среднем за 10 секунд автоматически.

Что такое Telegram Stars API?

Telegram Stars API — это программный мост, через который ваше приложение (бот, Mini App или сайт) отправляет запросы в систему StarsPaymee и автоматически продаёт Telegram Stars, Premium и Gifts. Проще говоря: клиент платит вам, а ваша система через API даёт StarsPaymee команду «доставить столько‑то звёзд такому‑то пользователю», и доставка выполняется автоматически.

Ключевые факты
  • Формат — REST API, запрос и ответ в JSON.
  • Товары — Stars, Premium, Gifts, а также оплата Click и SBP (рубли).
  • Доставка — по @username, в среднем за 10 секунд, без пароля.
  • Webhook — уведомление на ваш сервер при смене статуса заказа.
  • Sandbox — тестовая среда без реальных денег.

Как работает API?

В процессе три стороны: клиент, ваша система и StarsPaymee API. Клиент выбирает товар в вашем боте или на сайте, вы принимаете оплату и отправляете заказ в API. StarsPaymee выполняет доставку на стороне Telegram и возвращает результат через webhook.

  1. 1. Получите API‑ключЗарегистрируйтесь в StarsPaymee Business и получите API‑ключ (токен). Ключ аутентифицирует каждый запрос.
  2. 2. Загрузите цены и каталогЧерез GET /products получаете актуальные цены, пакеты и список доступных товаров.
  3. 3. Создайте заказВ запросе POST /orders передаёте товар, количество и получателя @username.
  4. 4. Отслеживайте статусЧерез webhook или GET /orders/{id} проверяете состояние заказа (pending → delivered).

Хотите подключить API или узнать цену? Свяжитесь с Business.

@StarsPaymee_bot

Кому подходит?

Владельцам ботов

Добавьте продажу Stars/Premium в свой бот и полностью автоматизируйте продажи.

Реселлерам и магазинам

Устанавливайте свою цену и перепродавайте звёзды и Premium — расчёты на стороне API.

Сайтам

Передавайте заказ из формы оплаты на сайте в API и доставляйте автоматически.

White Label проектам

Полноценная платформа под вашим брендом — на бэкенде работает StarsPaymee API.

Как подключиться?

Для подключения перейдите на страницу StarsPaymee Business и оставьте заявку. После регистрации API‑ключ выдаётся быстро, и вы сразу начинаете тест в Sandbox. По вопросам интеграции поможет @StarsPaymeeSupport. Подробнее: Premium API, Click API и SBP (рубли) API.

Источники

Часто задаваемые вопросы

Что такое Telegram Stars API?
API для автоматической продажи Telegram Stars, Premium и Gifts. Через StarsPaymee Business вы получаете ключ и подключаете его к боту или сайту.
Сколько занимает получение API?
После регистрации и подтверждения заявки API‑ключи выдаются очень быстро, и интеграцию можно начать сразу.
Сколько стоит API?
StarsPaymee Business API предлагается по одной из самых низких цен на рынке. Для реселлеров и крупных клиентов есть особые тарифы.
Что можно продавать через API?
Telegram Stars, Telegram Premium, Telegram Gifts, а также оплату через Click и SBP (рубли).
API в формате JSON?
Да. REST API работает в JSON — и запрос, и ответ в JSON.
Есть ли webhook?
Да. При смене статуса заказа (например delivered) на ваш сервер приходит уведомление.
Есть ли Sandbox?
Да. В тестовой среде можно полностью проверить интеграцию без реальных денег.
Есть ли rate limit?
Да. Есть разумные лимиты на число запросов; для крупных клиентов лимит повышается.
Есть ли White Label?
Да. Можно построить платформу под своим брендом, на бэкенде работает StarsPaymee API.
Можно ли стать реселлером?
Да. Вы задаёте свою цену и перепродаёте; расчёты и доставка автоматизированы на стороне API.
Поддержка работает 24/7?
Да. По вопросам интеграции и эксплуатации есть поддержка — @StarsPaymeeSupport.
Как защищается API‑ключ?
Ключ должен храниться только на сервере; каждый запрос аутентифицируется токеном. Не размещайте ключ в браузере клиента.
Как доставляются Stars?
Напрямую на @username из заказа, в среднем за 10 секунд, без пароля и SMS.
Premium тоже через API?
Да. Premium можно продавать по username (3/6/12 мес) или через логин по API.
Gifts отправляются через API?
Да. Выбираете подарок из каталога и создаёте заказ с username получателя.
Что если заказ не выполнен?
При невозможности доставки по техпричине заказ переходит в failed и возвращается согласно политике расчётов.
Я сам принимаю оплату?
Да, вы принимаете оплату в своём канале (Click, Payme, карта), затем доставляете через API. Интеграции SBP/Click тоже доступны.
Цены обновляются через API?
Да. Через GET /products вы получаете актуальные цены и пакеты в реальном времени.
Можно ли слать на несколько @username?
Да. В каждом заказе указывается нужный username; можно отправлять много заказов подряд.
Дают ли документацию?
Да. После подключения выдаётся документация с эндпоинтами, примерами и форматом webhook.
Какой язык программирования нужен?
Любой — PHP, Python, Node.js, Go и другие. Подходит любая среда, умеющая слать HTTP‑запросы.
Какой минимальный заказ?
Минимум зависит от товара; например для Stars наименьший пакет начинается от 50 звёзд.
Нужно ли пополнять баланс заранее?
Часто используется модель депозита реселлера; условия зависят от тарифа и согласуются с Business.
Есть ли статистика API?
Да. История заказов и статусы доступны через запрос или в панели.
Нужна ли зарубежная карта?
Нет. В Узбекистане работает с локальными картами и Click/Payme в сумах; для рублей есть интеграция SBP.
Сложная ли интеграция?
Нет. Обычно достаточно нескольких эндпоинтов (products, orders, status) и одного webhook; с примерами подключение быстрое.
Как начать?
Оставьте заявку на странице StarsPaymee Business, получите ключ и документацию, протестируйте в Sandbox и переходите в прод.

Начнёте подключение API?

Получите API‑ключ через StarsPaymee Business — Stars, Premium, Gifts, Click и SBP в одном месте.

Открыть бот