開發者 · 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	餘額低於價格（需要 = 缺少的 USD）	否
429	rate_limited	每分鐘超過 300 次請求	否
503	network	目前無法完成儲值，請稍後再試	否

適用對象

遊戲商店與 Telegram 機器人

在您的商店或機器人中銷售 Steam 儲值服務，以您的方式收款並透過 API 將金額存入客戶的 Steam 帳號。

經銷商

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

CRM 與自動化

將 Steam 錢包儲值作為獎勵整合至忠誠計畫、賽事與贈品活動：每位得獎者僅需一次 HTTP 呼叫。

遊戲社群與俱樂部

從單一餘額為成員帳號儲值，並按登入名稱清晰記錄每筆訂單。