★ API

Telegram Stars API: شروع سریع Node.js

Node 18+ به‌صورت داخلی fetch دارد — بسته اضافی لازم نیست.

تحویل خودکاربیشتر سفارش‌ها در چند دقیقه
بررسی نام کاربریپیش از پرداخت
قیمت‌های عمومییکسان در سایت و 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 Stars) استفاده کنید؛ کلید تکرارپذیری تلاش‌های دوباره را امن می‌کند.

کدام زبان‌ها پشتیبانی می‌شوند؟

هر زبانی با HTTPS. راهنمای سریع Python، Node.js و PHP را ببینید.

آیا کلیدهای API منقضی می‌شوند؟

نه. کلیدها تا وقتی در داشبورد لغوشان نکنید معتبر می‌مانند.

آیا می‌توانم با USD پرداخت کنم؟

بله — موجودی USD را با USDT (TON، BEP20 یا TRC20) شارژ کنید و currency=USD بفرستید.

آماده سفارش هستید؟

ورود با Telegram — موجودی StarKerak شما در سایت، در WebApp و از طریق API کار می‌کند.