Integração rápida de API de cassino: as etapas, na ordem

Para onde vai, de fato, o tempo da integração

Pergunte a um desenvolvedor quanto tempo leva para conectar um agregador de jogos e ele vai dizer "alguns dias". Pergunte ao operador quanto tempo passou do primeiro e-mail até a primeira aposta real e a resposta muitas vezes é semanas. A diferença está em tudo o que acontece antes de um desenvolvedor poder tocar na API: calls de descoberta, proposta, minutas de contrato indo e voltando, uma taxa de integração que precisa ser compensada, depois as chaves de sandbox e, por fim, um pedido separado para as chaves de produção.

Nós eliminamos essa etapa inicial. A nossa documentação pode ser lida antes de você se candidatar. Não há negociação de contrato nem taxa a pagar antes do acesso. Assim que a sua conta é aprovada, as credenciais e o crédito de teste já estão no seu back office, e o crédito de teste funciona na API real, então não existe troca de sandbox para produção depois.

Antes de começar: o que você precisa do seu lado

• Uma carteira de jogadores. A nossa API é uma seamless wallet: os saldos ficam na sua plataforma. Se você já tem uma, está com a maior parte do caminho andado. Se não, desenvolva ou compre isso primeiro, porque nenhum agregador consegue encurtar essa etapa por você.
• Um endpoint HTTPS público capaz de receber os nossos callbacks de carteira e responder rápido.
• A lista das moedas dos seus jogadores e dos países que você vai atender, porque ambos afetam quais jogos podem ser abertos.

Etapa 1: receba as credenciais

Solicite acesso na página da chave de API. Após a aprovação, você encontra o seu login, a sua senha e um salt secreto no back office do operador. Defina a URL para onde devemos enviar os callbacks de carteira. Essa é a única configuração necessária para começar.

Etapa 2: confirme as suas moedas

Chame o método de moedas antes de qualquer outra coisa. Ele informa quais moedas de jogador estão habilitadas para a sua conta. Pular essa etapa é o motivo mais comum de um lançamento que falha sem causa aparente: o jogador foi criado numa moeda que o jogo não aceita.

Etapa 3: puxe o catálogo

Solicite a lista de jogos. Cada título vem com um identificador estável, uma miniatura, o estúdio e um tipo de jogo padronizado. Monte as seções do lobby a partir desse campo de tipo (slots, ao vivo, crash, mesa, esportes) e não dos rótulos dos estúdios, que mudam de estilo de um estúdio para outro. Guarde os identificadores; você vai devolvê-los para abrir os jogos.

Etapa 4: crie um jogador de teste

Cadastre um jogador com nome de usuário e moeda. A moeda fica fixa para esse jogador a partir de então, então escolha com cuidado.

Etapa 5: escreva o handler de callbacks

Esta é a única parte que exige atenção de verdade. Vamos chamar o seu endpoint com três ações:

1. balance quando uma sessão é aberta,
2. debit para cada aposta,
3. credit para cada ganho.

Responda toda chamada com HTTP 200 e um corpo JSON contendo o novo saldo, com os valores como inteiros na menor unidade (2,50 vira 250). Informe problemas como saldo insuficiente por meio de um código de erro no corpo, e não por um erro HTTP. Valide a assinatura em toda requisição e faça a deduplicação pelo id de transação, para que uma chamada repetida nunca movimente dinheiro duas vezes.

Duas regras evitam a maioria dos chamados de suporte. Primeiro, nunca rejeite um callback por não reconhecer o campo de tipo; trate-o pela ação. Segundo, aceite um credit sem debit correspondente. Free spins dentro do jogo, rodadas de bônus e jackpots pagam exatamente assim, e um handler que os recusa deixa jogadores sem receber. Os rollbacks chegam com uma flag e são processados como um debit ou credit comum.

Etapa 6: abra um jogo

Peça uma URL de lançamento para um slot, enviando o jogador, o identificador do jogo, o tipo de dispositivo e o país do jogador. Abra a URL num iframe, gire com o crédito de teste e veja o debit e o credit chegando ao seu endpoint. Depois confira o histórico de rodadas do jogador para confirmar que a aposta e o ganho batem com o que o seu ledger registrou.

Um cronograma realista

Para uma equipe que já opera uma carteira, as etapas 2 a 6 cabem num único dia de trabalho; uma primeira rodada real no primeiro dia é uma meta realista. Transformar isso num lobby de produção, com o catálogo completo, cassino ao vivo, esportes, lançamentos mobile, idiomas e modo demo, costuma levar cerca de uma semana de trabalho. Equipes sem carteira devem somar o tempo que levarem para construir uma.

Adicionar cassino ao vivo ou o sportsbook não reinicia o projeto. Os dois aparecem na mesma lista de jogos, abrem com a mesma chamada de lançamento e liquidam pelos mesmos callbacks, então são apenas trabalho de front-end. A nossa página de API de apostas esportivas explica os poucos pontos específicos de esportes, como apostas que são liquidadas muito depois de feitas.

Entrando em produção

Quando os testes terminarem, carregue o crédito pré-pago (mínimo de 100 USD por recarga) e libere os jogadores reais. A comissão é descontada desse crédito conforme as rodadas com dinheiro real são liquidadas. Opera mais de uma marca? Cada site extra recebe suas próprias credenciais e URL de callback na mesma conta, sem nova integração.

Para a lista completa de métodos e campos, veja a visão geral da API do agregador de jogos de cassino. Para custos, veja preços e o guia da API de cassino grátis. Para comparar a velocidade de onboarding com outros fornecedores em bases equivalentes, use o hub de comparação.