XaocSteam API

Подключите пополнение Steam за вечер

Проверяйте логин, создавайте заказы и получайте финальный статус через простой JSON API. Ниже — готовые примеры, которые можно сразу адаптировать под ваш проект.

Base URLhttps://xaocsteam.shop/api/v1

1Получите ключВ кабинете партнёра

2Проверьте логинДо создания заказа

3Создайте заказПередайте логин и сумму

4Получите статусЧерез webhook

Авторизация

Добавляйте ключ в заголовок X-API-Key каждого запроса. Храните его только на сервере — не вставляйте в браузерный JavaScript или мобильное приложение.

X-API-Key: xs_live_your_key

Безопасное хранениеИспользуйте переменную окружения XAOCSTEAM_API_KEY.

POST/check-login2 req/min

Проверить Steam-логин

Вызывайте этот метод до создания заказа. Он проверяет формат логина и доступность пополнения у поставщика.

steam_loginstring · requiredЛогин Steam: 3–64 символа, латиница, цифры, _, - или .

curl -X POST "https://xaocsteam.shop/api/v1/check-login" \
+  -H "X-API-Key: xs_live_your_key" \
+  -H "Content-Type: application/json" \
+  -d '{"steam_login":"mylogin"}'

{
  "ok": true,
  "steam_login": "mylogin",
  "valid": true,
  "status_message": "Steam account validated"
}

POST/orders10 req/min

Создать заказ

Создаёт пополнение кошелька Steam. Сначала метод вернёт processing, а финальный результат придёт через webhook.

steam_loginstring · requiredПроверенный логин Steam

amountnumber · requiredСумма от 100 до 15 000 ₽

currencystringRUB

curl -X POST "https://xaocsteam.shop/api/v1/orders" \
+  -H "X-API-Key: xs_live_your_key" \
+  -H "Content-Type: application/json" \
+  -d '{
    "steam_login": "mylogin",
    "amount": 500,
    "currency": "RUB"
  }'

Успешный ответ

{
  "ok": true,
  "order_id": "XS-A31F94D120B7",
  "status": "processing",
  "steam_login": "mylogin",
  "amount": 500,
  "currency": "RUB",
  "created_at": "2026-08-31T10:00:00.000Z"
}

GET/orders/:id60 req/min

Проверить статус заказа

Возвращает сохранённый заказ и при необходимости обновляет его состояние у поставщика.

curl "https://xaocsteam.shop/api/v1/orders/XS-A31F94D120B7" \
+  -H "X-API-Key: xs_live_your_key"

processingЗаказ выполняется

deliveredСредства зачислены

failedЗаказ завершился ошибкой

Важно про completedXaocSteam не считает completed финалом пополнения. Успешное зачисление кошелька фиксируется только как delivered.

Webhooks

XaocSteam отправит POST-запрос на ваш HTTPS-адрес при смене статуса. Ответьте кодом 2xx. Повторные события безопасно определяются по event_id.

{
  "event_id": "evt_01J8QY...",
  "type": "order.status_changed",
  "created_at": "2026-08-31T10:02:14.000Z",
  "data": {
    "order_id": "XS-A31F94D120B7",
    "steam_login": "mylogin",
    "status": "delivered",
    "amount": 500,
    "currency": "RUB"
  }
}

HMAC SHA-256Проверяйте подпись X-XaocSteam-Signature по сырому телу запроса.

Ошибки

400

Проверьте параметры запроса

401

Ключ отсутствует или недействителен

404

Заказ не найден

429

Слишком много запросов

503

Поставщик временно недоступен

{
  "ok": false,
  "error": "invalid_order"
}