Telegram Stars API
Продавайте Telegram Stars і Premium у власному боті, магазині чи застосунку. Один HTTPS API, один баланс, спільний із ботом StarKerak і сайтом.
Що вміє 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.
Related pages
Готові замовити?
Увійдіть через Telegram — ваш баланс StarKerak працює на сайті, у WebApp і через API.
