Integración rápida de API de casino: los pasos, en orden

En qué se va realmente el tiempo de integración

Pregúntele a un desarrollador cuánto se tarda en conectar un agregador de juegos y le dirá «unos días». Pregúntele al operador cuánto pasó desde el primer correo hasta la primera apuesta real y la respuesta suele ser semanas. La diferencia es todo lo que ocurre antes de que un desarrollador pueda tocar la API: llamadas de descubrimiento, una propuesta, borradores de contrato que van y vienen, una tarifa de integración que hay que pagar, luego las claves de sandbox y después una solicitud aparte para las claves de producción.

Nosotros eliminamos toda esa fase previa. Nuestra documentación se puede leer antes de solicitar acceso. No hay negociación de contrato ni tarifa que pagar antes del acceso. Una vez aprobada su cuenta, las credenciales y el crédito de prueba están en su back office, y el crédito de prueba funciona sobre la API real, así que más adelante no hay paso de sandbox a producción.

Antes de empezar: qué necesita de su lado

• Una wallet de jugadores. Nuestra API es de seamless wallet: los saldos viven en su plataforma. Si ya tiene una, tiene recorrida la mayor parte del camino. Si no, constrúyala o cómprela primero, porque ningún agregador puede acortarle esa parte.
• Un endpoint HTTPS público que pueda recibir nuestros callbacks de wallet y responder rápido.
• La lista de monedas de sus jugadores y de los países que va a atender, porque ambas cosas determinan qué juegos se pueden lanzar.

Paso 1: obtenga las credenciales

Solicite acceso en la página de la API key. Tras la aprobación, encontrará su login, su contraseña y un salt secreto en el back office del operador. Configure la URL a la que debemos enviar los callbacks de wallet. Es la única configuración necesaria para empezar.

Paso 2: confirme sus monedas

Llame al método de monedas antes que a cualquier otro. Le indica qué monedas de jugador están habilitadas para su cuenta. Saltarse este paso es la causa más común de un lanzamiento que falla sin motivo aparente: el jugador se creó en una moneda que el juego no acepta.

Paso 3: descargue el catálogo

Pida la lista de juegos. Cada título viene con un identificador estable, una miniatura, su estudio y un tipo de juego normalizado. Arme las secciones del lobby a partir de ese campo de tipo (slots, en vivo, crash, mesa, deportes) y no de las etiquetas de los estudios, que cambian de estilo de un estudio a otro. Guarde los identificadores: los devolverá para lanzar los juegos.

Paso 4: cree un jugador de prueba

Registre un jugador con un nombre de usuario y una moneda. La moneda queda fija para ese jugador a partir de ese momento, así que elíjala con intención.

Paso 5: escriba el handler de callbacks

Es la única parte que requiere verdadero cuidado. Llamaremos a su endpoint con tres acciones:

1. balance al abrir una sesión,
2. debit por cada apuesta,
3. credit por cada ganancia.

Responda cada llamada con HTTP 200 y un cuerpo JSON que contenga el nuevo saldo, con los importes como enteros en la unidad menor (2,50 se convierte en 250). Informe problemas como fondos insuficientes mediante un código de error en el cuerpo, no con un error HTTP. Valide la firma en cada petición y deduplique por id de transacción para que una llamada reintentada nunca mueva dinero dos veces.

Dos reglas evitan la mayoría de los tickets de soporte. Primero, nunca rechace un callback porque no reconoce su campo de tipo; trátelo según su acción. Segundo, acepte un crédito que no tenga un débito asociado. Los giros gratis dentro del juego, las rondas de bonificación y los jackpots pagan exactamente así, y un handler que los rechaza deja a los jugadores sin cobrar. Los rollbacks llegan con un indicador y se procesan como un débito o crédito normal.

Paso 6: lance un juego

Pida una URL de lanzamiento para una slot, enviando el jugador, el identificador del juego, el tipo de dispositivo y el país del jugador. Abra la URL en un iframe, gire con el crédito de prueba y observe cómo llegan el débito y el crédito a su endpoint. Luego revise el historial de rondas del jugador para confirmar que la apuesta y la ganancia coinciden con lo que registró su libro contable.

Un plazo realista

Para un equipo que ya opera una wallet, los pasos 2 a 6 caben en una sola jornada laboral; una primera ronda real el primer día es un objetivo realista. Convertir eso en un lobby de producción, con el catálogo completo, casino en vivo, deportes, lanzamientos móviles, idiomas y modo demo, suele llevar alrededor de una semana de trabajo. Los equipos sin wallet deben sumar lo que les lleve construirla.

Agregar el casino en vivo o el sportsbook no reinicia el proyecto. Ambos aparecen en la misma lista de juegos, se abren con la misma llamada de lanzamiento y se liquidan con los mismos callbacks, así que solo implican trabajo de front end. Nuestra página de API de apuestas deportivas explica los pocos puntos propios del deporte, como las apuestas que se liquidan mucho después de realizarse.

Salir en vivo

Cuando termine las pruebas, cargue crédito prepago (mínimo de 100 USD por recarga) y habilite a los jugadores reales. La comisión se descuenta de ese crédito a medida que se liquidan las rondas con dinero real. ¿Opera más de una marca? Cada sitio adicional recibe sus propias credenciales y su URL de callback en la misma cuenta, sin una nueva integración.

Para la lista completa de métodos y campos, vea la descripción general de la API de agregador de juegos de casino. Para los costos, vea precios y la explicación de la API de casino gratis. Para comparar la velocidad de alta con otros proveedores en igualdad de condiciones, use el centro de comparativas.