Telegram Stars API: Python quickstart

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

• Store the Idempotency-Key with your own order and reuse it on retries — the API never charges twice.
• Respect the 3 requests/second limit per key; back off on HTTP 429.