Una moneda es un código
Donde la API recibe una moneda, es un código de 3 a 8 letras, de la A a la Z, por ejemplo USD o EUR. El mismo código aparece en la solicitud de lanzamiento, en cada llamada de billetera y en los registros de sus propios jugadores. El catálogo de monedas de la plataforma tiene más de 50 monedas, y su cuenta usa las que se le asignaron. Usted vende únicamente las monedas que su gerente asignó a su cuenta. Por eso, lea la lista a partir de los datos actuales de su cuenta en lugar de escribirla fija en su propio código.
Las monedas se asignan a una cuenta
Las monedas se asignan por cuenta, igual que los juegos, y una cuenta subordinada no recibe más que la que está por encima. Si abre un juego en una moneda que no se asignó, la respuesta es currency_not_granted, con estado 400. Asigne la moneda a la cuenta o envíe una que esté asignada. El error vuelve en el momento del lanzamiento con una respuesta clara; su plataforma puede capturarlo antes de que el jugador vea una pantalla de juego y ofrecerle una moneda adecuada. Puede ver la lista de monedas asignadas en la página Currencies del back office, junto con los límites de apuesta de cada una.
La solicitud del catálogo acepta un parámetro opcional currency, que oculta los juegos que no la cubren:
GET /v1/games?currency=EURSin él, la solicitud devuelve todos los juegos asignados a la cuenta, y la moneda se comprueba al abrir la sesión. Una moneda que la cuenta no vende también se rechaza aquí, con currency_not_granted, y no con un catálogo vacío. Así, un código mal escrito o inexistente no se parece en silencio a una lista vacía y se nota de inmediato.
Un juego puede no abrirse en todas las monedas
Una moneda asignada no significa que todos los juegos se abran en ella. Cada juego del catálogo lleva una lista llamada unavailableCurrencies: las monedas en las que el proveedor del juego no abre ese juego ahora. Un lanzamiento en una moneda de la lista se rechaza de inmediato, y las demás monedas siguen funcionando. La lista puede cambiar, por eso llega con el delta del catálogo y su plataforma puede ocultar el juego para esa moneda. La documentación no promete que un juego esté listo en todas las monedas, así que pruebe las combinaciones que planea vender. El lanzamiento en sí se ve así, con la moneda en el cuerpo:
POST /v1/sessions
{"publicId":"sweet-bonanza-1","playerId":"casino-side-player-42","currency":"USD","mode":"demo","language":"en"}La moneda en la billetera
La billetera del jugador se queda en su casino, así que cada llamada de la billetera seamless nombra su moneda:
{ "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" }Un importe es un número, o una cadena con punto. Una sola operación puede ser, como máximo, de 1 000 000 USD al tipo de la ronda; una mayor se rechaza antes de llamar a su endpoint. A un tipo de 1524 pesos por dólar, eso son 1 524 000 000 pesos. El saldo que usted lleva del jugador no tiene otro tope, de modo que un jugador con 2 500 000 ARS juega como cualquier otro. El saldo comercial de su empresa con WGC es otra cosa: se lleva en USD y no es el saldo disponible del jugador, así que no deduzca uno a partir del otro. El saldo del jugador es siempre el registro de su propio casino; a WGC solo llega lo que las llamadas nombran, en la moneda y el importe indicados.
De la moneda del juego al USD
WGC lleva la cuenta comercial de cada cliente en USD. Una ronda jugada en otra moneda se convierte a USD al tipo de la instantánea del momento de la ronda, y la conversión se escribe junto con la ronda.
- De dónde vienen los tipos. El servidor actualiza los tipos frente al USD cada 30 minutos desde una fuente pública de tipos, y la última instantánea buena sigue siendo válida. La fuente en sí cambia una vez al día.
- Una moneda sin tipo no puede venderse. Activarla en el catálogo o asignarla a un cliente se rechaza hasta que exista un tipo.
- Un tipo demasiado viejo rechaza la ronda. Una ronda en una moneda sin un tipo reciente, de más de 6 horas, se rechaza antes de llamar a su casino, de modo que cada ronda sigue siendo convertible al saldo comercial.
El saldo comercial se almacena con seis decimales y se muestra con dos, y puede ser negativo dentro del límite de crédito acordado. Nada de esto toca el dinero del jugador: sigue en su casino, en la moneda que usted eligió. Para el límite de crédito y el historial de cada línea, lea el artículo sobre el saldo comercial.
Límites por moneda
Para cada moneda se fijan tres valores: la apuesta mínima, la apuesta máxima y el saldo de demo. Una cuenta con el permiso correspondiente puede editarlos dentro de los límites de su cuenta superior. Los límites que WGC envía al proveedor del juego con un lanzamiento, como el RTP y los límites de apuesta de una sesión, se fijan aparte, en Settings, en la sección RTP & bets, y solo se aplican en los juegos que los aceptan. Un juego que no los acepta los ignora y el lanzamiento no se rechaza. Por eso no confunda los límites de la página de monedas con los de la sesión. El catálogo dice cuáles los aceptan: rtpSettable y betLimitsSettable. Su plataforma puede mirar esos dos indicadores y ofrecer una función solo en los juegos donde funciona.
Qué ve en el back office
La página Currencies enumera las monedas de su cuenta con un interruptor de activado y desactivado, y al tocar una fila se abren sus límites. La página FX rates muestra, para cada moneda que usted vende, 1 USD = X y 1 CODE = Y USD, con el día en que el tipo es válido y la hora en que se cargó, y un cliente ve solo sus propias monedas. Con el permiso de Reports, un bloque debajo muestra apuestas, ganancias y beneficio por moneda, con cada ronda convertida a su propio tipo, y una tabla de sesiones con exportación a CSV. Vea la página de monedas y el back office. Estas vistas sirven también para mostrar, tras una disputa, con qué tipo se calculó cada ronda.
Una lista de verificación para su equipo
- Pregunte a su gerente qué monedas están asignadas a su cuenta y compruébelas en la página Currencies.
- Solicite el catálogo con
currency, o leaunavailableCurrenciesde cada juego. - Conserve la moneda con cada jugador y cada transacción en sus propios registros.
- Responda cada llamada de billetera en la moneda que nombra.
- Use una clave de prueba para abrir los juegos que planea vender, en cada moneda, antes del tráfico real. Vea la descripción general de la API de casino para el resto del flujo.