API de agregador de jogos de cassino: como ela é montada

O formato da API

As requisições do seu lado vão para um único endpoint como corpos JSON via POST. Cada uma leva o seu login, a sua senha e o nome do método desejado. As respostas voltam em JSON. Não há URLs base separadas por produto nem uma segunda especificação para cassino ao vivo ou esportes: uma única API de iGaming cobre todo o catálogo de mais de 40.000 jogos e o sportsbook.

O tráfego no sentido contrário, de nós para você, é a seamless wallet: chamamos o seu servidor sempre que o saldo de um jogador precisa ser lido ou alterado. Esses callbacks chegam como requisições HTTP GET assinadas, com parâmetros na query string.

Métodos que você chama

Lista de jogos

A lista de jogos é a espinha dorsal do seu lobby. Cada item tem um identificador estável que você armazena e devolve sem alteração ao abrir o jogo. O campo de tipo de jogo já vem padronizado entre os estúdios, então você monta as seções "Slots", "Ao vivo", "Crash", "Mesa" e "Esportes" direto da resposta. As mesas ao vivo e o sportsbook são simplesmente itens dessa lista.

Lançamento

Para abrir um jogo, você envia o jogador, o identificador do jogo, o dispositivo (desktop ou mobile) e o país do jogador, além de um idioma opcional. Você recebe uma URL para carregar num iframe. O país importa: alguns estúdios excluem certos mercados, e aplicamos isso com base no país que você envia, nunca adivinhando pelo endereço IP. Envie-o em todo lançamento com dinheiro real.

Demo

Cerca de 16.000 slots podem ser abertos em modo demo seguindo o mesmo padrão. Não é preciso cadastro de jogador e nenhum callback é disparado, o que torna os lançamentos demo seguros em páginas públicas.

Callbacks de seamless wallet

O dinheiro do jogador nunca sai da sua plataforma. Enviamos três ações para a sua URL de callback:

• balance: lê o saldo atual do jogador, normalmente quando uma sessão é aberta.
• debit: uma aposta. Subtraia o valor e retorne o novo saldo, ou retorne um código de saldo insuficiente com o saldo atual.
• credit: um ganho. Some o valor e retorne o novo saldo.

Cada chamada traz um id de transação único, um id de rodada e o identificador do jogo. Os valores são inteiros na menor unidade da moeda. O seu endpoint sempre responde HTTP 200; o resultado vai no corpo JSON como código de erro: sucesso, saldo insuficiente ou erro de processamento.

Rollbacks

O rollback não é uma ação separada. Ele chega como um debit ou credit com uma flag de rollback, e você o processa como qualquer outra movimentação. A sua deduplicação pelo id de transação é o que garante a segurança.

Segurança

Todo callback inclui um timestamp e uma chave derivada desse timestamp e do seu salt secreto. Rejeite qualquer chamada fora de uma janela de tempo curta ou com uma chave que não confere. Para uma proteção mais forte, cada callback também traz um cabeçalho HMAC-SHA256 calculado sobre todos os parâmetros, de modo que um valor ou nome de usuário adulterado não passa na validação.

Free spins e rodadas grátis

Duas coisas diferentes têm esse nome, e vale ser preciso.

Os free spins dentro do jogo funcionam em todo o catálogo sem nada a desenvolver. Free spins acionados por scatter, rodadas de bônus, feature buys e jackpots rodam dentro do jogo, e os ganhos chegam a você como credits comuns, muitas vezes sem um debit correspondente. O seu handler precisa aceitar esses credits.

As rodadas grátis promocionais, aquelas que você concede ao jogador como oferta de boas-vindas, não são chamadas de API self-service do nosso lado. Se o seu plano de bônus depende de conceder rodadas grátis, fale com a gente antes de desenvolver e diremos o que é possível combinar para os jogos que você tem em mente.

Moedas

A moeda é definida por jogador. Uma conta pode atender jogadores em muitas moedas, ou um site pode ficar travado numa só. A principal linha de slots multiestúdio e o sportsbook suportam 38 moedas ISO, entre elas EUR, USD, GBP, CAD, AUD, BRL, MXN, ARS, INR, BDT, PKR, IDR, PHP, THB, VND, TRY, ZAR e ETB. As outras linhas acrescentam ou retiram moedas de estúdio para estúdio, então trate o método de moedas como a fonte oficial, e não qualquer folheto.

Sportsbook pela mesma API

O sportsbook do nosso catálogo, o Nocturn Sport, abre com a mesma chamada de um slot e liquida pelos mesmos três callbacks. As apostas pré-jogo e ao vivo debitam o jogador quando são feitas e creditam quando são liquidadas, o que pode acontecer horas ou dias depois numa aposta de longo prazo. Esports como CS2, Dota 2 e Valorant ficam lado a lado com futebol, tênis e basquete. Nossa participação no GGR do sportsbook é de 12%. Os detalhes específicos de esportes estão na página de API de apostas esportivas.

Configurações multimarca

Operadores com vários sites não integram duas vezes. Cada marca adicional recebe suas próprias credenciais e URL de callback dentro da mesma conta, e o catálogo pode variar por site se as suas licenças exigirem.

Próximos passos

Siga a ordem passo a passo em integração rápida de API de cassino, confira os custos em preços ou solicite credenciais na página da chave de API. Se você está avaliando vários agregadores, o hub de comparação mostra lado a lado como cada um documenta a sua carteira.