Документация API и интеграции iGaming

Разработчики

Документация по API

RESTful API, уведомления WebSocket и среда тестирования в песочнице.

RESTful API

Управление пользователями, игровые сессии, пополнение и вывод средств. Все методы API используют JSON.

WebSocket

Уведомления об изменении баланса и результатах игр в реальном времени.

Тестовая среда

Безопасная разработка с использованием тестовых данных. Протестируйте весь поток перед запуском в эксплуатацию.

Примеры запросов API

POST/api/v1/usersСоздать нового пользователя

GET/api/v1/users/{id}Информация о пользователе

PUT/api/v1/users/{id}/balanceОбновление баланса

POST/api/v1/users/{id}/sessionНачать сеанс

const res = await fetch(
  'https://api.softagon.net/v1/users',
  {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      username: 'player123',
      currency: 'EUR',
      country: 'DE'
    })
  }
);
const user = await res.json();

Конечные точки игры

GET/api/v1/gamesСписок всех игр

GET/api/v1/games/{id}Детали игры

POST/api/v1/games/{id}/launchНачать игровую сессию

GET/api/v1/providersСписок поставщиков

const res = await fetch(
  'https://api.softagon.net/v1/games/12345/launch',
  {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      user_id: 'usr_abc123',
      currency: 'EUR'
    })
  }
);
const { game_url } = await res.json();

Конечные точки оплаты

POST/api/v1/payments/depositДепозит

POST/api/v1/payments/withdrawВывод

GET/api/v1/payments/{id}/statusСтатус транзакции

GET/api/v1/payments/methodsСписок способов оплаты

const res = await fetch(
  'https://api.softagon.net/v1/payments/deposit',
  {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      user_id: 'usr_abc123',
      amount: 100.00,
      currency: 'EUR',
      method: 'visa'
    })
  }
);
const { payment_url } = await res.json();

Уведомления WebSocket

EVTbalance.updateИзменение баланса

EVTgame.resultРезультат игры

EVTpayment.completedПлатеж завершен

EVTuser.sessionСостояние сеанса

const ws = new WebSocket(
  'wss://ws.softagon.net/v1/stream'
);

ws.onopen = () => {
  ws.send(JSON.stringify({
    type: 'auth',
    api_key: 'YOUR_KEY'
  }));
};

ws.onmessage = (e) => {
  const data = JSON.parse(e.data);
  console.log(data.type, data.payload);
};

Получить ключ API →

Подробнее

Коды ошибок и рекомендации

Наиболее распространенные сценарии и рекомендуемые шаги решения во время интеграции.

Код	Значение	Рекомендация
AUTH_401	Несанкционированный запрос/неверный ключ	Проверьте ключ API и белый список IP-адресов.
RATE_429	Превышен лимит запросов	Повторяйте запросы с задержкой и используйте пакетную обработку
WALLET_409	Повторение операции/конфликт идемпотентности	Идентификатор транзакции должен быть уникальным.
SESSION_410	Срок действия сеанса истек	Создайте новый сеанс и снова откройте игру.
PROV_503	Провайдер временно недоступен	Показать резервный поставщик/поток игры
CONFIG_422	Неполная/несовместимая конфигурация	Проверьте настройки продавца/провайдера
TIMEOUT_504	Тайм-аут внешнего сервиса	Повторите запрос с задержкой и проверьте результат через API статуса

Идемпотентность

Одна и та же транзакция не применяется дважды в конечных точках платежа и кошелька. Стратегия идентификации транзакций имеет решающее значение.

Безопасность

Управление доступом с обязательным использованием HTTPS, ротацией ключей и принципом минимальных привилегий.

Вебхук

Используйте проверочную подпись для платежей и игровых событий, установите политику повторных попыток и тайм-аута.

{
  "id": "evt_01HXYZ...",
  "type": "payment.succeeded",
  "created_at": "2026-01-01T12:34:56Z",
  "data": {
    "merchant_id": "m_123",
    "tx_id": "tx_789",
    "amount": 100.00,
    "currency": "EUR",
    "status": "succeeded"
  }
}

Вопросы и ответы

Часто задаваемые вопросы для разработчиков

Краткие ответы о тестовой среде, ключах API и процессе интеграции.

Работает с данными тестирования в песочнице и не имеет финансовых последствий. Реальные потоки платежей и поставщиков развертываются в реальной среде.

Заголовок подписи и хэш полезной нагрузки совпадают. В случае неправильной подписи запрос отклоняется и протоколируется.

Реализовать повторную попытку с экспоненциальной задержкой. Если возможно, управляйте запросами каталога/отчета с помощью пакетной обработки или кэша.

Сессия может завершиться по истечении TTL, при выходе пользователя или тайм-ауте провайдера. Создайте новую сессию и снова направьте пользователя в игру.

Примите меры →

Начните работу с Softagon

Управляйте инфраструктурой, интеграцией и бэк-офисом для операций казино и букмекерских контор с помощью одной панели.

Обзор API Получить предложение