Telegram Stars API: Node.js quickstart

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());

• Generate the Idempotency-Key once per business order and persist it.
• Use currency: "USD" and max_usd to pay from the USD balance.