Passo 1: crie uma chave de teste

Você mesmo cria as chaves no back office, em Settings, Integration. Uma conta pode ter até duas chaves de teste e até cinco chaves de produção, e o valor de uma chave é mostrado uma única vez, então guarde-o quando a criar. Uma chave de teste começa com wgc_test_ e pode abrir jogos demo; uma chave de produção abre somente jogos com dinheiro. O catálogo é lido com uma chave de produção, porque o catálogo de uma chave de teste mostra apenas o jogo de teste.

Passo 2: jogue o jogo de teste

Uma chave de teste abre um único jogo, o WGC Test Slot: uma página com três tamanhos de aposta e um botão Spin. Cada giro faz duas chamadas reais à sua Callback URL, uma aposta e depois um resultado, marcadas com "test": true e com o cabeçalho X-WGC-Test: 1, para que o seu manipulador possa distingui-las do jogo real. Nenhum dinheiro se move, nenhuma comissão é cobrada e nenhum lançamento contábil é feito. As linhas de teste aparecem na aba Test dos relatórios. Aplicam-se limites: dois giros por segundo por sessão e 2.000 giros por dia por conta.

Passo 3: verifique as assinaturas e as respostas

Toda chamada de carteira é assinada com HMAC-SHA256. O seu manipulador deve verificar a assinatura sobre o corpo bruto antes de analisar o JSON, comparar em tempo constante e rejeitar uma chamada cujo carimbo de tempo tenha mais de cinco minutos. Ele deve responder em três segundos com um status de 200 a 299, e uma recusa é { "ok": false, "error": "insufficient_funds" } com status 200. Teste uma assinatura errada, uma assinatura ausente e uma resposta lenta, e anote o que o seu manipulador faz em cada caso. Essas anotações facilitam a comparação diante de uma falha posterior e mostram à sua equipe o que ficou provado.

Passo 4: teste o caminho de falha

Uma integração de carteira é definida por como ela falha. A página de teste tem uma opção para perder a resposta. A operação fica desconhecida e, cerca de um minuto depois, chega à sua Callback URL um rollback com o motivo unknown_outcome. Use-a para confirmar que o seu manipulador cancela uma aposta uma única vez, que um rollback repetido é inofensivo e que você responde com o saldo atual a um rollback de uma aposta que nunca registrou. A WGC repete um rollback que não é aceito por até 30 dias, então os seus registros de operações devem ser guardados pelo menos por esse tempo.

Passo 5: execute a verificação de integração

No back office, o Integration check executa um jogo real da sua própria conta pela sua própria carteira. Ele mostra um registro ao vivo do lançamento e de cada chamada getBalance, writeBet e rollback, com a requisição e a resposta, e uma aba para as assinaturas. Use-o com um jogador de teste. Se uma chamada falhar, o registro mostra o que a WGC enviou e o que a sua carteira devolveu.

Passo 6: execute o teste de integração

O teste de integração executa 14 verificações da sua carteira e dá um veredicto para cada uma: passou, funciona mas recomenda-se um ajuste, ou precisa ser corrigida, com uma dica do que mudar. As verificações cobrem leituras de saldo, assinaturas erradas e ausentes, uma aposta que reduz o saldo, uma transação repetida que não deve ser debitada duas vezes, um ganho, uma aposta acima do saldo, um tipo desconhecido, duas apostas iguais no mesmo instante, rollbacks e o tempo de cada resposta. As chamadas levam um indicador de teste, e o teste devolve as operações que a sua carteira aceitou, então use-o com um jogador de teste ou uma carteira de teste. Depois da execução, confira se o saldo do jogador voltou ao valor inicial; se não voltou, a janela pede que você o verifique manualmente.

Passo 7: use os exemplos públicos

Os manipuladores do Callback em Node.js, PHP e Python, um script de autoverificação chamado wallet-check.mjs e um checklist de entrada no ar são públicos e não exigem login. A autoverificação envia ao seu endpoint requisições assinadas como a WGC faz, incluindo a repetição de uma aposta e duas apostas idênticas ao mesmo tempo, e imprime o resultado item por item. Ela move o saldo do jogador de teste em valores pequenos e o devolve ao valor inicial, então execute-a somente contra um ambiente de teste, com um jogador ou uma carteira de teste. Não a use com contas de jogadores reais.

Passo 8: abra sessões demo de jogos reais

Escolha no catálogo jogos com o indicador de demo e abra-os com uma chave de teste em 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" } }

O demo não move dinheiro e não é recusado por falta de saldo. Um jogo que não aceita demo responde invalid_request. O lançamento usa ainda um Idempotency-Key: a mesma chave e o mesmo corpo devolvem a mesma resposta por 24 horas, então teste uma abertura repetida como um caso à parte.

Passo 9: um lançamento real pequeno

Abra um jogo com dinheiro usando uma chave de produção, um jogador de teste e uma aposta pequena. Um lançamento real precisa de dinheiro na sua conta comercial: o saldo mais o limite de crédito deve ser maior que zero. Nos relatórios, a aba Rounds da visão principal deve mostrar a aposta como aceita. Se você não vê Rounds nem Games, peça ao seu gerente que os ative.

O checklist de entrada no ar

O checklist público tem 14 pontos. Em resumo:

  1. A chave de API é guardada somente no seu servidor.
  2. O catálogo é sincronizado por inteiro e depois por mudanças, com uma sincronização completa pelo menos uma vez por dia.
  3. Um jogo é aberto a partir do seu servidor e o link é aberto no navegador do jogador.
  4. A Callback URL é pública e cada resposta chega em três segundos.
  5. A assinatura e a idade do carimbo de tempo são verificadas sobre o corpo bruto.
  6. getBalance e writeBet respondem como diz o contrato, e uma recusa é um corpo com ok: false.
  7. writeBet é registrado uma única vez por transactionId, e um tipo desconhecido é recusado.
  8. rollback está implementado e é idempotente, ou responde 404 ou 405.
  9. Os campos desconhecidos são ignorados.
  10. A autoverificação passa contra o seu endpoint de teste.
  11. O teste de integração não mostra nenhuma verificação com falha.
  12. Funcionam um lançamento demo e depois um real pequeno.
  13. O bot de alertas está conectado.
  14. A proteção de dois fatores está ativada para todos os superusuários.

Ajuda enquanto você testa

O Ask WGC, o assistente do back office, responde a partir da documentação com fontes. Com a permissão de integração ativada, o seu modo de integração lê um instantâneo limitado da sua própria integração dos últimos sete dias, sem segredos nem corpos de requisições, e explica por que as suas chamadas falham. O assistente não executa nada no seu lugar; apenas responde. O suporte ao vivo também está no back office: ao escrever a ele, cite o número da requisição, o da transação, o da rodada e o horário em UTC. Veja o modo demo e de teste, os passos de integração, o contrato da carteira seamless, o back office e a visão geral da API de cassino.