Integração de carteira seamless para plataformas de cassino

Em um modelo de carteira seamless, o dinheiro do jogador fica do lado do cassino. A WGC não guarda carteiras de jogadores: quando um jogo precisa de um saldo ou deve registrar uma aposta, a WGC envia uma requisição assinada à sua plataforma e usa a sua resposta. Esta página explica o contrato em termos práticos para a equipe que constrói o manipulador.

Como o modelo funciona

Os jogadores e os saldos vivem na sua plataforma. A WGC faz requisições POST ao Callback URL que você registra, com três comandos: getBalance para ler o saldo, writeBet para registrar uma aposta e o seu ganho, e rollback para cancelar uma aposta. A única exceção é um cliente de demo criado pela equipe da WGC, que usa uma carteira de teste da WGC.

writeBet leva uma aposta e o seu ganho em uma única chamada. Quando um estúdio informa a aposta e o resultado separadamente, a WGC os une em uma só rodada com um identificador de rodada, e as duas chamadas viajam dentro dela. O tipo da operação é play, refund ou, quando os jackpots estão ativados, jackpot, e uma marca de rodada finalizada indica o fim da rodada.

A idempotência faz parte do contrato

O seu manipulador deve registrar writeBet uma única vez por transactionId. Uma chamada repetida não deve debitar o jogador duas vezes e deve devolver o mesmo saldo. Isso é uma condição da integração, e não um extra opcional, porque falhas de rede tornam as repetições normais e a mesma operação chegar uma segunda vez é algo corriqueiro.

Assinaturas

Cada chamada é assinada com HMAC-SHA256 e o segredo da sua conta. Há dois cabeçalhos disponíveis: uma assinatura sobre o corpo e uma segunda assinatura sobre o carimbo de tempo unido ao corpo, junto com o próprio carimbo de tempo. Uma integração nova deve verificar a segunda. Verifique a assinatura sobre o corpo bruto antes de analisar o JSON, compare em tempo constante e rejeite chamadas com mais de cinco minutos. A documentação inclui exemplos de assinatura com um segredo de teste, para que você possa comparar o seu próprio código de verificação. Veja também segurança.

Tempos limite, novas tentativas e rollback

A WGC espera pela sua resposta por três segundos. Uma resposta só conta com status 2xx. Uma recusa é expressa no corpo, por exemplo com um erro de saldo insuficiente e status 200, e redirecionamentos não são seguidos. Se não houver resposta a tempo, a aposta é recusada ao estúdio, a operação passa a desconhecida e chega um rollback.

Um rollback pede que você cancele uma aposta inteira: devolver a aposta e retirar o ganho. A WGC o repete após cerca de um minuto, depois aos 5, 15, 60, 360 e 1.440 minutos, e em seguida diariamente por até 30 dias a partir da aposta. A sua plataforma guarda os registros das operações por pelo menos 30 dias. Aceitar o comando rollback é opcional para você; uma resposta de não encontrado ou não permitido a esse comando também não é um erro.

Há outros limites que vale conhecer. Uma aposta que esperou dentro da WGC mais de um segundo e meio não é enviada a você e nada é debitado do jogador. Uma única operação pode ser, no máximo, de um milhão de USD na taxa da rodada.

Endereço do Callback

Use, de preferência, um endereço público https://. Endereços privados e de loopback são recusados ao salvar, apenas as portas 443 e 80 são usadas e a sua resposta não deve passar de 64 KB. Os endereços de onde a WGC faz as suas chamadas são informados a você com antecedência, e você é avisado antes que mudem.

Verifique o seu manipulador

Os exemplos e uma verificação própria são públicos e não exigem login: manipuladores para Node.js, PHP e Python, um script de verificação e uma lista de entrada em produção com 14 pontos. No backoffice, o teste de integração executa 14 verificações da sua carteira e diz o que corrigir; a verificação de integração mostra um registro ao vivo de cada chamada, com requisição e resposta.

O modo de teste inclui uma opção de perder a resposta, que verifica o seu rollback: a operação passa a desconhecida e, após um minuto, chega um rollback. Leia mais em demo e modo de teste e nas etapas de integração.

Depois da rodada

A sua plataforma também pode consultar uma operação, uma rodada ou uma sessão pelos seus próprios números. Uma operação tem o status aceita, recusada, falha ou desconhecida. A WGC guarda para os relatórios o status, o tempo de resposta e os primeiros 1.024 caracteres da sua resposta. Conheça a API de cassino, a visão geral do agregador de jogos e o artigo sobre carteira seamless.

Perguntas frequentes

A WGC mantém os saldos dos jogadores?

Não. Os saldos ficam na sua plataforma; a WGC chama o seu Callback URL.

O que acontece se o meu servidor for lento?

Passados três segundos, a aposta é recusada ao estúdio e depois cancelada com um rollback.

O comando rollback é obrigatório?

Não. O seu manipulador não é obrigado a aceitá-lo; é opcional.

Como testo o manipulador?

Use os exemplos públicos, o script de verificação e o modo de teste; o teste de integração do backoffice também diz o que corrigir.

Pronto para conectar a sua carteira? Vamos conversar sobre sua integração.

Sua próxima conexão
começa aqui.

Conte o que você está construindo. A partir daí, seguimos juntos.

Fale conosco