★ API

Telegram Stars API: пример на Python

Минимальный и безопасный для продакшена сценарий с библиотекой requests.

Автоматическая доставкабольшинство заказов за минуты
Проверка usernameдо оплаты
Открытые ценыодинаковые на сайте, в боте и API
Публичный реестру каждого заказа есть TxId
import os, uuid, requests

API = "https://paystars.uz/api/v1"
H = {"X-API-Key": os.environ["PAYSTARS_API_KEY"]}

chk = requests.post(f"{API}/check-username", headers=H,
                    json={"username": "durov", "kind": "stars"}).json()
order = requests.post(f"{API}/stars/buy",
                      headers={**H, "Idempotency-Key": str(uuid.uuid4())},
                      json={"username": "durov", "quantity": 50,
                            "verification_token": chk["verification_token"]}).json()
print(requests.get(f"{API}/order/{order['order_id']}", headers=H).json())
  • Храните Idempotency-Key вместе со своим заказом и повторяйте его при ретраях — API никогда не спишет дважды.
  • Соблюдайте лимит 3 запроса/сек на ключ; при HTTP 429 делайте паузу.

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

Есть ли песочница?

Во время интеграции используйте небольшие реальные заказы (50 звёзд); ключ идемпотентности делает повторы безопасными.

Какие языки поддерживаются?

Любой язык с HTTPS. Смотрите примеры для Python, Node.js и PHP.

Истекают ли API-ключи?

Нет. Ключ действует, пока вы не отзовёте его в кабинете.

Можно платить в долларах?

Да — пополните USD-баланс через USDT (TON или BEP20) и передавайте currency=USD.

Готовы оформить заказ?

Войдите через Telegram — баланс StarKerak работает на сайте, в WebApp и через API.