iGaming API Documentation & Integrations

Developers

API Documentation

RESTful API, WebSocket notifications and sandbox testing environment.

RESTful API

User management, game sessions, deposits and withdrawals. All endpoints use JSON.

WebSocket

Real-time notifications for balance updates and game results.

Sandbox Environment

Secure development with test data. Test the entire flow before going live.

Endpoint Examples

POST/api/v1/usersCreate new user

GET/api/v1/users/{id}User information

PUT/api/v1/users/{id}/balanceUpdate balance

POST/api/v1/users/{id}/sessionStart 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();

Game Endpoints

GET/api/v1/gamesList all games

GET/api/v1/games/{id}Game detail

POST/api/v1/games/{id}/launchStart game session

GET/api/v1/providersList 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();

Payment Endpoints

POST/api/v1/payments/depositDeposit

POST/api/v1/payments/withdrawWithdrawal

GET/api/v1/payments/{id}/statusTransaction status

GET/api/v1/payments/methodsList 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 Notifications

EVTbalance.updateBalance change

EVTgame.resultGame result

EVTpayment.completedPayment completed

EVTuser.sessionSession state

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);
};

Get API Key →

Details

Error Codes & Best Practices

The most common scenarios and recommended solution steps during integration.

Code	Meaning	Recommendation
AUTH_401	Unauthorized request / invalid key	Check API key and IP whitelist
RATE_429	Rate limit exceeded	Retry with backoff and use batch requests
WALLET_409	Operation repeated / idempotency conflict	Transaction ID must be unique
SESSION_410	Session expired	Create a new session and reopen the game
PROV_503	Provider is temporarily unavailable	Show fallback provider/game stream
CONFIG_422	Incomplete/incompatible configuration	Check merchant/provider settings
TIMEOUT_504	Upstream timeout	Implement retry/backoff, verify with status endpoint

Idempotency

The same transaction is not applied twice in payment and wallet endpoints. Transaction ID strategy is critical.

Security

Access management with HTTPS mandatory, key rotation and least privilege principle.

Webhook

Use verification signature for payment and game events, set retry and timeout policy.

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

FAQ

Developer FAQ

Quick answers about the sandbox, API keys and integration workflow.

Works with sandbox test data and has no financial impact. Real payment and provider flows are deployed in the live environment.

Signature header and payload hash are matched. In case of incorrect signature, the request is rejected and logged.

Implement retry with exponential backoff. If possible, manage catalog/report requests via batch or cache.

A session can end when its TTL expires, the user logs out or the provider times out. Create a new session and redirect the user to the game.

Take Action →

Go live with Softagon

Manage infrastructure, integration and back-office management for casino and sportsbook operations in a single panel.

Explore the API Get a Quote