Integración de API de casino para plataformas de juego

La API de casino de WGC es una interfaz de servidor a servidor para operadores. Con ella su plataforma recibe el catálogo de juegos asignado a su cuenta, abre juegos para los jugadores, responde las llamadas de billetera y lee el estado de sus propias operaciones. Esta página resume cómo funciona; los pasos para salir a producción están en la página de integración. A continuación verá primero la autenticación y luego los juegos, la billetera y los límites.

Un solo sobre, una sola clave

Su servidor llama a la API con una clave en el encabezado X-API-Key. Cada respuesta usa el mismo sobre, con un indicador ok, un identificador de solicitud y datos o un error. Ramifique su código solo por el código de error; el mensaje está escrito para las personas. La API no está pensada para navegadores y no admite llamadas entre orígenes, es decir, su clave nunca va al navegador y las llamadas las hace solo su servidor.

Usted crea y revoca las claves en el back office: hasta cinco claves de producción y hasta dos de prueba, con el valor visible una sola vez. Una clave de producción nueva en una cuenta con tráfico real empieza a responder a los 30 minutos, o de inmediato cuando una segunda persona la confirma.

Qué está disponible

Los métodos disponibles son una verificación de estado que no necesita clave, el catálogo de juegos, la apertura de una sesión, tres consultas de estado por sus propios números (una transacción, una ronda y una sesión), una consulta de sesiones por su propio identificador de sesión, los límites de ganancia y las llamadas de billetera que WGC hace a su plataforma. La descripción legible por máquina es un archivo OpenAPI 3.1 que se abre sin clave, y la descripción legible es una página de documentación pública. Si difieren, el archivo manda; por eso, al escribir su integración, confíe en el archivo para los detalles.

Juegos y sesiones

La solicitud de juegos devuelve los juegos asignados a su cuenta, 200 por página, cada uno con un publicId, un universalId, un tipo, una dirección de imagen e indicadores de capacidades. Tras una primera descarga completa, usted solicita solo los cambios enviando la hora de su última sincronización. Vea la descripción general del agregador de juegos y la API de tragamonedas para los detalles del catálogo.

Una solicitud de sesión necesita el identificador del jugador, la moneda, el modo (real o demo) y un número de juego. Puede agregar el idioma, una dirección de retorno, la plataforma, el país del jugador, su propio identificador de sesión y, para los juegos que los admiten, un RTP de 75 a 96 y límites de apuesta. Una clave de idempotencia, válida por 24 horas, devuelve la misma respuesta para la misma solicitud, y una apertura repetida del mismo jugador y el mismo juego devuelve la misma sesión mientras esté abierta.

Billetera y consultas de estado

Los saldos de los jugadores se quedan en su plataforma; es decir, el dinero del jugador lo mantiene usted, no WGC. WGC llama a su Callback URL con solicitudes firmadas para el saldo, para una apuesta y su ganancia y para un rollback; el contrato se describe en integración de billetera seamless. Después puede leer el estado de una operación, una ronda o una sesión por sus propios números. El registro de sus solicitudes a la API se conserva 90 días.

Giros gratis

Los giros gratis para un jugador se pueden otorgar mediante la API, pero la función está desactivada de forma predeterminada y se activa a pedido suyo. No funciona para todos los juegos, y la bonificación se paga como una apuesta. Consulte con su gerente si encaja con su proyecto; la activación se acuerda en conjunto.

Límites de ganancia y RTP

Los límites de ganancia se pueden leer y cambiar mediante la API con el derecho correspondiente, y en el back office usted fija líneas de detención para ganancias sospechosas: una sola ganancia, las ganancias de un jugador en una hora y las de una cuenta en una hora, dentro de los límites de la plataforma. El RTP y los límites de apuesta de un lanzamiento se ajustan en la solicitud o en el back office, para los juegos que los admiten.

Límites y estabilidad

De forma predeterminada, una clave puede abrir 600 juegos por minuto, y las solicitudes de catálogo y de estado permiten 120 por minuto. Las ráfagas desde una misma dirección están limitadas, y un exceso recibe una respuesta de límite de frecuencia con un tiempo de espera. Su gerente puede subir los límites de una cuenta; usted puede pedirlo para la suya. A pedido, las llamadas de su cuenta también se pueden restringir a una lista de direcciones, de hasta 50 entradas.

Una versión de la API no se rompe sin aviso. Pueden aparecer campos nuevos, así que ignore los campos que no conozca. Un campo se elimina o cambia de significado solo tras un aviso de obsolescencia y no antes de 90 días. Un cambio incompatible sería una versión nueva, y la actual seguiría funcionando a su lado.

Pruebe primero

Una clave de prueba abre un juego de prueba que hace llamadas reales a su Callback URL, sin dinero, de modo que puede recorrer todo el camino antes de salir a producción. Vea demo y modo de prueba, las monedas para las reglas de moneda, y los pasos de integración.

Preguntas frecuentes

¿Hay una descripción pública de la API?

Sí: un archivo OpenAPI 3.1 y una página de documentación, ambos abiertos sin clave.

¿Puedo llamar a la API desde un navegador?

No. Es una API de servidor a servidor.

¿Cómo obtengo una clave?

La crea usted mismo en el back office, que su gerente le abre.

¿Listo para integrar? Conversemos sobre su integración.

Su próxima conexión
empieza aquí.

Cuéntenos qué está construyendo. Desde ahí seguimos nosotros.

Hable con nosotros