Guía de operaciones · 2026

Informes de la API de casino: cómo conciliar GGR, rondas y billetera cada día

Cada giro a través de una API de casino deja dos registros: la ronda del proveedor y la transacción de su billetera. Cuando coinciden, los informes son sencillos. Cuando no, alguien está pagando o facturando sobre cifras que nadie sabe explicar. Así se configura una conciliación diaria que detecta las diferencias mientras aún son pequeñas.

En resumen

  • Concilie a diario, por proveedor y por divisa, no una vez al mes.
  • Cruce por ID de transacción, no por totales.
  • GGR = apuestas − ganancias, calculado con el mismo criterio en ambas partes.
  • Controle las rondas abiertas: las apuestas sin resultado son la fuente habitual de diferencias.
  • Conserve los callbacks en bruto durante el tiempo que exija su licencia.

Dos libros, una sola verdad

El proveedor registra rondas: quién apostó, cuánto y qué ganó. Su billetera registra dinero: cada débito y cada crédito con su ID de transacción. Conciliar es demostrar que ambos describen la misma actividad, línea por línea.

Con IGP, a través de su API de casino, las rondas, apuestas, ganancias, contribuciones de bonos y eventos de jackpot llegan en un único flujo normalizado para todos los proveedores, de modo que cada día hay un solo formato que conciliar con el libro de su billetera en lugar de uno por estudio.

Las cifras que hay que controlar

Métrica Cómo se calcula Qué suele significar una diferencia
Volumen de apuestas (turnover) Suma de todas las apuestas Débitos que faltan o están duplicados
Ganancias Suma de todos los créditos de las rondas Créditos que faltan o liquidaciones tardías
GGR Volumen de apuestas menos ganancias Tratamiento distinto de bonos o jackpots
Rondas abiertas Apuestas sin resultado en el momento del corte Timeouts o rondas liquidadas al día siguiente
Rollbacks Transacciones revertidas Reintentos o rondas canceladas
RTP real Ganancias divididas entre el volumen de apuestas Varianza normal, o un error de mapeo si la diferencia es grande y persistente

El RTP real de un día o de una semana diferirá del RTP teórico de un juego; así funciona la probabilidad. Investigue solo las diferencias grandes que persistan a lo largo de muchas rondas, y revise primero el mapeo de juegos.

De dónde vienen los desajustes

  • Timeouts y reintentos contados dos veces en una de las partes. Las llamadas idempotentes a la billetera lo evitan.
  • Rollbacks posteriores a la liquidación que un informe incluye y el otro no.
  • Redondeo de divisas cuando los importes se convierten o usan distintos decimales.
  • Horas de corte en zonas horarias diferentes.
  • Rondas gratuitas contadas como apuestas reales en un informe y no en el otro.

La mayoría se detectan antes del lanzamiento con las pruebas de nuestra checklist de integración.

Una rutina diaria que funciona

  1. Extraiga los datos del proveedor del día anterior y el libro de su billetera con el mismo corte en UTC.
  2. Cruce los ID de transacción; liste todo lo que aparezca solo en una de las partes.
  3. Explique primero las rondas abiertas y los rollbacks; resuelven la mayoría de las diferencias.
  4. Compare volumen de apuestas, ganancias y GGR por proveedor y divisa.
  5. Escale lo que quede al proveedor el mismo día, con los ID de transacción.

Preguntas frecuentes

Los ingresos brutos del juego (gross gaming revenue): total apostado menos total de ganancias en un periodo. Acuerde por escrito cómo se tratan las apuestas con bono, las ganancias de bonos y las contribuciones a jackpots, porque ambas partes deben calcularlo de la misma manera.

Normalmente por cuestiones de tiempos y reintentos: un corte a otra hora, rondas todavía abiertas en el momento del corte, llamadas reintentadas contadas dos veces en una de las partes o rollbacks aplicados después de generar el informe.

Una zona horaria acordada por ambas partes, normalmente UTC. Un informe cortado a medianoche local frente a otro cortado a medianoche UTC nunca coincidirá.

Un solo flujo que conciliar

150+ proveedores y 18.000+ juegos a través de una sola integración, con cada ronda en un único formato normalizado para la conciliación diaria.

Ver la API de casino →