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

Дарите Telegram Premium через API

Автоматически отправляйте пользователю Telegram Premium на 3, 6 или 12 месяцев. Тот же ключ, тот же формат ответа и тот же кошелёк, что и для Stars.

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

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

Ответ:

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

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

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

Параметры

ПолеТипОписание
X-API-KeyheaderAPI-ключ кассы. Обязательно.
usernamestringUsername получателя. Обязательно.
monthsintegerСрок: 3, 6 или 12. Обязательно.
currencystrington или usdt. Если не указано — из настроек кассы.
Idempotency-KeyheaderНеобязательно. Не обязателен: если одинаковый заказ придёт подряд, сервер сам отсечёт повтор. С ключом защита действует 30 дней.

Цена

Цена Premium берётся с Fragment, сверху добавляется комиссия 1.5% (1% для аккаунтов с продажами 100 000+ Stars в неделю). Первые 20 заказов в каждом аккаунте бесплатны. Текущую цену возвращает POST /premium/pricing.

Где используется

  • Каталог Premium и автоматическая доставка в Telegram-ботах.
  • Premium как новый товар в интернет-магазинах.
  • Награда в акциях и программах лояльности.

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

Можно купить Premium другому человеку?

Да, Premium отправляется подарком на любой username.

А если у пользователя уже есть Premium?

Fragment может не разрешить покупку — API вернёт понятный код ошибки, комиссия не берётся.

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

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

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