★ Для разработчиков

Telegram Stars API

Продавайте Telegram Stars и Premium в своём боте, магазине или приложении. Один HTTPS API и общий баланс с ботом и сайтом StarKerak.

Автоматическая доставкабольшинство заказов за минуты
Проверка usernameдо оплаты
Открытые ценыодинаковые на сайте и в API
Публичный реестру каждого заказа есть TxId

Что умеет API

  • POST /api/v1/check-username — проверить получателя и получить короткоживущий verification token
  • POST /api/v1/stars/buy и /api/v1/premium/buy — создать заказ (обязателен Idempotency-Key)
  • GET /api/v1/order/{id} и /api/v1/orders — статусы и история
  • GET /api/v1/prices, /api/v1/account, USD-кошелёк и USDT-инвойсы

Аутентификация — заголовок X-API-Key. Ключи создаются в кабинете и действуют, пока вы их не отзовёте.

Готов к продакшену

Каждый заказ идёт с вашим Idempotency-Key, поэтому повторы никогда не спишут деньги дважды. Проверка получателя защищает от оплаты на несуществующий username. Лимит — 10 запросов в секунду на ключ.

Все заказы оплачиваются с USD-баланса (currency=USD; UZS считается USD). Передавайте max_usd, чтобы ограничить цену.

Прозрачность

Каждый выполненный заказ получает TxId в публичном реестре PayStars — вы и ваши клиенты можете независимо проверить доставку.

Цена Fragment, 0% (через сайт 5%)

Заказы по API-ключу с USD-баланса считаются по текущей цене Fragment 0% (через сайт 5%). Узнайте цену через POST /usd/quote и ограничьте её через max_usd. Подробнее — на странице Fragment API.

Частые вопросы

Есть ли песочница?

Во время интеграции используйте небольшие реальные заказы (50 звёзд); ключ идемпотентности делает повторы безопасными.

Какие языки поддерживаются?

Любой язык с HTTPS. Смотрите примеры для Python, Node.js и PHP.

Истекают ли API-ключи?

Нет. Ключ действует, пока вы не отзовёте его в кабинете.

Можно платить в долларах?

Да — пополните USD-баланс через USDT (TON, BEP20 или TRC20) и передавайте currency=USD.

Готовы оформить заказ?

Войдите через Telegram — баланс StarKerak работает на сайте, в WebApp и через API.