Как это работает
- Создайте кассу в панели — она получит отдельный API-ключ.
- Подключите к кассе TON-кошелёк: создайте новый или подключите свой по seed-фразе из 12/24 слов.
- Отправьте
usernameиamountнаPOST /stars/buy— Stars придут пользователю, в ответе будетorder_id.
Порядок интеграции
- Проверьте цену
POST /stars/pricing - Проверьте username
POST /searchUser - Купите
POST /stars/buy - Следите за статусом
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-Key | header | API-ключ кассы. Обязательно. |
username | string | Username получателя в Telegram (с @ или без). Обязательно. |
amount | integer | Количество Stars: от 50 до 100 000. Обязательно. |
currency | string | ton или usdt. Если не указано — из настроек кассы. |
Idempotency-Key | header | Необязательно. Не обязателен: если одинаковый заказ придёт подряд, сервер сам отсечёт повтор. С ключом защита действует 30 дней. |
wait | boolean | Необязательно. По умолчанию 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 заказов в каждом аккаунте без комиссии.