Documentación de API e integraciones iGaming

Desarrolladores

Documentación API

API RESTful, notificaciones WebSocket y entorno de prueba sandbox.

RESTful API

Gestión de usuarios, sesiones de juego, depósitos y retiros. Todos los endpoints usan JSON.

WebSocket

Notificaciones en tiempo real sobre cambios de saldo y resultados de juegos.

Entorno de pruebas

Desarrollo seguro con datos de prueba. Pruebe todo el flujo antes de activarlo.

Ejemplos de endpoints

POST/api/v1/usersCrear nuevo usuario

GET/api/v1/users/{id}Información del usuario

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

POST/api/v1/users/{id}/sessionIniciar sesión

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

Puntos finales del juego

GET/api/v1/gamesListar todos los juegos

GET/api/v1/games/{id}Detalle del juego

POST/api/v1/games/{id}/launchIniciar sesión de juego

GET/api/v1/providersListar proveedores

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

Puntos finales de pago

POST/api/v1/payments/depositDepósito

POST/api/v1/payments/withdrawRetiro

GET/api/v1/payments/{id}/statusEstado de la transacción

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

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

Notificaciones de WebSocket

EVTbalance.updateCambio de saldo

EVTgame.resultResultado del juego

EVTpayment.completedPago completado

EVTuser.sessionEstado de la sesión

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

Obtener clave API →

Detalle

Códigos de error y mejores prácticas

Los escenarios más comunes y los pasos de solución recomendados durante la integración.

Código	Significado	Recomendación
AUTH_401	Solicitud no autorizada/clave no válida	Verificar clave API y lista blanca de IP
RATE_429	Límite de solicitudes excedido	Reintenta con espera progresiva y usa solicitudes por lotes
WALLET_409	Operación repetida / conflicto de idempotencia	El ID de la transacción debe ser único
SESSION_410	La sesión expiró	Crea una nueva sesión y vuelve a abrir el juego
PROV_503	El proveedor no está disponible temporalmente	Mostrar proveedor alternativo/transmisión de juegos
CONFIG_422	Configuración incompleta/incompatible	Verificar la configuración del comerciante/proveedor
TIMEOUT_504	Tiempo de espera del servicio externo agotado	Reintenta con espera progresiva y verifica el resultado con el endpoint de estado

Idempotencia

La misma transacción no se aplica dos veces en los puntos finales de pago y billetera. La estrategia de identificación de transacciones es fundamental.

Seguridad

Gestión de acceso con HTTPS obligatorio, rotación de claves y principio de privilegio mínimo.

Webhook

Usar firma de verificación para pagos y eventos de juegos, establecer políticas de reintento y tiempo de espera.

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

Preguntas frecuentes

Preguntas frecuentes para desarrolladores

Respuestas breves sobre el entorno de pruebas, las claves API y el proceso de integración.

Funciona con datos de prueba de sandbox y no tiene impacto financiero. Los flujos reales de pagos y proveedores se implementan en el entorno en vivo.

El encabezado de firma y el hash de carga útil coinciden. En caso de firma incorrecta, la solicitud se rechaza y se registra.

Implementar reintento con retroceso exponencial. Si es posible, administre las solicitudes de catálogo/informe por lotes o caché.

La sesión puede terminar al caducar su TTL, cerrar sesión el usuario o agotarse el tiempo de espera del proveedor. Crea una nueva sesión y redirige al usuario al juego.

Tomar acción →

Lanzamiento en vivo con Softagon

Administre la infraestructura, la integración y la gestión administrativa para las operaciones de casinos y apuestas deportivas en un solo panel.

Explorar la API Solicitar presupuesto