Documentação de API e integrações iGaming

Desenvolvedores

Documentação API

API RESTful, notificações WebSocket e ambiente de teste sandbox.

RESTful API

Gerenciamento de usuários, sessões de jogos, depósitos e saques. Todos os terminais usam JSON.

WebSocket

Notificações em tempo real para atualizações de saldo e resultados de jogos.

Ambiente sandbox

Desenvolvimento seguro com dados de teste. Teste todo o fluxo antes de ir ao ar.

Exemplos de endpoints

POST/api/v1/usersCriar novo usuário

GET/api/v1/users/{id}Informações do usuário

PUT/api/v1/users/{id}/balanceAtualizar saldo

POST/api/v1/users/{id}/sessionIniciar sessão

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

Terminais de jogo

GET/api/v1/gamesListar todos os jogos

GET/api/v1/games/{id}Detalhe do jogo

POST/api/v1/games/{id}/launchIniciar sessão de jogo

GET/api/v1/providersListar provedores

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

Pontos finais de pagamento

POST/api/v1/payments/depositDepósito

POST/api/v1/payments/withdrawRetirada

GET/api/v1/payments/{id}/statusStatus da transação

GET/api/v1/payments/methodsListar métodos

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

Notificações WebSocket

EVTbalance.updateAlteração de saldo

EVTgame.resultResultado do jogo

EVTpayment.completedPagamento concluído

EVTuser.sessionEstado da sessão

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

Obter chave de API →

Detalhes

Códigos de erro e práticas recomendadas

Os cenários mais comuns e etapas de solução recomendadas durante a integração.

Código	Significado	Recomendação
AUTH_401	Solicitação não autorizada/chave inválida	Verifique a chave API e a lista de permissões de IP
RATE_429	Limite de taxa excedido	Tentar novamente com espera e usar solicitações em lote
WALLET_409	Operação repetida/conflito de idempotência	O ID da transação deve ser exclusivo
SESSION_410	Sessão expirada	Crie uma nova sessão e reabra o jogo
PROV_503	O provedor está temporariamente indisponível	Mostrar provedor substituto/transmissão de jogo
CONFIG_422	Configuração incompleta/incompatível	Verifique as configurações do comerciante/provedor
TIMEOUT_504	Tempo limite de upstream	Implementar nova tentativa/retirada, verificar com endpoint de status

Idempotência

A mesma transação não é aplicada duas vezes em endpoints de pagamento e carteira. A estratégia de ID de transação é crítica.

Segurança

Gerenciamento de acesso com HTTPS obrigatório, rotação de chaves e princípio de menor privilégio.

Webhook

Use assinatura de verificação para pagamentos e eventos de jogos, defina políticas de repetição e tempo limite.

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

Perguntas frequentes do desenvolvedor

Respostas rápidas sobre sandbox, chaves de API e fluxo de trabalho de integração.

Funciona com dados de teste de sandbox e não tem impacto financeiro. Os fluxos reais de pagamentos e provedores são implantados no ambiente ao vivo.

O cabeçalho da assinatura e o hash de carga útil são correspondidos. Em caso de assinatura incorreta, a solicitação é rejeitada e registrada.

Implementar nova tentativa com espera exponencial. Se possível, gerencie solicitações de catálogo/relatório por meio de lote ou cache.

Uma sessão pode terminar quando seu TTL expirar, o usuário efetuar logout ou o provedor atingir o tempo limite. Crie uma nova sessão e redirecione o usuário para o jogo.

Tome uma atitude →

Transmita ao vivo com Softagon

Gerencie infraestrutura, integração e gerenciamento de back-office para operações de cassino e apostas esportivas em um único painel.

Explore a API Obtenha uma cotação