★ API

텔레그램 스타 API: Python 빠른 시작

requests 라이브러리로 만드는 최소한의, 운영에 안전한 흐름.

자동 전송대부분 몇 분 안에 완료
유저네임 확인결제 전에 확인
투명한 가격사이트·봇·API 동일
공개 원장모든 주문에 TxId 발급
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를 추가하세요.

자주 묻는 질문

샌드박스가 있나요?

연동 중에는 소액 실주문(50 스타)을 이용하세요. Idempotency-Key 덕분에 재시도가 안전합니다.

어떤 언어를 지원하나요?

HTTPS를 쓸 수 있는 모든 언어. Python, Node.js, PHP 빠른 시작을 참고하세요.

API 키가 만료되나요?

아니요. 대시보드에서 폐기하기 전까지 유효합니다.

USD로 결제할 수 있나요?

네. USD 잔액을 USDT(TON 또는 BEP20)로 충전하고 currency=USD를 보내세요.

지금 주문하시겠어요?

텔레그램으로 로그인하세요. StarKerak 잔액은 사이트, WebApp, API에서 모두 사용할 수 있습니다.