★ Для розробників

Telegram Stars API

Продавайте Telegram Stars і Premium у власному боті, магазині чи застосунку. Один HTTPS API, один баланс, спільний із ботом StarKerak і сайтом.

Автоматична доставкабільшість замовлень за хвилини
Перевірка імені користувачаперед оплатою
Відкриті ціниоднакові на сайті та в API
Публічний реєстркожне замовлення отримує TxId

Що вміє API

  • POST /api/v1/check-username — перевірка отримувача та отримання короткочасного токена верифікації
  • 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, тож повторні спроби ніколи не списують кошти двічі. Перевірка отримувача не дає оплатити неіснуючі імена користувачів. Ліміт — 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 Stars); ключ ідемпотентності робить повторні спроби безпечними.

Які мови підтримуються?

Будь-яка мова з HTTPS. Дивіться швидкі старти для Python, Node.js і PHP.

Чи мають ключі API термін дії?

Ні. Ключі дійсні, доки ви не відкличете їх у панелі.

Чи можна платити в USD?

Так — поповніть баланс USD через USDT (TON, BEP20 або TRC20) і передайте currency=USD.

Готові замовити?

Увійдіть через Telegram — ваш баланс StarKerak працює на сайті, у WebApp і через API.