Quase todos os agregadores de jogos de casino se integram hoje com os operadores através de uma seamless wallet. O modelo é simples de descrever e fácil de errar em pormenores. Este guia percorre o que acontece durante uma ronda de jogo e o que testar antes de o dinheiro real começar a circular.
O princípio
O operador é dono do ledger. O saldo do jogador nunca passa para o agregador nem para o estúdio. Em vez disso, o agregador pergunta à carteira do operador qual é o saldo, diz-lhe para registar uma aposta e diz-lhe para pagar um ganho. O operador responde a cada chamada com o novo saldo ou com um erro.
Uma ronda de jogo, passo a passo
- Lançamento. O operador pede ao agregador um URL de jogo para um dado jogador, moeda e jogo. O agregador devolve um URL que o operador carrega para o jogador.
- Saldo. O jogo pede o saldo; o agregador chama o endpoint de saldo do operador.
- Débito. O jogador roda. O agregador chama o endpoint de débito do operador com um ID de transação, um ID de ronda e um montante. O operador verifica os fundos, regista a aposta e devolve o novo saldo.
- Crédito. A ronda termina. O agregador chama o endpoint de crédito com o montante ganho, que pode ser zero, e o mesmo ID de ronda.
- Rollback, se necessário. Se o débito foi registado mas a ronda falhou, o agregador envia um rollback da transação original.
Cinco regras que evitam litígios de saldo
- Idempotência em todas as chamadas. Um ID de transação repetido tem de devolver o resultado original, nunca um segundo registo.
- Só fazer rollback do que existe. Um rollback de uma transação desconhecida deve ser confirmado sem mexer em dinheiro.
- Créditos depois de rollbacks. Decida e documente o que acontece quando chega um crédito para uma ronda já revertida.
- Timeouts. Acorde quanto tempo o agregador espera e quantas vezes repete. Uma carteira lenta provoca chamadas duplicadas.
- Precisão das moedas. Acorde se os montantes são enviados em unidades ou subunidades, sobretudo para cripto com muitas casas decimais.
Testes antes do lançamento
Corra cada cenário no sandbox: fundos insuficientes, débito duplicado, crédito duplicado, rollback depois de débito, rollback de uma transação desconhecida, crédito depois de rollback e timeout da carteira. Registe cada pedido e resposta com o ID de transação, para que o apoio consiga reconstituir uma ronda contestada em minutos.
Seamless ou transfer?
As transfer wallets movem dinheiro para uma sessão e de volta. Simplificam algumas integrações com fornecedores, mas dividem o saldo entre sistemas. A seamless mantém uma única fonte de verdade, e é por isso que a maioria dos operadores a prefere. A Hub88 é um dos poucos agregadores que documenta as duas.
Perguntas frequentes
O que é uma seamless wallet?
Um modelo de integração em que o dinheiro do jogador fica no sistema do operador. O agregador ou o servidor do jogo chama o operador em cada consulta de saldo, aposta e ganho.
Qual é a diferença entre carteiras seamless e transfer?
Com uma transfer wallet, o dinheiro passa para a sessão do fornecedor de jogos e volta no fim. Com uma seamless wallet, nunca sai do ledger do operador.
O que é a idempotência numa API de carteira?
A garantia de que processar o mesmo pedido duas vezes tem o mesmo efeito que processá-lo uma vez. Cada débito e crédito leva um ID de transação único, para que uma chamada repetida não seja registada duas vezes.
O que acontece se um débito tiver sucesso mas a ronda de jogo falhar?
O agregador envia um rollback (por vezes chamado refund ou cancel) que referencia a transação original, e o operador devolve a aposta ao jogador.
Que agregadores usam uma seamless wallet?
A maioria. A SoftAggregator, a SoftGamings e a Hub88 indicam-no publicamente; a Hub88 oferece também uma opção TransferWallet.