★ API

Telegram Stars API: пример на Node.js

В Node 18+ fetch встроен — дополнительные пакеты не нужны.

Автоматическая доставкабольшинство заказов за минуты
Проверка usernameдо оплаты
Открытые ценыодинаковые на сайте, в боте и API
Публичный реестру каждого заказа есть TxId
const API = "https://paystars.uz/api/v1";
const H = { "X-API-Key": process.env.PAYSTARS_API_KEY, "Content-Type": "application/json" };

const chk = await (await fetch(`${API}/check-username`, { method: "POST", headers: H,
  body: JSON.stringify({ username: "durov", kind: "stars" }) })).json();
const order = await (await fetch(`${API}/stars/buy`, { method: "POST",
  headers: { ...H, "Idempotency-Key": crypto.randomUUID() },
  body: JSON.stringify({ username: "durov", quantity: 50, verification_token: chk.verification_token }) })).json();
console.log(await (await fetch(`${API}/order/${order.order_id}`, { headers: H })).json());
  • Генерируйте Idempotency-Key один раз на бизнес-заказ и сохраняйте его.
  • Для оплаты с USD-баланса передавайте currency: "USD" и max_usd.

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

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

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

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

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

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

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

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

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

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

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