API de cassino online

Seamless wallet ou transfer wallet

Existem dois modelos de carteira na agregação de cassino. Na seamless wallet (carteira integrada, ou carteira única) o provedor do jogo chama sua carteira a cada aposta e a cada prêmio em tempo real; o jogador tem um saldo único para tudo. Na transfer wallet os recursos são movidos para um subsaldo do provedor antes do jogo e de volta depois. A seamless é o que os jogadores esperam e o que os reguladores preferem para fins de relatório; a transfer sobrevive apenas em alguns estúdios legados. Nossa API é seamless em primeiro lugar: você implementa quatro callbacks (balance, debit, credit, rollback) uma vez, e todo estúdio por trás da agregação os utiliza.

O que o modelo de carteira muda depois que você está no ar

A escolha costuma ser feita em cima de um diagrama e paga na operação. A tabela confronta os dois modelos com o que seu caixa, seu suporte e seu time financeiro fazem todos os dias.

Nossa API é seamless em primeiro lugar, e um estúdio que só oferece transfer é carregado como exceção por trás dela, não como um segundo modelo no seu caixa. A pergunta que vale fazer sobre um estúdio desses é se seus jogadores pedem por ele pelo nome. Se pedem, a cauda operacional acima é um preço que vale pagar. Se ele está ali para aumentar a contagem do catálogo, não vale.

O ciclo de vida do lançamento e da sessão

Oito passos acontecem entre o jogador clicar em um jogo e a rodada fechar. Os dois que surpreendem os times que constroem sua primeira carteira são o quinto e o sétimo.

1. Seu servidor solicita uma URL de lançamento, passando o jogador, a moeda, o idioma, o contexto da licença e se a sessão é real ou demo. Nós a assinamos. A URL é de uso único e de curta duração, então não pode ser compartilhada nem reproduzida.
2. O navegador abre o jogo no estúdio. A partir daí a sessão pertence ao estúdio.
3. O estúdio pede o saldo. Sua carteira responde. Este é o único dos quatro callbacks que não movimenta dinheiro.
4. Cada giro ou mão envia um débito com um identificador de rodada e um identificador de transação. O identificador de rodada agrupa tudo o que pertence a uma rodada de jogo; o identificador de transação é o que você torna idempotente.
5. Um prêmio envia um crédito contra o mesmo identificador de rodada. Algumas rodadas creditam mais de uma vez — rodadas de free spins e recursos de bônus fazem isso — então uma rodada não é um débito e um crédito.
6. A rodada fecha. Até que isso aconteça, ela ainda pode receber um rollback.
7. Um rollback reverte uma transação nomeada dentro de uma rodada: um giro que falhou, um erro do lado do estúdio, um timeout. Ele pode chegar depois que o crédito já foi aplicado, e é por isso que a certificação roteiriza exatamente essa ordem.
8. A sessão termina quando o jogador sai ou quando o estúdio a encerra. Uma queda de conexão no meio da rodada é resolvida pelas regras do próprio estúdio: alguns retomam a rodada no retorno, outros a concluem no servidor e creditam. Seu livro-razão precisa aceitar as duas coisas.

O que a API cobre

• Catálogo de jogos: jogos com metadados (estúdio, tipo, RTP, volatilidade, recursos, moedas e jurisdições suportadas) filtrados automaticamente para o que sua licença permite.
• Lançamento: URLs assinadas de abertura de jogo para jogo real e demo, com contexto de jogador, moeda, idioma e licença.
• Callbacks de carteira: balance, bet, win, rollback; idempotentes, com identificadores de rodada e de transação para reconciliação.
• Bônus: free spins e dinheiro de bônus orquestrados entre estúdios; conjuntos de regras por mercado, para que uma marca finlandesa possa ficar travada apenas em retenção com teto de rollover de 5× enquanto uma marca offshore não fica.
• Jackpots e torneios: jackpots de rede e locais, placares de líderes, torneios de estúdio.
• Relatórios: histórico de rodadas para suporte ao jogador e disputas, GGR (receita bruta de jogo) por jogo e estúdio, exportações ao regulador nos formatos exigidos pelas licenças que atendemos.

Conteúdo

Agregadores publicam o tamanho de seus catálogos: a Hub88 declara mais de 26,000 jogos; EveryMatrix e SOFTSWISS são reportadas com 40,000 a 45,000 jogos de 300 a 355 estúdios. O número que importa a um operador é menor: os jogos que sua licença e as listas de jurisdição dos estúdios-alvo permitem ao mesmo tempo, nas moedas que seus jogadores usam. Entregamos essa lista para a sua licença específica no escopo, em vez de uma contagem de manchete.

Quanto vale um número de catálogo de manchete

Divida as contagens publicadas de jogos pelas contagens publicadas de estúdios e os três catálogos acima chegam ao mesmo lugar. A última coluna é essa divisão, e ela é a taxa de conversão entre o número do slide e a discussão que você está de fato tendo.

Um estúdio vale entre aproximadamente 125 e 175 jogos em qualquer um deles. Ou seja, você não está comparando jogos, está comparando estúdios, e um estúdio que não atende sua licença vai embora com a prateleira inteira. A tabela abaixo lista o que tira um estúdio da sua lista e quanto isso custa nessas proporções.

É por isso que a contagem que entregamos vem no escopo. Ela é uma consulta às listas de jurisdição dos estúdios por trás da agregação, e rodá-la exige sua licença e sua lista de mercados. Um número de manchete não exige nem uma coisa nem outra, e é por isso que é ele que acaba publicado.

Certificação antes das chaves de produção

Seus callbacks de carteira são testados contra um conjunto roteirizado de casos-limite antes de liberarmos o acesso de produção: um débito duplo em uma conexão instável, um rollback que chega depois que o prêmio já foi creditado, uma divergência de moeda entre a sessão de jogo e a carteira, e uma rodada que cai no meio do jogo. REST com requisições assinadas, um sandbox com ambientes de teste reais dos estúdios, duas a seis semanas do acesso ao sandbox até as chaves de produção para um time de plataforma que já construiu uma carteira antes.

Em que se gastam as duas a seis semanas

A faixa é o seu trabalho, não uma fila em que você espera. A tabela traz o mesmo trabalho em dias-engenheiro, e a amplitude é a diferença entre um time que já construiu uma seamless wallet e um time construindo a primeira.

De doze a trinta e sete dias-engenheiro, que são as duas a seis semanas desta página para um engenheiro que tem outras tarefas. O que empurra um time para além do teto é quase sempre o livro-razão, não a API. Três coisas fazem isso. Um saldo calculado na leitura em vez de armazenado, de modo que um rollback não tem o que reverter. Uma tabela de transações sem chave natural para tornar idempotente. E dinheiro guardado como número de ponto flutuante. As duas primeiras são reescritas. A terceira aparece na certificação como divergência de moeda e diferença de arredondamento de uma unidade menor.

Perguntas frequentes