AIC Aggregator

Buscar en la documentación

Buscar secciones, endpoints, parámetros...

Sección 07

Flujos por modalidad

Secuencia completa de llamadas en Seamless y Transfer.

Flujos por modalidad#

Esta sección describe la secuencia completa de llamadas en cada modalidad de wallet. Recuerda que la modalidad se define por proveedor y que cada juego la indica en su campo gameModel (ver Conceptos técnicos).

Flujo Seamless#

El balance permanece en tu plataforma y AIC lo consulta y mueve en tiempo real.

  1. Tu plataforma llama a enterGame y abre la URL devuelta para el jugador.
  2. AIC llama a tu check-balance para mostrar el balance en el juego.
  3. En cada ronda, AIC llama a tu add-bet con la apuesta y, si hay ganancia, a tu add-win.
  4. Las cancelaciones o reembolsos llegan como add-win, o como add-bet si la reversión le quita saldo al jugador.
  5. Al salir el jugador del juego, es recomendable que tu plataforma llame a logout-game para cerrar la sesión con el proveedor. No hay balance pendiente que devolver.

Flujo Transfer#

El balance completo del jugador se transfiere al juego al abrirlo y regresa al cerrarlo.

  1. Tu plataforma llama a enterGame.
  2. AIC llama a tu check-balance y después a tu add-bet por el balance completo del jugador, que pasa al juego. Si una sesión Transfer anterior del jugador quedó con balance en el proveedor, AIC puede devolverlo primero mediante add-win.
  3. El jugador juega; las apuestas y ganancias se gestionan dentro del juego, sin llamadas a tu API.
  4. Cuando el jugador cierra el juego en tu plataforma, tu plataforma llama a logout-game (ver Endpoints del Aggregator).
  5. AIC recupera el balance del juego y lo acredita en tu plataforma con add-win.
  6. AIC te envía update-totals-games con los totales de la sesión.

Importante

En Transfer, la sesión solo se cierra cuando tu plataforma llama a logout-game. Si no lo haces, el balance del jugador permanece en el juego. Llama a logout-game una sola vez por sesión de juego y antes de que el jugador abra otro juego.

Reglas para tu integración#

  • playerName único y estable. Usa un identificador único por jugador que no cambie entre sesiones y no uses los caracteres - ni _. Es recomendable anteponer un prefijo propio de tu plataforma.
  • token único por sesión. Genera un token de sesión nuevo en cada enterGame; AIC te lo devuelve como token_room en cada llamada de wallet.
  • Usa movementId para detectar duplicados. idTransaction puede repetirse entre operaciones de una misma ronda; movementId es único por movimiento y solo se repite cuando AIC reenvía el mismo movimiento. Si recibes un movementId que ya aplicaste, no lo vuelvas a aplicar y responde con el balance actual del jugador.
  • Responde rápido. Las llamadas de wallet ocurren durante el juego; una respuesta lenta o fallida hace que la operación falle hacia el proveedor.