Nhà phát triển · API v1

API nạp tiền Steam cho cửa hàng và bot

Nạp tiền vào ví Steam bằng tên đăng nhập trực tiếp từ cửa hàng, bot Telegram hoặc CRM của bạn. Một yêu cầu POST đặt đơn hàng từ số dư USD của bạn; câu trả lời mang mã đơn hàng và giá cả, và trạng thái được theo dõi bằng GET. Giá cả giống như trên trang web, $0.8843 mỗi đô la ví.

Đọc hướng dẫn nhanh Nhận khóa API

Yêu cầu

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"
  }
}

Một POST đặt đơn hàng

Khóa Bearer từ tài khoản của bạn

Điểm cuối giá miễn phí, không cần khóa

Trạng thái theo mã đơn hàng

Hướng dẫn nhanh

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"}'

Một đơn hàng mới trả lời trạng thái đang xử lý. Đọc GET /api/v1/orders/{id} cho đến khi nó hiển thị 'done', hoặc 'refunded' nếu không thể giao hàng (giá cả sau đó sẽ được trả lại vào số dư của bạn). GET /api/v1/price trả về giá chính xác trước khi tính phí. Giới hạn: 300 yêu cầu mỗi phút mỗi khóa; số tiền từ $0.65 đến $850 mỗi đơn hàng.

Điểm cuối

Phương thức	Đường dẫn	Xác thực	Chức năng
GET	/api/v1/price?amount=20	Không cần khóa	Giá và ước tính KZT/UAH cho một số tiền
GET	/api/v1/regions	Không cần khóa	Các quốc gia được hỗ trợ và đơn vị tiền tệ ví
GET	/api/v1/balance	Khóa	Số dư USD
POST	/api/v1/orders	Khóa	Đặt nạp tiền: tên đăng nhập và số tiền
GET	/api/v1/orders/{id}	Khóa	Trạng thái của một đơn hàng
GET	/api/v1/orders	Khóa	100 đơn hàng gần đây nhất của bạn

Lỗi

HTTP	error	Ý nghĩa	Số dư bị trừ
400	bad_login	Định dạng tên đăng nhập không phải là tên đăng nhập Steam	Không
400	bad_amount	Số tiền nằm ngoài khoảng $0.65 đến $850	Không
401	unauthorized	Thiếu hoặc sai khóa API	Không
402	funds	Số dư không đủ để thanh toán (cần = số USD còn thiếu)	Không
429	rate_limited	Hơn 300 yêu cầu mỗi phút	Không
503	network	Hiện không thể gửi nạp tiền, vui lòng thử lại sau	Không

Dành cho ai

Cửa hàng game và bot Telegram

Bán dịch vụ nạp tiền Steam trong cửa hàng hoặc bot của bạn, nhận thanh toán theo cách riêng và để API giao tiền đến tài khoản Steam của khách hàng.

Đại lý bán lại

Mua từ số dư USD và bán lại với mức chênh lệch của bạn. API báo giá cho biết chi phí của bất kỳ số tiền nào trước khi đặt hàng.

CRM và tự động hóa

Thêm phần thưởng ví Steam vào chương trình khách hàng thân thiết, giải đấu và minigame: chỉ cần một lệnh HTTP cho mỗi người thắng cuộc.

Câu lạc bộ và cộng đồng game

Nạp tiền cho thành viên từ một số dư chung với lịch sử đơn hàng rõ ràng theo từng tài khoản.