Пример запроса
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"
}
}Порядок интеграции
- Проверьте цену
POST /premium/pricing - Проверьте username
POST /searchUser - Купите
POST /premium/buy - Следите за статусом
GET /order/{order_id}
Параметры
| Поле | Тип | Описание |
|---|---|---|
X-API-Key | header | API-ключ кассы. Обязательно. |
username | string | Username получателя. Обязательно. |
months | integer | Срок: 3, 6 или 12. Обязательно. |
currency | string | ton или usdt. Если не указано — из настроек кассы. |
Idempotency-Key | header | Необязательно. Не обязателен: если одинаковый заказ придёт подряд, сервер сам отсечёт повтор. С ключом защита действует 30 дней. |
Цена
Цена Premium берётся с Fragment, сверху добавляется комиссия 1.5% (1% для аккаунтов с продажами 100 000+ Stars в неделю). Первые 20 заказов в каждом аккаунте бесплатны. Текущую цену возвращает POST /premium/pricing.
Где используется
- Каталог Premium и автоматическая доставка в Telegram-ботах.
- Premium как новый товар в интернет-магазинах.
- Награда в акциях и программах лояльности.
Частые вопросы
Можно купить Premium другому человеку?
Да, Premium отправляется подарком на любой username.
А если у пользователя уже есть Premium?
Fragment может не разрешить покупку — API вернёт понятный код ошибки, комиссия не берётся.
До первого заказа — несколько минут
Регистрация и API-ключ бесплатны. Первые 20 заказов в каждом аккаунте без комиссии.