Сценарии использования
Интернет-магазин
Покупатель выбирает сумму пополнения, оплачивает на сайте — баланс Steam зачисляется автоматически.
Призы и программы лояльности
Вознаграждение победителю турнира или бонус постоянному клиенту — без участия операторов.
Подарок другу
Отправитель вводит Steam-логин получателя и сумму — пополнение уходит адресату напрямую.
Маркетплейс внутриигровых товаров
Автовыплата продавцу после продажи скина — пополнение кошелька вместо банковского перевода.
Прямое пополнение
vs
Gift-карта
Прямое пополнение
Нет лишних шагов
Покупатель не вводит коды и не переходит на сторонние страницы.
Любая сумма
Пополнение на произвольный номинал, а не фиксированный набор.
Нет остатков ключей
Не нужно управлять складом кодов — пополнение происходит напрямую.
Gift-карта
Шаги активации
Покупатель должен самостоятельно ввести код в Steam.
Фиксированные номиналы
Только предустановленные суммы: $5, $10, $20, $50, $100.
Управление остатками
Нужно следить за наличием кодов и пополнять сток.
Как работает пополнение
Передайте Steam ID
Покупатель вводит логин или Steam ID на вашей платформе. Вы передаёте его в запросе.
Укажите сумму
Произвольная сумма и валюта — API рассчитает конвертацию в валюту региона аккаунта.
Получите подтверждение
Средства зачислены. В ответе — новый баланс кошелька и transaction_id Steam.
Основные эндпоинты
Документация
/steam/account/{steam_id}
Проверить аккаунт и регион
/steam/balance/{steam_id}
Текущий баланс кошелька
/steam/topup
Пополнить кошелёк
/steam/topup/{tx_id}
Статус транзакции
/webhooks
Регистрация Webhook-адреса
{
"steam_id": "76561198000000000",
"amount": 500,
"currency": "RUB",
"external_order_id": "your-tx-789"
}{
"tx_id": "stm_4px7r...",
"status": "completed",
"steam_transaction_id": "6831200000000000",
"wallet_balance_after": 500,
"wallet_currency": "RUB",
"completed_at": "2024-03-15T11:04:22Z"
}Технические преимущества
Прямое зачисление
Средства поступают на Steam-кошелёк без промежуточных шагов со стороны покупателя.
Автоконвертация валют
Указываете сумму в любой валюте — API конвертирует в валюту Steam-региона аккаунта.
Идемпотентность
Передайте external_tx_id — повторный запрос не создаст дублирующего пополнения.
Webhook-уведомления
События topup.completed и topup.failed приходят в реальном времени.
Частые вопросы
Как проверить Steam-аккаунт перед пополнением?
GET /steam/account/{steam_id} вернёт никнейм, регион, валюту кошелька и флаг is_valid. Рекомендуем делать этот запрос перед созданием оплаты на вашей стороне.
Что происходит, если пополнение не прошло?
Транзакция переходит в статус failed, средства не списываются. Webhook topup.failed приходит с кодом причины (invalid_account, region_restricted, service_unavailable).
Какая минимальная и максимальная сумма пополнения?
Минимум — эквивалент 1 USD в валюте региона. Максимум за одну транзакцию — эквивалент 500 USD. Лимит на сутки настраивается в личном кабинете.
Поддерживается ли пополнение аккаунтов с ограничениями Steam?
Аккаунты с ограниченным кошельком (Limited account) не поддерживаются. GET /steam/account вернёт флаг is_limited — используйте его для валидации до оплаты.