Quién llama a quién
Hay dos direcciones. Su servidor llama a WGC para abrir un juego y para consultar qué pasó con una operación. WGC llama a su Callback URL para pedir el saldo del jugador y para cada apuesta y cada ganancia, porque en el modelo de billetera seamless el dinero del jugador se queda en su casino y WGC no guarda un saldo de jugador. Las llamadas de billetera son tres comandos: getBalance, writeBet y rollback. Tener clara la dirección explica casi toda la ronda: el primer paso lo inicia usted, en los pasos dos a cuatro WGC le pregunta a usted, y el último paso es usted preguntando a WGC. Si algo sale mal durante una ronda, conviene mirar primero qué llamada falta en qué dirección.
Paso 1: el lanzamiento
Su servidor llama a POST /v1/sessions con un identificador de jugador, una moneda, un modo y el número de un juego. La respuesta trae un enlace de lanzamiento y un identificador de sesión.
POST /v1/sessions
{"publicId":"sweet-bonanza-1","playerId":"casino-side-player-42","currency":"USD","mode":"demo","language":"en"}
→ 200 { "ok": true, "requestId": "req_…", "data": { "url": "https://play.worldgamingconnect.com/play/Zk3p9xQ2vL8mTn4r", "sessionId": "cmgq3r8v40001l8xyz5k2abcd", "expiresAt": "2026-10-12T10:45:00.000Z" } }El identificador del jugador tiene de 1 a 64 caracteres ASCII imprimibles y nombra a un jugador de su propio sistema. El enlace se abre en el navegador del jugador, no se pide desde su servidor. Un enlace que ningún navegador ha abierto funciona durante 5 minutos; una vez abierto, vive mientras el jugador sigue jugando. En este paso usted no responde nada; es usted quien llama y recibe la respuesta directamente. Abrir el juego desde el lobby de su casino también forma parte de este paso.
Paso 2: el saldo
Cuando el juego arranca, pide el saldo del jugador, y WGC envía getBalance a su Callback URL.
{ "command": "getBalance", "playerId": "casino-side-player-42", "currency": "USD", "requestId": "req_…", "timestamp": "2026-10-12T10:15:00.500Z" }
← { "ok": true, "balance": 123.45, "currency": "USD" }Cada llamada va firmada, y usted comprueba la firma sobre el cuerpo sin procesar antes de analizarlo. Un rechazo se escribe en el cuerpo, por ejemplo { "ok": false, "error": "insufficient_funds" }, con estado 200. La respuesta de saldo determina qué saldo muestra el juego al jugador, por lo que el valor debe ser el saldo actual de su propio sistema.
Paso 3: la apuesta
El jugador pulsa girar, y WGC envía writeBet con una apuesta mayor que cero y una ganancia de cero. La llamada trae un transactionId nuevo y un roundId.
{ "command": "writeBet", "playerId": "casino-side-player-42", "currency": "USD", "bet": 1.00, "win": 0.00, "roundId": "3f1c2a64-8d0b-4e57-9b7a-5c2e1d0f9a41", "gamePublicId": "sweet-bonanza-1", "transactionId": "5f0b1c2e-7a64-4d6e-9a3b-0c1d2e3f4a5b", "kind": "play", "requestId": "req_…", "timestamp": "2026-10-12T10:15:01.000Z" }
← { "ok": true, "balance": 122.45 }Usted debita al jugador una vez por ese transactionId y responde con el saldo nuevo. Si rechaza, no se debita nada y la ronda no continúa. El número de transacción de este paso es la clave para reconocer repeticiones y un posible rollback, así que guárdelo en sus registros. kind es play o refund, y jackpot solo cuando su gerente haya activado los jackpots para su cuenta.
Paso 4: el resultado
El resultado llega como otro writeBet con el mismo roundId: un transactionId nuevo, una apuesta de cero y una ganancia que es el pago.
{ "command": "writeBet", "playerId": "casino-side-player-42", "currency": "USD", "bet": 0.00, "win": 2.50, "roundId": "3f1c2a64-8d0b-4e57-9b7a-5c2e1d0f9a41", "gamePublicId": "sweet-bonanza-1", "transactionId": "9a1d7c33-52b8-4f0e-8c64-2d7e0b5a1f93", "kind": "play", "requestId": "req_…", "timestamp": "2026-10-12T10:15:02.000Z", "roundFinished": true }
← { "ok": true, "balance": 124.95 }Algunos juegos envían la apuesta y el resultado en una sola llamada. Otros los envían por separado, y WGC los une en una sola ronda, de modo que ambas llamadas viajan bajo un mismo roundId. roundFinished: true marca el final de la ronda, y cuando la clave falta usted trata la ronda como todavía abierta. La ganancia se acredita una sola vez por identificador de transacción, y usted responde con el saldo nuevo.
Paso 5: sin respuesta a tiempo
WGC espera 3 segundos su respuesta, y una respuesta cuenta solo con un estado 2xx. Si la respuesta no llega a tiempo, o no se puede leer, la apuesta se rechaza al proveedor del juego y la operación pasa a unknown: WGC no sabe si usted la registró. Todavía no se le pide nada. Dentro de WGC funcionan dos plazos más cortos: una apuesta que esperó más de 1,5 segundos antes de su Callback no se le envía, y al jugador no se le quita nada; una apuesta aceptada cuya respuesta no pudo llegar al proveedor del juego en 4,5 segundos se cancela de inmediato mediante un rollback.
Paso 6: el rollback
Tras un resultado desconocido, WGC envía rollback a la misma dirección con el mismo transactionId.
{ "command": "rollback", "transactionId": "5f0b1c2e-7a64-4d6e-9a3b-0c1d2e3f4a5b", "playerId": "casino-side-player-42", "currency": "USD", "bet": 1.00, "win": 0.00, "reason": "unknown_outcome", "requestId": "rb:5f0b1c2e-7a64-4d6e-9a3b-0c1d2e3f4a5b:1", "timestamp": "2026-10-12T10:16:01.000Z" }
← 200 { "balance": 123.45 }Si usted registró ese transactionId, lo revierte por completo: la apuesta vuelve y la ganancia se retira. Si nunca lo registró, no cambia nada y de todos modos responde con el saldo. El motivo es unknown_outcome cuando su respuesta nunca llegó a WGC; un proveedor de juegos que cancela una transacción ya liquidada tiene un motivo propio. WGC repite un rollback que no se acepta: alrededor de un minuto después de la respuesta que faltó, luego a los 5, 15, 60, 360 y 1440 minutos, y después una vez al día hasta que pasen 30 días desde la apuesta. Por eso conserve sus registros de operaciones durante al menos 30 días. Un casino también puede responder 404, 405 o unknown_command para indicar que no implementa rollbacks, y eso no es un error. Para los detalles del rollback y para recibir las repeticiones con seguridad, vea el artículo sobre idempotencia y reintentos en la billetera.
Paso 7: la conciliación
En cualquier momento su servidor puede preguntar a WGC qué registró, usando los números que vio su casino.
GET /v1/rounds/3f1c2a64-8d0b-4e57-9b7a-5c2e1d0f9a41
→ 200 { "ok": true, "requestId": "req_…", "data": { "roundId": "3f1c2a64-…", "status": "closed", "bet": "1.00", "win": "0.00", "ggr": "1.00", "transactions": [ { "transactionId": "5f0b1c2e-…", "status": "accepted", "balance": "122.45", … } ], "actions": ["bet","no_win"], … } }Una operación tiene el estado accepted, refused, failed o unknown, y una ronda muestra además ggr, que es la apuesta menos la ganancia. La lista actions dice con palabras propias de WGC qué ocurrió, por ejemplo bet, win, no_win o rollback; trate un código desconocido como información y no base decisiones de dinero en él. Las consultas llegan 65 días hacia atrás; los eventos más antiguos están en el archivo de WGC y se buscan a mano bajo solicitud. El número de otra cuenta se lee igual que un número que no existe.
Ensaye la ronda sin dinero
Una clave de prueba abre un juego de prueba, WGC Test Slot, donde cada giro hace dos llamadas reales a su Callback URL, una apuesta y luego un resultado, marcadas con "test": true. No se mueve dinero. Una opción para perder la respuesta pone a prueba su rollback: la operación pasa a unknown, y alrededor de un minuto después llega un rollback. En el back office, Integration check muestra cada llamada en vivo, y la prueba de integración ejecuta 14 comprobaciones de su billetera. Vea el modo demo y de prueba, los pasos de integración y la descripción general de la API de casino.