Comece pelo dono do saldo
No modelo de carteira por callback usado pela WGC, a plataforma do cassino guarda a carteira do jogador. A WGC chama a sua plataforma para pedir um saldo ou o resultado de uma transação de jogo. A WGC não armazena carteiras de jogadores; a única exceção é um cliente de demo criado pela equipe da WGC, que usa uma carteira de teste.
A referência do jogador identifica um jogador no sistema próprio do cassino, como uma cadeia de 1 a 64 caracteres ASCII imprimíveis. Ela não é a conta comercial usada para acessar a WGC. Combine primeiro esse limite, para que as duas equipes saibam qual sistema vale quando uma requisição falha ou um valor é contestado. Sem esse acordo, cada divergência obriga a comparar do zero os registros das duas equipes.
Acompanhe uma transação pelos sistemas
Uma integração típica precisa de uma consulta de saldo e de uma forma de registrar uma aposta e o seu resultado. O contrato de callback da WGC nomeia três comandos: getBalance para ler o saldo, writeBet para registrar uma aposta com o seu ganho em uma única requisição, e rollback para cancelar uma aposta. Quando um estúdio envia a aposta e o resultado separadamente, a WGC os une em uma única rodada com um identificador de rodada, e as duas chamadas viajam dentro dela.
Mantenha juntas nos seus registros as referências do jogador, da moeda, do jogo, da rodada e da transação. Um link de lançamento é apenas o ponto de entrada para um jogo; ele não confirma que uma consulta de saldo ou uma liquidação foi concluída. Por isso, nas solicitações ao suporte, apoie-se nos números de transação e de rodada, e não apenas no link de lançamento.
Trate uma nova tentativa como a mesma transação
Um tempo limite de rede pode ocorrer depois que uma operação foi aceita, mas antes que a resposta chegasse a quem chamou. Repetir essa operação às cegas pode debitar o jogador duas vezes. Um manipulador idempotente reconhece o mesmo identificador de transação e devolve o resultado registrado em vez de aplicar os valores de novo. Com a WGC, isso é uma condição da integração: o writeBet é registrado uma única vez por identificador de transação, e uma chamada repetida devolve o mesmo saldo.
Os tempos limite também têm regras. A WGC espera três segundos pela sua resposta, e uma resposta só conta com status 2xx. Se não houver resposta a tempo, a aposta é recusada ao estúdio, a operação fica desconhecida e segue-se um rollback. O rollback é repetido conforme um calendário por até 30 dias, então guarde os seus registros de operações por pelo menos esse tempo.
Inclua nos seus testes de aceitação as duplicatas concorrentes, as respostas atrasadas e uma nova tentativa depois de um tempo limite. As novas tentativas de abertura de sessão são um contrato à parte, e você não deve presumir que a carteira funciona da mesma forma. Tratar os dois contratos como cenários distintos nos seus testes facilita encontrar a origem dos erros.
Escreva com clareza a moeda e os valores
A carteira de um jogador pode usar uma moeda diferente da conta comercial do operador. Cada operação precisa identificar a sua moeda e seguir as regras de precisão combinadas. Um valor é um número, ou uma cadeia com ponto, e uma única operação pode ser de, no máximo, um milhão de USD pela taxa da rodada.
O saldo comercial com a WGC é mantido em USD e não é o saldo disponível do jogador. Não deduza um a partir do outro. Também não presuma que uma moeda exibida em um back office seja aceita por todos os jogos: um jogo que não abre em uma moeda fica marcado no catálogo. Confirme as combinações pretendidas antes de testar; assim, uma recusa no teste pode ser um limite de combinação, e não um erro da carteira.
Teste as falhas, não só o jogo bem-sucedido
Prepare verificações para os casos que mais importam:
- Fundos insuficientes. Uma recusa é escrita no corpo, por exemplo com um erro de fundos insuficientes e status 200.
- Um jogador desconhecido ou uma moeda não aceita.
- Uma assinatura inválida. Cada chamada é assinada com HMAC-SHA256; verifique a assinatura sobre o corpo bruto, compare em tempo constante e recuse chamadas com mais de cinco minutos.
- Uma resposta atrasada e uma entrega duplicada.
Guarde nos seus próprios registros a referência da transação e um número de requisição de suporte, e compare as transações aceitas nos dois lados, não apenas os saldos finais.
Um teste a seco pode validar o formato de uma mensagem, mas não pode provar que um estúdio real e a sua carteira se liquidam corretamente juntos. Para ensaiar, uma chave de teste abre um jogo de teste que faz chamadas reais à sua Callback URL sem dinheiro, e uma opção para perder a resposta testa o seu rollback. No back office, a verificação de integração mostra um registro ao vivo de cada chamada, e o teste de integração executa 14 verificações da sua carteira.
Confirme a prontidão de cada conexão
A WGC oferece um contrato de callback e um testador para preparar esse trabalho, e o Callback da carteira funciona. Os exemplos de manipuladores para Node.js, PHP e Python e um checklist de entrada no ar com 14 pontos são públicos. A prontidão de cada conexão continua sendo confirmada por projeto: converse com a equipe de integração sobre o fluxo compatível, a política de falhas e os critérios de aceitação. O seu gerente entrega diretamente os dados de acesso; eles não constam nas páginas públicas.
Para o contrato completo, leia a página da carteira seamless; para os passos ao redor, a página de integração, o modo demo e de teste e a visão geral da API de cassino.