开发者 · 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"}'

新订单初始状态为processing。持续调用GET /api/v1/orders/{id}直至返回done状态，若无法完成则会退款（金额将返还至余额）。GET /api/v1/price可在扣款前获取精确价格。限制：每个密钥每分钟300次请求；单笔订单金额0.65至850美元。

接口列表

方法	路径	鉴权	功能说明
GET	/api/v1/price?amount=20	免密钥	获取指定金额对应的价格及坚戈/格里夫纳估算值
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账号。

经销商

从美元余额采购并以自定义加价转售。价格接口可查询任意金额的预扣款成本。

CRM与自动化系统

为忠诚计划、赛事和赠礼活动添加Steam钱包奖励：每个获奖者仅需一次HTTP调用。

游戏俱乐部与社群

从统一余额为成员账号充值，每个登录名对应清晰的订单记录。