Главная / Telegram Stars API
Telegram Stars API

Отправляйте Telegram Stars одним запросом

Отправляйте Stars любому пользователю Telegram из своего бота, магазина или Mini App. Покупка выполняется через Fragment, оплата списывается с TON-кошелька, подключённого к кассе.

Как это работает

  • Создайте кассу в панели — она получит отдельный API-ключ.
  • Подключите к кассе TON-кошелёк: создайте новый или подключите свой по seed-фразе из 12/24 слов.
  • Отправьте username и amount на POST /stars/buy — Stars придут пользователю, в ответе будет order_id.

Порядок интеграции

  1. Проверьте ценуPOST /stars/pricing
  2. Проверьте usernamePOST /searchUser
  3. КупитеPOST /stars/buy
  4. Следите за статусомGET /order/{order_id}

Пример запроса

curl -X POST https://starsapi.uz/stars/buy \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username": "durov", "amount": 100}'

Ответ:

{
  "success": true,
  "data": {
    "transaction_id": "78f6a...",
    "order_id": "K7Q2MX"
  }
}

Параметры

ПолеТипОписание
X-API-KeyheaderAPI-ключ кассы. Обязательно.
usernamestringUsername получателя в Telegram (с @ или без). Обязательно.
amountintegerКоличество Stars: от 50 до 100 000. Обязательно.
currencystrington или usdt. Если не указано — из настроек кассы.
Idempotency-KeyheaderНеобязательно. Не обязателен: если одинаковый заказ придёт подряд, сервер сам отсечёт повтор. С ключом защита действует 30 дней.
waitbooleanНеобязательно. По умолчанию success приходит, как только платёж ушёл в сеть (~1 с). true — ждать подтверждения в блокчейне (~3 с).

Цена

Цена берётся из текущего курса Stars на Fragment, сверху добавляется комиссия 1.5%. Если ваш аккаунт за последние 7 дней продал 100 000+ Stars, комиссия автоматически снижается до 1%. Первые 20 заказов в каждом аккаунте без комиссии, за неудачный заказ комиссия не берётся. Точную цену возвращает POST /stars/pricing.

Другие эндпоинты

ЭндпоинтНазначение
POST /stars/pricingТекущая цена для указанного количества
POST /searchUserПроверка username до покупки
GET /order/{order_id}Итоговый статус заказа
POST /premium/buyПодарить Telegram Premium

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

Какой минимум и максимум?

В одном заказе можно отправить от 50 до 100 000 Stars.

С какого кошелька списываются деньги?

С TON-кошелька, подключённого к кассе, — в Gram (TON) или USDT. Газ сети всегда оплачивается в TON, поэтому держите на кошельке небольшой запас TON.

Что делать, если запрос остался без ответа?

Отправьте снова. Если одинаковый заказ придёт подряд, сервер сам отсечёт повтор и вернёт ответ первого заказа (duplicate: true). Статус также можно проверить через GET /order/{order_id}.

До первого заказа — несколько минут

Регистрация и API-ключ бесплатны. Первые 20 заказов в каждом аккаунте без комиссии.

Начать бесплатно