Casi todos los agregadores de juegos de casino se integran hoy con los operadores mediante un seamless wallet. El modelo es fácil de describir y fácil de hacer mal en los detalles. Esta guía recorre lo que pasa durante una ronda de juego y lo que hay que probar antes de que circule dinero real.
El principio
El operador es dueño del libro contable. El saldo del jugador nunca pasa al agregador ni al estudio. En su lugar, el agregador pregunta al wallet del operador cuál es el saldo, le indica que cobre una apuesta y le indica que pague un premio. El operador responde a cada llamada con el nuevo saldo o con un error.
Una ronda, paso a paso
- Lanzamiento. El operador pide al agregador una URL de juego para un jugador, una divisa y un juego concretos. El agregador devuelve una URL que el operador carga para el jugador.
- Saldo. El juego pide el saldo; el agregador llama al endpoint de saldo del operador.
- Cargo. El jugador gira. El agregador llama al endpoint de cargo del operador con un ID de transacción, un ID de ronda y un importe. El operador comprueba los fondos, registra la apuesta y devuelve el nuevo saldo.
- Abono. La ronda se resuelve. El agregador llama al endpoint de abono con el importe del premio, que puede ser cero, y el mismo ID de ronda.
- Rollback, si hace falta. Si el cargo se registró pero la ronda falló, el agregador envía un rollback de la transacción original.
Cinco reglas que evitan disputas de saldo
- Idempotencia en cada llamada. Un ID de transacción repetido debe devolver el resultado original, nunca un segundo apunte.
- Revertir solo lo que existe. Un rollback de una transacción desconocida debe confirmarse sin mover dinero.
- Abonos después de rollbacks. Decidid y documentad qué pasa cuando llega un abono para una ronda ya revertida.
- Tiempos de espera. Acordad cuánto espera el agregador y cuántas veces reintenta. Un wallet lento provoca llamadas duplicadas.
- Precisión de la divisa. Acordad si los importes se envían en unidades o en unidades menores, sobre todo con cripto de muchos decimales.
Pruebas antes del lanzamiento
Ejecuta cada escenario en el sandbox: fondos insuficientes, cargo duplicado, abono duplicado, rollback tras cargo, rollback de una transacción desconocida, abono tras rollback y timeout del wallet. Registra cada petición y respuesta con el ID de transacción para que el soporte pueda rastrear una ronda en disputa en minutos.
¿Seamless o transfer?
Los transfer wallets llevan el dinero a una sesión y lo traen de vuelta. Simplifican algunas integraciones con proveedores, pero reparten el saldo entre sistemas. El seamless mantiene una única fuente de verdad, y por eso la mayoría de operadores lo prefiere. Hub88 es uno de los pocos agregadores que documenta ambos.
Preguntas frecuentes
¿Qué es un seamless wallet?
Un modelo de integración en el que el dinero del jugador se queda en el sistema del operador. El agregador o el servidor de juego llama al operador en cada consulta de saldo, apuesta y premio.
¿Qué diferencia hay entre seamless wallet y transfer wallet?
Con un transfer wallet, el dinero pasa a la sesión del proveedor de juegos y vuelve al final. Con un seamless wallet, nunca sale del libro contable del operador.
¿Qué es la idempotencia en una API de wallet?
La garantía de que procesar dos veces la misma petición tiene el mismo efecto que procesarla una vez. Cada cargo y abono lleva un ID de transacción único para que una llamada repetida no se contabilice dos veces.
¿Qué pasa si un cargo se completa pero la ronda falla?
El agregador envía un rollback (a veces llamado refund o cancel) que hace referencia a la transacción original, y el operador devuelve la apuesta al jugador.
¿Qué agregadores usan seamless wallet?
La mayoría. SoftAggregator, SoftGamings y Hub88 lo indican públicamente; Hub88 ofrece además una opción TransferWallet.