Paso 1: cree una clave de prueba

Usted crea las claves en el back office, en Settings, Integration. Una cuenta puede tener hasta dos claves de prueba y hasta cinco claves de producción, y el valor de una clave se muestra una sola vez, así que guárdelo cuando la cree. Una clave de prueba empieza con wgc_test_ y puede abrir juegos demo; una clave de producción abre únicamente juegos con dinero. El catálogo se lee con una clave de producción, porque el catálogo de una clave de prueba muestra solo el juego de prueba.

Paso 2: juegue el juego de prueba

Una clave de prueba abre un solo juego, WGC Test Slot: una página con tres tamaños de apuesta y un botón Spin. Cada giro hace dos llamadas reales a su Callback URL, una apuesta y luego un resultado, marcadas con "test": true y con el encabezado X-WGC-Test: 1, de modo que su manejador pueda distinguirlas del juego real. No se mueve dinero, no se cobra comisión y no se hacen asientos contables. Las filas de prueba aparecen en la pestaña Test de los informes. Se aplican límites: dos giros por segundo por sesión y 2000 giros al día por cuenta.

Paso 3: compruebe las firmas y las respuestas

Cada llamada de billetera va firmada con HMAC-SHA256. Su manejador debe verificar la firma sobre el cuerpo sin procesar antes de analizar el JSON, comparar en tiempo constante y rechazar una llamada cuya marca de tiempo tenga más de cinco minutos. Debe responder en tres segundos con un estado de 200 a 299, y un rechazo es { "ok": false, "error": "insufficient_funds" } con estado 200. Pruebe una firma incorrecta, una firma ausente y una respuesta lenta, y anote qué hace su manejador en cada caso. Esas notas facilitan comparar ante un fallo posterior y mostrar a su equipo qué quedó demostrado.

Paso 4: pruebe la ruta de fallo

Una integración de billetera se define por cómo falla. La página de prueba tiene una opción para perder la respuesta. La operación queda desconocida y, alrededor de un minuto después, llega a su Callback URL un rollback con el motivo unknown_outcome. Úselo para confirmar que su manejador cancela una apuesta una sola vez, que un rollback repetido es inofensivo y que usted responde con el saldo actual a un rollback de una apuesta que nunca registró. WGC repite un rollback que no se acepta durante un máximo de 30 días, así que sus registros de operaciones deben conservarse al menos ese tiempo.

Paso 5: ejecute la verificación de integración

En el back office, Integration check ejecuta un juego real de su propia cuenta a través de su propia billetera. Muestra un registro en vivo del lanzamiento y de cada llamada getBalance, writeBet y rollback, con la solicitud y la respuesta, y una pestaña para las firmas. Úselo con un jugador de prueba. Si una llamada falla, el registro muestra qué envió WGC y qué devolvió su billetera.

Paso 6: ejecute la prueba de integración

La prueba de integración ejecuta 14 comprobaciones de su billetera y da un veredicto para cada una: superada, funciona pero se aconseja un arreglo, o debe corregirse, con una pista sobre qué cambiar. Las comprobaciones cubren lecturas de saldo, firmas incorrectas y ausentes, una apuesta que baja el saldo, una transacción repetida que no debe cobrarse dos veces, una ganancia, una apuesta superior al saldo, un tipo desconocido, dos apuestas iguales en el mismo instante, rollbacks y el tiempo de cada respuesta. Las llamadas llevan un indicador de prueba, y la prueba devuelve las operaciones que su billetera aceptó, así que úsela con un jugador de prueba o una billetera de prueba. Después de la ejecución, compruebe que el saldo del jugador volvió al valor inicial; si no, la ventana le dice que lo revise a mano.

Paso 7: use los ejemplos públicos

Los manejadores del Callback en Node.js, PHP y Python, un script de autocomprobación llamado wallet-check.mjs y una lista de verificación de salida en vivo son públicos y no requieren iniciar sesión. La autocomprobación envía a su endpoint solicitudes firmadas como lo hace WGC, incluida la repetición de una apuesta y dos apuestas idénticas a la vez, e imprime el resultado punto por punto. Mueve el saldo del jugador de prueba en importes pequeños y lo devuelve a su valor, así que ejecútela solo contra un entorno de prueba, con un jugador o una billetera de prueba. No la use con cuentas de jugadores reales.

Paso 8: abra sesiones demo de juegos reales

Elija del catálogo juegos con el indicador de demo y ábralos con una clave de prueba en modo demo:

POST /v1/sessions   X-API-Key: wgc_test_…   Idempotency-Key: open-0001
{"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 demo no mueve dinero y no se rechaza por falta de saldo. Un juego que no admite demo responde invalid_request. El lanzamiento usa además un Idempotency-Key: la misma clave y el mismo cuerpo devuelven la misma respuesta durante 24 horas, así que pruebe una apertura repetida como un caso aparte.

Paso 9: un lanzamiento real pequeño

Abra un juego con dinero usando una clave de producción, un jugador de prueba y una apuesta pequeña. Un lanzamiento real necesita dinero en su cuenta comercial: el saldo más el límite de crédito debe ser mayor que cero. En los informes, la pestaña Rounds de la vista principal debe mostrar la apuesta como aceptada. Si no ve Rounds ni Games, pida a su gerente que los active.

La lista de verificación de salida en vivo

La lista pública tiene 14 puntos. En resumen:

  1. La clave de API se guarda solo en su servidor.
  2. El catálogo se sincroniza completo y después por cambios, con una sincronización completa al menos una vez al día.
  3. Un juego se abre desde su servidor y el enlace se abre en el navegador del jugador.
  4. El Callback URL es público y cada respuesta llega en tres segundos.
  5. La firma y la antigüedad de la marca de tiempo se verifican sobre el cuerpo sin procesar.
  6. getBalance y writeBet responden como dice el contrato, y un rechazo es un cuerpo con ok: false.
  7. writeBet se registra una sola vez por transactionId, y un tipo desconocido se rechaza.
  8. rollback está implementado y es idempotente, o responde 404 o 405.
  9. Los campos desconocidos se ignoran.
  10. La autocomprobación pasa contra su endpoint de prueba.
  11. La prueba de integración no muestra ninguna comprobación fallida.
  12. Funcionan un lanzamiento demo y después uno real pequeño.
  13. El bot de alertas está conectado.
  14. La protección de dos factores está activada para todos los superusuarios.

Ayuda mientras prueba

Ask WGC, el asistente del back office, responde a partir de la documentación con fuentes. Con el permiso de integración activado, su modo de integración lee una instantánea limitada de su propia integración de los últimos siete días, sin secretos ni cuerpos de solicitudes, y explica por qué fallan sus llamadas. El asistente no ejecuta nada en su lugar; solo responde. El soporte en vivo también está en el back office: al escribirle, cite el número de solicitud, el de transacción, el de ronda y la hora en UTC. Vea el modo demo y de prueba, los pasos de integración, el contrato de la billetera seamless, el back office y la descripción general de la API de casino.