La estructura de la API
Las peticiones desde su lado van a un único endpoint como cuerpos JSON por POST. Cada una lleva su login, su contraseña y el nombre del método que quiere ejecutar. Las respuestas vuelven en JSON. No hay URL base distintas por producto ni una segunda especificación para el casino en vivo o los deportes: una sola API de igaming cubre todo el catálogo de más de 40.000 juegos y el sportsbook.
El tráfico en sentido contrario, de nosotros hacia usted, es la seamless wallet: llamamos a su servidor cada vez que hay que leer o modificar el saldo de un jugador. Esos callbacks llegan como peticiones HTTP GET firmadas, con parámetros en la query.
Métodos que usted llama
| Función | Qué devuelve o hace |
|---|---|
| Monedas | Las monedas de jugador habilitadas para su cuenta |
| Lista de juegos | Cada título con su identificador, nombre, estudio, miniatura y tipo de juego normalizado |
| Lista de proveedores | Los estudios que su cuenta puede abrir |
| Crear jugador | Registra un jugador con una moneda fija |
| Lanzar juego | Una URL de lanzamiento con dinero real para un iframe |
| Lanzar demo | Una URL de juego por diversión, sin jugador ni wallet |
| Historial del jugador | Las rondas, apuestas y ganancias del jugador, para soporte y conciliación |
Lista de juegos
La lista de juegos es la columna vertebral de su lobby. Cada entrada tiene un identificador estable que usted guarda y devuelve sin cambios al lanzar. El campo de tipo de juego ya viene normalizado entre estudios, así que puede armar las secciones «Slots», «En vivo», «Crash», «Mesa» y «Deportes» directamente desde la respuesta. Las mesas en vivo y el sportsbook son simplemente entradas de esta lista.
Lanzamiento
Para abrir un juego envía el jugador, el identificador del juego, el dispositivo (escritorio o móvil) y el país del jugador, más un idioma opcional. Recibe una URL para cargar en un iframe. El país importa: algunos estudios excluyen ciertos mercados, y nosotros lo aplicamos a partir del país que usted envía, nunca adivinándolo por la dirección IP. Envíelo en cada lanzamiento con dinero real.
Demo
Unas 16.000 slots pueden lanzarse en modo demo con el mismo patrón. No hace falta un registro de jugador y no se disparan callbacks, lo que hace que los lanzamientos demo sean seguros en páginas públicas.
Callbacks de seamless wallet
El dinero de los jugadores nunca sale de su plataforma. Enviamos tres acciones a su URL de callback:
- balance: lee el saldo actual del jugador, normalmente al abrir una sesión.
- debit: una apuesta. Réstela y devuelva el nuevo saldo, o devuelva un código de fondos insuficientes junto con el saldo actual.
- credit: una ganancia. Súmela y devuelva el nuevo saldo.
Cada llamada incluye un id de transacción único, un id de ronda y el identificador del juego. Los importes son enteros en la unidad menor de la moneda. Su endpoint siempre responde HTTP 200; el resultado va en el cuerpo JSON como código de error: éxito, saldo insuficiente o error de procesamiento.
Rollbacks
Un rollback no es una acción aparte. Llega como un débito o un crédito con un indicador de rollback, y se procesa como cualquier otro movimiento. Lo que lo hace seguro es su deduplicación por id de transacción.
Seguridad
Cada callback incluye un timestamp y una clave derivada de ese timestamp y de su salt secreto. Rechace todo lo que llegue fuera de una ventana de tiempo corta o con una clave que no coincida. Para una protección más fuerte, cada callback lleva además una cabecera HMAC-SHA256 calculada sobre todos sus parámetros, de modo que un importe o un nombre de usuario manipulado no pasa la validación.
Giros gratis y rondas gratis
Bajo este nombre conviven dos cosas distintas, y conviene ser preciso.
Los giros gratis dentro del juego funcionan en todo el catálogo sin que tenga que construir nada. Los giros gratis activados por scatters, las rondas de bonificación, las compras de función y los jackpots ocurren dentro del juego, y sus ganancias le llegan como créditos normales, a menudo sin un débito asociado. Su handler debe aceptar esos créditos.
Las rondas gratis promocionales, las que usted le regala a un jugador como oferta de bienvenida, no son llamadas de API en autoservicio de nuestro lado. Si su plan de bonos depende de otorgar rondas gratis, hable con nosotros antes de construirlo y le diremos qué se puede organizar para los juegos que tiene en mente.
Monedas
La moneda se define por jugador. Una cuenta puede atender a jugadores en muchas monedas, o un sitio puede limitarse a una sola. La gama principal de slots multiestudio y el sportsbook admiten 38 monedas ISO, entre ellas EUR, USD, GBP, CAD, AUD, BRL, MXN, ARS, INR, BDT, PKR, IDR, PHP, THB, VND, TRY, ZAR y ETB. Las demás gamas suman o quitan monedas según el estudio, así que tome el método de monedas como la referencia, no un folleto.
Sportsbook a través de la misma API
El sportsbook de nuestro catálogo, Nocturn Sport, se lanza con la misma llamada que una slot y se liquida con los mismos tres callbacks. Las apuestas prepartido y en vivo debitan al jugador al realizarse y lo acreditan al liquidarse, lo que en una apuesta a largo plazo puede ocurrir horas o días después. Los esports como CS2, Dota 2 y Valorant conviven con el fútbol, el tenis y el básquet. Nuestra comisión sobre el GGR del sportsbook es del 12%. Los detalles propios del deporte están en la página de API de apuestas deportivas.
Configuraciones multimarca
Los operadores con varios sitios no se integran dos veces. Cada marca adicional recibe sus propias credenciales y su URL de callback dentro de la misma cuenta, y el catálogo puede variar por sitio si sus licencias lo exigen.
Próximos pasos
Siga el orden paso a paso en integración rápida de API de casino, revise los costos en precios o solicite credenciales en la página de la API key. Si está evaluando varios agregadores, el centro de comparativas pone lado a lado cómo documenta cada uno su wallet.
Preguntas frecuentes
¿Qué es una API de agregador de juegos de casino?
Una única API que da a un operador acceso a juegos de muchos estudios. Usted descarga una sola lista de juegos, lanza cualquier título con la misma llamada y liquida cada ronda con un único conjunto de callbacks de wallet.
¿Los callbacks de wallet son POST o GET?
GET, con parámetros en la query, firmados con una clave basada en timestamp y una cabecera HMAC-SHA256. Su endpoint responde HTTP 200 e informa los errores en el cuerpo JSON.
¿Cómo se gestionan los rollbacks?
Un rollback llega como un débito o un crédito con un indicador de rollback y se procesa como un movimiento normal, protegido por la deduplicación por id de transacción.
¿Puedo otorgar rondas gratis promocionales a través de la API?
No como llamada en autoservicio. Los giros gratis dentro del juego funcionan automáticamente y pagan con créditos normales. Para rondas gratis promocionales, contáctenos antes de construir su plan de bonos.
¿La misma API cubre las apuestas deportivas?
Sí. El sportsbook Nocturn Sport es una entrada de la lista de juegos, se abre con la misma llamada de lanzamiento y se liquida con los mismos callbacks.
¿Cuántas monedas se admiten?
38 monedas ISO en la gama principal de slots y en el sportsbook. Las demás gamas de juegos varían según el estudio; el método de monedas devuelve las que puede usar su cuenta.