Integración de billetera seamless para plataformas de casino

En un modelo de billetera seamless, el dinero del jugador se queda del lado del casino. WGC no guarda billeteras de jugadores: cuando un juego necesita un saldo o debe registrar una apuesta, WGC envía una solicitud firmada a su plataforma y usa su respuesta. Esta página explica el contrato en términos prácticos para el equipo que construye el manejador.

Cómo funciona el modelo

Los jugadores y los saldos viven en su plataforma. WGC hace solicitudes POST al Callback URL que usted registra, con tres comandos: getBalance para leer el saldo, writeBet para registrar una apuesta y su ganancia, y rollback para cancelar una apuesta. La única excepción es un cliente de demo creado por el personal de WGC, que usa una billetera de prueba de WGC.

writeBet lleva una apuesta y su ganancia en una sola llamada. Cuando un estudio informa la apuesta y el resultado por separado, WGC los une en una sola ronda con un identificador de ronda, y ambas llamadas viajan dentro de ella. El tipo de operación es play, refund o, cuando los jackpots están activados, jackpot, y una marca de ronda terminada señala el final de la ronda.

La idempotencia es parte del contrato

Su manejador debe registrar writeBet una sola vez por transactionId. Una llamada repetida no debe debitar dos veces al jugador y debe devolver el mismo saldo. Esto es una condición de la integración, no un extra opcional, porque las fallas de red hacen que las repeticiones sean normales y que la misma operación llegue por segunda vez sea algo habitual.

Firmas

Cada llamada se firma con HMAC-SHA256 y el secreto de su cuenta. Hay dos encabezados disponibles: una firma sobre el cuerpo y una segunda firma sobre la marca de tiempo unida al cuerpo, junto con la propia marca de tiempo. Una integración nueva debe verificar la segunda. Compruebe la firma sobre el cuerpo en bruto antes de analizar el JSON, compare en tiempo constante y rechace las llamadas de más de cinco minutos. La documentación incluye ejemplos de firma con un secreto de prueba, para que pueda comparar su propio código de verificación. Vea también seguridad.

Tiempos de espera, reintentos y rollback

WGC espera su respuesta tres segundos. Una respuesta cuenta solo con estado 2xx. Un rechazo se expresa en el cuerpo, por ejemplo con un error de fondos insuficientes y estado 200, y no se siguen redirecciones. Si no hay respuesta a tiempo, la apuesta se rechaza al estudio, la operación pasa a desconocida y llega un rollback.

Un rollback le pide cancelar una apuesta completa: devolver la apuesta y retirar la ganancia. WGC lo repite al cabo de un minuto aproximadamente, luego a los 5, 15, 60, 360 y 1.440 minutos, y después a diario hasta 30 días desde la apuesta. Su plataforma conserva los registros de las operaciones al menos 30 días. Admitir el comando rollback es opcional para usted; una respuesta de no encontrado o no permitido a ese comando tampoco es un error.

Hay otros límites que conviene conocer. Una apuesta que esperó dentro de WGC más de un segundo y medio no se le envía y no se debita nada al jugador. Una sola operación puede ser como máximo de un millón de USD al tipo de cambio de la ronda.

Dirección del Callback

Use, idealmente, una dirección pública https://. Las direcciones privadas y de loopback se rechazan al guardar, solo se usan los puertos 443 y 80, y su respuesta no debe superar los 64 KB. Las direcciones desde las que WGC hace sus llamadas se le comunican con anticipación, y se le avisa antes de que cambien.

Verifique su manejador

Los ejemplos y una verificación propia son públicos y no requieren iniciar sesión: manejadores para Node.js, PHP y Python, un script de verificación y una lista de puesta en producción de 14 puntos. En el back office, la prueba de integración ejecuta 14 verificaciones de su billetera y le indica qué corregir; la verificación de integración muestra un registro en vivo de cada llamada con su solicitud y su respuesta.

El modo de prueba incluye una opción de «perder la respuesta», que verifica su rollback: la operación pasa a desconocida y, al cabo de un minuto, llega un rollback. Lea más en demo y modo de prueba y en los pasos de integración.

Después de la ronda

Su plataforma también puede consultar una operación, una ronda o una sesión por sus propios números. Una operación tiene el estado aceptada, rechazada, fallida o desconocida. WGC conserva para los informes el estado, el tiempo de respuesta y los primeros 1.024 caracteres de su respuesta. Explore la API de casino, la descripción general del agregador de juegos y el artículo sobre billetera seamless.

Preguntas frecuentes

¿WGC mantiene los saldos de los jugadores?

No. Los saldos se quedan en su plataforma; WGC llama a su Callback URL.

¿Qué pasa si mi servidor es lento?

Pasados tres segundos, la apuesta se rechaza al estudio y luego se cancela con un rollback.

¿El comando rollback es obligatorio?

No. Su manejador no está obligado a admitirlo; es opcional.

¿Cómo pruebo el manejador?

Use los ejemplos públicos, el script de verificación y el modo de prueba; la prueba de integración del back office también le indica qué corregir.

¿Listo para conectar su billetera? Conversemos sobre su integración.

Su próxima conexión
empieza aquí.

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

Hable con nosotros