Telegram Stars API
Продавайте Telegram Stars и Premium в своём боте, магазине или приложении. Один HTTPS API и общий баланс с ботом и сайтом StarKerak.
Что умеет 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.
