開發者 · API v1

商戶及機器人專用Steam充值API

直接從您的商店、Telegram機器人或CRM系統通過Steam登錄名進行充值。一個POST請求即可從您的美元餘額下單；回應包含訂單編號和價格，狀態可通過GET查詢。價格與網站相同，每個Steam錢包美元0.8843美元。

請求

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	密鑰	美元餘額
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	餘額不足（尚欠 = 缺少美元）	否
429	rate_limited	每分鐘超過 300 次請求	否
503	network	目前無法發送充值，請稍後再試	否

適合對象

遊戲商店及 Telegram 機械人

在您的商店或機械人中銷售 Steam 充值服務，以您的方式收款，並透過 API 將款項存入客戶的 Steam 登入帳戶。

轉售商

從美元餘額購買並以您的利潤轉售。價格端點可讓您在訂單前查詢任何金額的成本。

客戶關係管理及自動化

將 Steam 錢包獎勵加入忠誠計劃、比賽及贈品活動：每位得獎者只需一個 HTTP 呼叫。

遊戲會所及社群

從單一餘額為會員帳戶注資，並按登入名稱清晰記錄每筆訂單。