PayStars
한국어 ▾
O‘zbek Русский English 한국어 中文
시작하기
★ 개발자용

텔레그램 스타 API

자체 봇, 쇼핑몰, 앱에서 텔레그램 스타와 프리미엄을 판매하세요. 하나의 HTTPS API, StarKerak 봇·웹사이트와 공유되는 하나의 잔액.

시작하기StarKerak 봇 열기
자동 전송대부분 몇 분 안에 완료
유저네임 확인결제 전에 확인
투명한 가격사이트·봇·API 동일
공개 원장모든 주문에 TxId 발급

API 기능

  • POST /api/v1/check-username — 수신자를 확인하고 단기 verification token 발급
  • POST /api/v1/stars/buy, /api/v1/premium/buy — 주문 생성 (Idempotency-Key 필수)
  • GET /api/v1/order/{id}, /api/v1/orders — 상태와 내역
  • USD 지갑, USDT 인보이스, /api/v1/usd/quote 가격 조회

인증은 X-API-Key 헤더를 사용합니다. 키는 대시보드에서 만들며 직접 폐기하기 전까지 만료되지 않습니다.

운영 환경에 맞춘 설계

모든 주문에 Idempotency-Key가 붙어 재시도해도 이중 결제가 없습니다. 수신자 확인으로 존재하지 않는 유저네임에 결제하는 일을 막습니다. 요청 한도는 키당 초당 3회입니다.

USD 주문에는 currency=USD와 max_usd를 보내 허용 가격 상한을 정하세요.

투명성

완료된 주문마다 PayStars 공개 원장에 TxId가 기록되어, 고객과 함께 전송 여부를 독립적으로 확인할 수 있습니다.

Fragment 가격 + 5%

USD 잔액 주문은 현재 Fragment 가격에 5%를 더해 계산됩니다. POST /usd/quote로 가격을 받고 max_usd로 상한을 거세요. 자세한 내용은 Fragment API 페이지에 있습니다.

자주 묻는 질문

샌드박스가 있나요?

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

어떤 언어를 지원하나요?

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

API 키가 만료되나요?

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

USD로 결제할 수 있나요?

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

관련 페이지

텔레그램 스타·프리미엄용 Fragment API — 수수료 5%Fragment에는 스타와 프리미엄 재판매용 공개 API가 없습니다.텔레그램 스타 API: Python 빠른 시작requests 라이브러리로 만드는 최소한의, 운영에 안전한 흐름.텔레그램 스타 API: Node.js 빠른 시작Node 18+에는 fetch가 내장되어 추가 패키지가 필요 없습니다.텔레그램 스타 API: PHP 빠른 시작어떤 PHP 프로젝트나 봇에도 넣을 수 있는 간단한 cURL 헬퍼.API USD 가격달러로 스타 비즈니스를 운영하세요: USDT로 충전하는 USD 잔액, 실시간 견적, 주문별 가격 상한.Fragment 없이 텔레그램 스타 구매Fragment는 TON 지갑과 Toncoin이 필요합니다.

지금 주문하시겠어요?

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

시작하기StarKerak 봇 열기