Guía de integración · 2026
Checklist de integración de una API de casino: del sandbox a la primera apuesta real
Una integración de API de casino requiere poco código y mucha secuenciación. Los equipos que la tratan como una tarea de ingeniería terminan la ingeniería y después esperan ocho semanas por otra cosa. Este es el orden en que realmente se desarrolla el trabajo, y las once comprobaciones que conviene ejecutar antes de que un jugador real lo toque.
La versión corta
- La ingeniería suele llevar 2–6 semanas; la fecha de salida en vivo la fijan los pagos y la certificación.
- Decida si usará una billetera seamless o de transferencia antes de escribir nada.
- Todo endpoint que mueve dinero debe ser idempotente. Este es el defecto que cuesta dinero real.
- Pruebe los rollbacks y los timeouts de forma deliberada: son los casos que, si no, producción encontrará por usted.
- Inicie la certificación y la aprobación de pagos en paralelo con el desarrollo, nunca después.
Fase 1: decisiones antes del código
Cuatro decisiones condicionan todo lo que viene después, y cambiarlas más tarde implica reescribir la integración.
Modelo de billetera. La billetera integrada (seamless wallet) mantiene el saldo en su sistema y cada llamada del proveedor lo consulta en tiempo real. La de transferencia mueve fondos a una subcuenta del proveedor. La seamless le ofrece una única fuente de verdad y un único extracto; la de transferencia a veces viene impuesta por un proveedor o por un mercado. Nuestra comparación de los dos modelos analiza en detalle las ventajas y desventajas de cada uno.
Alcance. Toda la API de casino, o una ruta más acotada: solo slots o solo casino en vivo. Un alcance más acotado implica una certificación más rápida, y es fácil ampliarlo después.
Jurisdicciones. Qué mercados en el lanzamiento y cuáles más adelante. Esto determina la lista de estudios certificados, y esa lista siempre es más corta que el catálogo anunciado.
Monedas. Cuáles, y con qué tratamiento de las unidades menores. Decida si opera con unidades menores enteras o con decimales, déjelo por escrito y asegúrese de que ambas partes estén de acuerdo antes de la primera llamada.
Fase 2: el sandbox
Pida credenciales de sandbox antes de firmar nada. Un proveedor que confía en su integración se las entregará; uno que no lo hace le está diciendo algo.
En el sandbox se implementan cinco endpoints, y nada más importa hasta que funcionen correctamente: autenticar un token de sesión, devolver el saldo, aplicar un débito (apuesta), aplicar un crédito (ganancia) y procesar un rollback. Todo lo demás en una API de agregador son comodidades alrededor de esos cinco.
Hay dos propiedades que importan más que el código. Cada uno de ellos debe ser idempotente — el mismo ID de transacción que llega dos veces devuelve el resultado original en lugar de mover dinero dos veces. Y los endpoints de dinero deben responder rápido, holgadamente por debajo de un segundo bajo carga, porque el proveedor está esperando y el jugador está mirando cómo gira un rodillo.
Fase 3: las once comprobaciones
| # | Comprobación | Cómo probarla |
|---|---|---|
| 1 | Débito duplicado | Envíe el mismo ID de transacción dos veces; el saldo debe moverse una sola vez |
| 2 | Timeout y luego reintento | Retrase su respuesta más allá del timeout del proveedor y deje que llegue el reintento |
| 3 | Rollback de una apuesta liquidada | Revierta una ronda que ya pagó una ganancia |
| 4 | Fondos insuficientes | Apueste por encima del saldo; compruebe el código de error que espera el proveedor |
| 5 | Sesión caducada a mitad de ronda | Haga caducar el token mientras una ronda de juego sigue abierta |
| 6 | Redondeo de moneda | Apueste un importe con unidades menores poco habituales y liquídelo |
| 7 | Rondas simultáneas | Dos juegos abiertos en una misma cuenta, apostando a la vez |
| 8 | Caída de un proveedor | Desactive un estudio y observe qué muestra el lobby al jugador |
| 9 | Carga sobre la billetera | Mida la latencia de los débitos mientras se ejecuta un informe |
| 10 | Giros gratis y rondas de bonificación | Otorgue, juegue y liquide de principio a fin una ronda financiada con bono |
| 11 | Conciliación | Su registro de transacciones frente al informe del proveedor durante un día completo |
La comprobación 11 es la que los equipos se saltan y la que provoca los peores cierres de mes. Ejecútela en el sandbox en un día que incluya rollbacks y rondas de bonificación, no en un día limpio.
Fase 4: lo que no es código
Estas tareas avanzan en paralelo con el desarrollo o se convierten en su fecha de lanzamiento.
Aprobación del proveedor de pagos. Los procesadores evalúan el riesgo del operador, no de la plataforma. La integración lleva días; la aprobación puede llevar semanas, y es el motivo más habitual por el que se retrasa un lanzamiento. Iníciela en la primera semana.
Certificación de estudios. Cada proveedor certifica mercado por mercado. El catálogo utilizable en su jurisdicción es menor que el total y debe confirmarse por escrito antes de planificar un lobby en torno a él.
Infraestructura de cumplimiento. Los límites de juego responsable, las comprobaciones de autoexclusión y los recordatorios de sesión deben situarse entre el jugador y el débito, no al lado. Añadirlos después de la salida en vivo es el camino caro.
Fase 5: salida en vivo
Haga un lanzamiento suave con un catálogo reducido y dinero real antes de abrir el lobby completo. Vigile tres cosas durante la primera semana: la latencia de los débitos en horas pico, el número de rollbacks y si la conciliación diaria cierra sin diferencias. Un número creciente de rollbacks suele indicar timeouts, no mala suerte.
Mantenga un interruptor de desactivación por proveedor. Poder desactivar un estudio sin publicar una nueva versión marca la diferencia entre una mala hora y una mala noche.
Preguntas frecuentes
Acceso al sandbox antes de comprometerse
150+ proveedores y 18.000+ juegos en una sola integración, con billetera seamless o de transferencia, y la lista certificada para su mercado confirmada desde el principio.