Datos de la sesión de juego
Jugador, marca, juego, moneda, país, idioma, modo, jurisdicción y caducidad del acceso.
Documentación / Flujo de juego
Flujo de la API de juegos
El recorrido completo desde la validación del jugador y el inicio del juego hasta las apuestas, premios, rondas de juego, cancelaciones de operaciones y conciliación financiera.
Sesión
jugador e inicio del juego
Saldo
apuestas y premios
Rondas
flujo de la sesión de juego
Cancelación
recuperación de operaciones
Ciclo de vida del juego
Del inicio al cierre de la ronda
01
Crear una sesión de juego
Jugador, juego, moneda, idioma, país, modo y URL de retorno.
02
Iniciar el juego
Clave de acceso temporal, URL de inicio y comprobación de disponibilidad del juego.
03
Procesar operaciones financieras
Comprobación de saldo, apuesta, premio, operación combinada y respuestas de la plataforma.
04
Cerrar y conciliar la ronda
Resultado final, cancelaciones, libro financiero e informe del proveedor.
Resumen
La API de juegos vincula al jugador, la ronda y el movimiento de fondos
El inicio del juego y el movimiento de fondos son partes distintas de un mismo proceso. La sesión identifica al jugador y las condiciones de inicio, la ronda vincula las acciones del proveedor y la API de la plataforma confirma cada débito, crédito y cancelación.
Control del saldo
La plataforma comprueba los fondos disponibles y aplica cada apuesta, pago o cancelación una sola vez.
Libro financiero del juego
Se conservan los identificadores de operación y ronda, el tipo de operación, el importe y los saldos anterior y posterior para control y conciliación.
Inicio del juego
Flujo habitual de inicio de juego
La plataforma valida primero al jugador y la disponibilidad del juego, después crea una sesión con tiempo limitado y recibe del proveedor una URL de inicio.
01
Validar al jugador y la disponibilidad del juego
La plataforma comprueba el estado de la cuenta, la moneda, el país, las restricciones, los límites, el modo con dinero real o demo y la disponibilidad del juego.
02
Crear una sesión interna
Se crea un identificador de sesión con los datos del jugador, juego, marca, moneda, idioma, IP y caducidad.
03
Obtener la URL de inicio del juego
El proveedor recibe la clave de sesión, las URL de notificación y retorno, el tipo de dispositivo, la jurisdicción y los parámetros de interfaz.
04
Abrir el juego en el navegador
El jugador abre la URL devuelta, mientras que las operaciones financieras posteriores se procesan directamente entre servidores.
Operaciones de saldo
Operaciones principales de saldo
Los nombres de los métodos difieren entre proveedores, pero la lógica es la misma: comprobación de saldo, débito de apuesta, abono de premio y cancelación de una operación confirmada previamente.
Comprobación de saldo
Devuelve el saldo disponible del jugador en la moneda activa de la sesión sin modificar el libro financiero.
Débito de apuesta
Valida al jugador, la sesión, la moneda y los fondos disponibles, y después carga la apuesta confirmada una sola vez.
Abono de premio
Abona los premios utilizando identificadores únicos de operación y ronda, incluido un resultado cero.
Apuesta y resultado en una sola solicitud
Aplica conjuntamente la apuesta y el resultado del juego cuando el proveedor admite este modelo.
Cancelación de operación
Crea una operación correctora independiente para una apuesta o pago confirmado previamente sin eliminar el asiento original.
Bonificaciones y tiradas gratis
Transmite los datos de la campaña de bonificación y de la ronda de juego, separando los fondos reales y de bonificación.
Moneda y precisión del importe
Cada operación valida la moneda, las unidades del importe, los decimales y las reglas de redondeo.
Respuesta de la plataforma
Devuelve el estado de la operación, el identificador interno, el saldo actual y un código de error unificado.
Ciclo de vida de la ronda
Ciclo de vida de la ronda de juego
Una ronda puede incluir varias apuestas y resultados. Su estado viene determinado por las reglas del juego, no solo por el orden de las solicitudes de red.
Ronda creada
La plataforma recibe por primera vez el identificador de la ronda y crea un registro interno.
Ronda activa
La ronda puede contener apuestas adicionales, acciones de juego y premios intermedios.
Apuesta aceptada
El débito es confirmado por la plataforma y se vincula al identificador único de operación del proveedor.
Resultado recibido
Se ha recibido un premio o un resultado cero, pero la ronda puede permanecer abierta según las reglas del juego.
Ronda cerrada
El proveedor ha confirmado el final de la ronda y se han procesado todas las operaciones financieras esperadas.
Operaciones canceladas
Se han corregido una o varias operaciones conservando todo el historial original.
Una ronda puede incluir varias operaciones
El identificador de la ronda no debe ser la única clave de idempotencia. Cada apuesta, pago y cancelación debe tener su propio identificador único.
Fiabilidad y conciliación
Protección frente a duplicados y conciliación financiera
La API de juegos debe gestionar de forma segura solicitudes repetidas, retrasos en las respuestas, operaciones fuera de orden y la recuperación del proveedor tras un fallo.
Procesamiento seguro de reintentos
El identificador de operación del proveedor es único para cada tipo de acción financiera.
Una solicitud repetida devuelve el resultado original y el saldo actual sin volver a mover fondos.
Un reintento con un importe, moneda o jugador diferentes se rechaza como conflicto de datos.
Una cancelación hace referencia a una operación original concreta y también recibe su propio identificador único.
Libro de rondas y conciliación
Guarde los identificadores de sesión, ronda, operación del proveedor y operación de la plataforma.
Registre el tipo de operación, el importe, la moneda, los saldos anterior y posterior y el tiempo de procesamiento.
No modifique los asientos contabilizados; cree una operación correctora independiente.
Concilie los informes del proveedor, las rondas de juego, los movimientos de saldo, el GGR y las discrepancias detectadas.
Pruebas
Qué probar en el entorno de pruebas
Las comprobaciones deben cubrir el inicio del juego, las restricciones del jugador, el saldo insuficiente, las operaciones repetidas, los retrasos de respuesta, las cancelaciones y la conciliación de una ronda cerrada.
Inicio y sesión de juego
Modos con dinero real y demo, moneda no válida, país prohibido, acceso caducado y juego no disponible.
Saldo y rechazo de apuestas
Fondos insuficientes, jugador bloqueado, moneda no coincidente y límite superado.
Retraso y resultado desconocido
El proveedor no recibe una respuesta después de que el débito se haya realizado realmente y vuelve a enviar la operación con el mismo identificador.
Apuestas y premios repetidos
El mismo identificador llega antes o después de que termine el procesamiento, incluso con parámetros contradictorios.
Cancelaciones de operaciones
Cancelación de apuesta, cancelación de premio, cancelación repetida y referencia a una operación original desconocida.
Conciliación de la ronda
Los importes de apuesta, premio y cancelación, el estado final, el movimiento de saldo y el informe del proveedor deben coincidir.
Lista de comprobación previa al lanzamiento
El lanzamiento se realiza después de verificar las sesiones de juego, las operaciones de saldo, la protección frente a duplicados, las cancelaciones y los informes.
Los entornos de pruebas y producción utilizan credenciales de acceso, endpoints de API y configuraciones de inicio diferentes.
La clave de sesión del juego tiene una duración limitada y está vinculada al jugador, el juego, la moneda y la marca.
Cada operación de saldo está protegida por un identificador único del proveedor.
Las apuestas, premios y cancelaciones repetidos no modifican el saldo por segunda vez.
Los asientos contabilizados no se eliminan y se corrigen mediante operaciones de ajuste independientes.
Están configurados los registros de eventos, las alertas, los informes de proveedores y el proceso de conciliación de rondas.
¿Necesita configurar el flujo de la API de juegos?
Envíenos la documentación del proveedor, la lista de operaciones de saldo, el modelo de rondas de juego, las monedas y los requisitos de informes. APIACE ayudará a estructurar el inicio del juego, las apuestas, los premios, las cancelaciones y la conciliación financiera.