Telegram Stars API：Python 快速上手

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 请退避重试。
• 用 USD 余额付款时请加上 "currency": "USD" 和 max_usd。