EnglishZero Dash ofrece una API de juegos crash y una pila de integración para proveedores de plataforma, agregadores y operadores. ZeroEngine, nuestro servidor de juego remoto, expone las llamadas y el canal en tiempo real necesarios para ejecutar juegos crash en tu plataforma: sesiones de jugador, débitos y créditos del monedero, liquidación, historial de rondas y reporting. Esta página explica qué cubre la API, qué modelo de integración se ajusta a tu configuración y qué implica el onboarding.
Qué cubre la API de juegos crash
Un juego crash es un pequeño bucle que se repite a alta frecuencia, por lo que la integración tiene que seguir siendo correcta bajo carga. La API de ZeroEngine está construida en torno a ese bucle y no en torno a una única sesión larga.
- Sesiones de jugador: crear, reanudar y cerrar una sesión vinculada a la identidad de tu jugador.
- Operaciones de monedero: debitar y abonar el saldo del jugador en cada apuesta y liquidación.
- Datos de ronda: información de apuestas, retiradas y resultados para soporte y conciliación.
- Actualizaciones en tiempo real: eventos del multiplicador y de la ronda enviados al cliente del juego.
- Reporting: actividad agregada para operaciones y finanzas.
La plataforma ZeroEngine agrupa todo esto en una sola integración para que no tengas que unir un servidor de juego, un adaptador de monedero y un feed de reporting de distintos proveedores.
Modelos de integración
Hay dos patrones principales de monedero, y la elección afecta a la latencia, al diseño del libro mayor y a cómo gestionas las desconexiones.
- Monedero seamless: el saldo del jugador permanece en tu libro mayor y cada apuesta y ganancia es una llamada de API en tiempo real a tu monedero. Menos piezas móviles para el jugador, más responsabilidad sobre la disponibilidad de tu endpoint.
- Monedero transfer: los fondos se mueven a un monedero de juego durante la sesión y se devuelven al final. Esto aísla tu libro mayor principal del tráfico por ronda, pero añade pasos de transferencia y conciliación.
Además de la elección del monedero, puedes conectarte directamente a ZeroEngine o a través de un agregador. La integración directa te da control sobre el front-end y la hoja de ruta; un agregador puede reducir el número de contratos si ya usas uno. Nuestra guía sobre la integración de monedero seamless frente a transfer analiza las ventajas e inconvenientes en detalle.
La superficie de la API y los requisitos técnicos
La integración combina una API basada en peticiones para las operaciones de monedero y de sesión con una conexión persistente para los eventos del juego en vivo. Las rondas crash avanzan en segundos, así que el polling no es adecuado; el multiplicador y las confirmaciones de retirada pertenecen a un único canal autenticado en tiempo real. El protocolo WebSocket es el transporte estándar para ese patrón.
Trata los endpoints públicos con la disciplina de seguridad de API habitual. Autentica las peticiones con un secreto compartido o una firma de tipo HMAC para que las llamadas no puedan reproducirse, valida cada campo de entrada y limita la velocidad de los endpoints que un cliente puede activar. El OWASP API Security Top 10 es una lista de comprobación práctica que cubre la autenticación rota, la autorización rota a nivel de objeto y el consumo irrestricto de recursos, todo lo cual importa para una API orientada al monedero.
Las capacidades de apoyo, como la gestión multidivisa, la localización y los controles de backoffice, se describen en la página de funciones.
Onboarding y calendario de integración
El desarrollo en sí es solo una parte del onboarding. La mayoría de los retrasos provienen de pasos comerciales y de cumplimiento, así que conviene tratarlos como parte del proyecto desde el primer día.
- Definición del alcance: confirmar el modelo de integración, los mercados, las divisas y la titularidad del monedero.
- Credenciales y sandbox: recibir claves de prueba, datos de ejemplo y acceso al entorno de pruebas.
- Implementación: conectar las sesiones y las llamadas de monedero, y después el canal en tiempo real y la gestión de retiradas.
- Pruebas: recorrer el ciclo de vida completo de la ronda, incluidas las reconexiones y los casos límite.
- Salida a producción: configurar límites y promociones, y lanzar con la monitorización en marcha.
Nuestra lista de comprobación de integración iGaming en 30 días desglosa esa secuencia en pasos concretos. Si todavía estás eligiendo la plataforma que hay debajo, cómo elegir un proveedor de RGS recoge las preguntas que vale la pena hacer antes de firmar.
Pruebas antes del lanzamiento
Prueba las rutas de fallo, no solo el camino feliz. Confirma que un débito de monedero nunca se pierde ni se duplica cuando una respuesta agota el tiempo de espera, que un jugador que se desconecta a mitad de ronda puede volver a unirse y retirarse, y que la liquidación produce asientos en el libro mayor que concilian exactamente, incluidas las pequeñas fracciones de cripto. Haz pruebas de carga del endpoint del monedero con una concurrencia realista desde tus regiones objetivo, porque una integración seamless coloca tu propio servicio en la ruta crítica de cada ronda.
Seamless frente a transfer de un vistazo
| Consideración | Monedero seamless | Monedero transfer |
|---|---|---|
| Dónde está el saldo | Tu libro mayor principal | Un monedero de juego independiente para la sesión |
| Llamadas de monedero por ronda | En tiempo real, en cada apuesta y ganancia | Los fondos entran y salen alrededor de la sesión |
| Tu requisito de disponibilidad | Alto: tu endpoint está en el bucle de la ronda | Menor: el monedero se sitúa entre tu libro mayor y el juego |
| Conciliación | Directa con los registros de ronda | Añade pasos de transferencia y de liquidación al final de la sesión |
Preguntas frecuentes
¿Tenemos que construir nosotros el cliente del juego?
Depende del modelo de integración. Una integración directa por API permite a tu equipo construir y controlar el front-end, mientras que un lanzamiento white label usa nuestro cliente. En ambos casos, la lógica de ronda, la equidad y la gestión del monedero se ejecutan en ZeroEngine.
¿Qué autenticación usa la API?
Las peticiones se autentican con una credencial compartida y se firman para que no puedan reproducirse ni manipularse. Explicamos el esquema exacto y proporcionamos las credenciales durante el onboarding en el sandbox.
¿Puede una sola integración servir a varios operadores?
Sí. ZeroEngine está construido para admitir varios operadores, divisas e idiomas desde una sola plataforma, lo que resulta útil para agregadores y grupos que gestionan más de una marca.
¿Cómo gestionamos una llamada de monedero fallida a mitad de ronda?
Diseña operaciones de monedero idempotentes y conserva los registros de ronda para que cualquier llamada que haya agotado el tiempo de espera pueda reintentarse y casarse con su registro. Tratamos los casos de fallo esperados y su conciliación durante las pruebas.
Integra juegos crash mediante una sola API
Envíanos los datos de tu plataforma y tus mercados objetivo, y definiremos el modelo de integración, te daremos acceso al sandbox y facilitaremos a tus ingenieros la documentación de la API para empezar.