개발자 · API v1

상점 및 봇용 Steam 지갑 충전 API

상점, Telegram 봇 또는 CRM에서 직접 로그인으로 Steam 지갑을 충전하세요. 하나의 POST 요청으로 USD 크레딧에서 주문을 생성할 수 있으며, 응답에는 주문 코드와 가격이 포함돼요. 상태는 GET으로 확인할 수 있어요. 가격은 사이트와 동일하게 Steam 지갑 달러당 $0.8843이에요.

빠른 시작 읽기 API 키 받기

요청

POST /api/v1/orders
Authorization: Bearer stk_live_...

{
  "login": "gamer_alex2009",
  "amount": "20.00"
}

201 Created

{
  "ok": true,
  "order": {
    "id": "SO-7KQ2M9XH4C",
    "login": "gamer_alex2009",
    "amount": "20.00",
    "price": "17.69",
    "status": "processing"
  }
}

POST 하나로 주문 생성

계정의 Bearer 키

무료 가격 확인 엔드포인트, 키 불필요

주문 코드로 상태 확인

빠른 시작

curl -X POST https://steamtopup.io/api/v1/orders \
  -H "Authorization: Bearer stk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"login":"gamer_alex2009","amount":"20.00"}'

새 주문은 '처리 중' 상태로 응답해요. GET /api/v1/orders/{id}를 '완료' 또는 '환불됨'(전송 실패 시 가격이 크레딧으로 환급) 상태가 될 때까지 확인하세요. GET /api/v1/price로 실제 청구 전 정확한 가격을 확인할 수 있어요. 제한: 키당 분당 300회 요청, 주문당 $0.65~$850.

엔드포인트

메소드	경로	인증	기능
GET	/api/v1/price?amount=20	키 불필요	금액에 대한 가격 및 KZT/UAH 예상 환율
GET	/api/v1/regions	키 불필요	지원 국가 및 지갑 통화
GET	/api/v1/balance	키	USD 크레딧 잔액
POST	/api/v1/orders	키	충전 주문: 로그인 및 금액 입력
GET	/api/v1/orders/{id}	키	단일 주문 상태
GET	/api/v1/orders	키	최근 100개 주문

오류

HTTP	error	의미	크레딧 차감됨
400	bad_login	로그인 형식이 Steam 로그인 이름이 아니에요	아니요
400	bad_amount	$0.65~$850 범위를 벗어난 금액	아니요
401	unauthorized	API 키 누락 또는 오류	아니요
402	funds	크레딧이 가격보다 낮아요 (필요한 금액 = 부족한 USD)	아니요
429	rate_limited	1분당 300회 이상의 요청	아니요
503	network	지금은 충전을 보낼 수 없어요; 나중에 다시 시도해 보세요	아니요

누구를 위한 서비스인가요

게임 샵과 Telegram 봇

자신의 스토어나 봇에서 Steam 충전을 판매하고, 원하는 방식으로 결제를 받은 후 API를 통해 고객의 Steam 로그인 이름으로 전달하세요.

리셀러

USD 크레딧 잔액에서 구매하고 자신의 마진을 추가하여 재판매하세요. 가격 엔드포인트를 통해 주문 전에 어떤 금액의 비용을 알 수 있어요.

CRM 및 자동화

충성도 프로그램, 토너먼트 및 경품 행사에 Steam 지갑 보상을 추가하세요: 승자당 하나의 HTTP 호출로 가능해요.

게임 클럽 및 커뮤니티

하나의 잔액에서 멤버들의 계정을 충전하고, 각 로그인별로 명확한 주문 기록을 유지하세요.