Uma moeda é um código

Onde a API recebe uma moeda, ela é um código de 3 a 8 letras, de A a Z, por exemplo USD ou EUR. O mesmo código aparece na requisição de lançamento, em cada chamada de carteira e nos registros dos seus próprios jogadores. O catálogo de moedas da plataforma tem mais de 50 moedas, e a sua conta usa as que foram liberadas para ela. Você vende somente as moedas que o seu gerente liberou para a sua conta. Por isso, leia a lista a partir dos dados atuais da sua conta, em vez de escrevê-la fixa no seu próprio código.

As moedas são liberadas para uma conta

As moedas são liberadas por conta, como os jogos, e uma conta subordinada não recebe mais do que a que está acima dela. Se você abrir um jogo em uma moeda que não foi liberada, a resposta é currency_not_granted, com status 400. Libere a moeda para a conta ou envie uma que esteja liberada. O erro volta no momento do lançamento com uma resposta clara; a sua plataforma pode capturá-lo antes que o jogador veja uma tela de jogo e oferecer uma moeda adequada. Você pode ver a lista de moedas liberadas na página Currencies do back office, junto com os limites de aposta de cada uma.

A requisição do catálogo aceita um parâmetro opcional currency, que oculta os jogos que não a cobrem:

GET /v1/games?currency=EUR

Sem ele, a requisição devolve todos os jogos liberados para a conta, e a moeda é verificada quando a sessão é aberta. Uma moeda que a conta não vende também é recusada aqui, com currency_not_granted, e não com um catálogo vazio. Assim, um código escrito errado ou inexistente não se parece silenciosamente com uma lista vazia e é notado de imediato.

Um jogo pode não abrir em todas as moedas

Uma moeda liberada não significa que todos os jogos abram nela. Cada jogo do catálogo traz uma lista chamada unavailableCurrencies: as moedas em que o provedor do jogo não abre esse jogo agora. Um lançamento em uma moeda da lista é recusado de imediato, e as demais moedas continuam funcionando. A lista pode mudar, por isso ela chega com o delta do catálogo e a sua plataforma pode ocultar o jogo para essa moeda. A documentação não promete que um jogo esteja pronto em todas as moedas, então teste as combinações que você planeja vender. O lançamento em si tem este aspecto, com a moeda no corpo:

POST /v1/sessions
{"publicId":"sweet-bonanza-1","playerId":"casino-side-player-42","currency":"USD","mode":"demo","language":"en"}

A moeda na carteira

A carteira do jogador fica no seu cassino, então cada chamada da carteira seamless nomeia a sua moeda:

{ "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" }

Um valor é um número, ou uma cadeia com ponto. Uma única operação pode ser de, no máximo, 1.000.000 USD pela taxa da rodada; uma maior é recusada antes de o seu endpoint ser chamado. A uma taxa de 1.524 pesos por dólar, isso são 1.524.000.000 pesos. O saldo que você mantém do jogador não tem outro teto, então um jogador com 2.500.000 ARS joga como qualquer outro. O saldo comercial da sua empresa com a WGC é outra coisa: é mantido em USD e não é o saldo disponível do jogador, então não deduza um a partir do outro. O saldo do jogador é sempre o registro do seu próprio cassino; à WGC chega apenas o que as chamadas nomeiam, na moeda e no valor indicados.

Da moeda do jogo ao USD

A WGC mantém a conta comercial de cada cliente em USD. Uma rodada jogada em outra moeda é convertida para USD pela taxa do instantâneo do momento da rodada, e a conversão é gravada junto com a rodada.

  • De onde vêm as taxas. O servidor atualiza as taxas em relação ao USD a cada 30 minutos a partir de uma fonte pública de taxas, e o último instantâneo bom continua válido. A fonte em si muda uma vez por dia.
  • Uma moeda sem taxa não pode ser vendida. Ativá-la no catálogo ou liberá-la para um cliente é recusado até que exista uma taxa.
  • Uma taxa velha demais recusa a rodada. Uma rodada em uma moeda sem uma taxa recente, com mais de 6 horas, é recusada antes de o seu cassino ser chamado, de modo que cada rodada continua conversível para o saldo comercial.

O saldo comercial é armazenado com seis casas decimais e exibido com duas, e pode ser negativo dentro do limite de crédito combinado. Nada disso toca o dinheiro do jogador: ele continua no seu cassino, na moeda que você escolheu. Para o limite de crédito e o histórico de cada linha, leia o artigo sobre o saldo comercial.

Limites por moeda

Para cada moeda são definidos três valores: a aposta mínima, a aposta máxima e o saldo de demo. Uma conta com a permissão correspondente pode editá-los dentro dos limites da sua conta superior. Os limites que a WGC envia ao provedor do jogo com um lançamento, como o RTP e os limites de aposta de uma sessão, são definidos à parte, em Settings, na seção RTP & bets, e só se aplicam nos jogos que os aceitam. Um jogo que não os aceita os ignora e o lançamento não é recusado. Por isso, não confunda os limites da página de moedas com os da sessão. O catálogo diz quais os aceitam: rtpSettable e betLimitsSettable. A sua plataforma pode olhar esses dois indicadores e oferecer um recurso somente nos jogos em que ele funciona.

O que você vê no back office

A página Currencies lista as moedas da sua conta com um interruptor de ativado e desativado, e tocar em uma linha abre os seus limites. A página FX rates mostra, para cada moeda que você vende, 1 USD = X e 1 CODE = Y USD, com o dia em que a taxa é válida e o horário em que foi carregada, e um cliente vê somente as suas próprias moedas. Com a permissão de Reports, um bloco abaixo mostra apostas, ganhos e lucro por moeda, com cada rodada convertida pela sua própria taxa, e uma tabela de sessões com exportação para CSV. Veja a página de moedas e o back office. Essas visões também servem para mostrar, depois de uma disputa, com que taxa cada rodada foi calculada.

Uma lista de verificação para a sua equipe

  1. Pergunte ao seu gerente quais moedas estão liberadas para a sua conta e confira-as na página Currencies.
  2. Solicite o catálogo com currency, ou leia unavailableCurrencies de cada jogo.
  3. Mantenha a moeda com cada jogador e cada transação nos seus próprios registros.
  4. Responda a cada chamada de carteira na moeda que ela nomeia.
  5. Use uma chave de teste para abrir os jogos que você planeja vender, em cada moeda, antes do tráfego real. Veja a visão geral da API de cassino para o restante do fluxo.