Dados da sessão de jogo
Jogador, marca, jogo, moeda, país, idioma, modo, jurisdição e expiração do acesso.
Documentação / Fluxo de Jogos
Fluxo da API de jogos
O caminho completo desde a validação do jogador e o lançamento do jogo até apostas, ganhos, rodadas, cancelamentos de operações e conciliação financeira.
Sessão
lançamento do jogador e do jogo
Saldo
apostas e ganhos
Rodadas
fluxo da sessão de jogo
Cancelamento
recuperação de operações
Ciclo de vida do jogo
Do lançamento ao encerramento da rodada
01
Criar uma sessão de jogo
Jogador, jogo, moeda, idioma, país, modo e URL de retorno.
02
Lançar o jogo
Chave de acesso temporária, URL de lançamento e verificação da disponibilidade do jogo.
03
Processar operações financeiras
Consulta de saldo, aposta, ganho, operação combinada e respostas da plataforma.
04
Encerrar e conciliar a rodada
Resultado final, cancelamentos, razão financeiro e relatório do provedor.
Visão geral
A API de jogos conecta o jogador, a rodada e a movimentação de fundos
O lançamento do jogo e a movimentação de fundos são partes diferentes de um único processo. A sessão identifica o jogador e as condições de lançamento, a rodada conecta as ações do provedor e a API da plataforma confirma cada débito, crédito e cancelamento.
Controle de saldo
A plataforma verifica os fundos disponíveis e aplica cada aposta, pagamento ou cancelamento apenas uma vez.
Razão financeiro do jogo
Os identificadores de operação e rodada, o tipo de operação, o valor e os saldos antes e depois são mantidos para controle e conciliação.
Lançamento do jogo
Fluxo típico de lançamento do jogo
A plataforma primeiro valida o jogador e a disponibilidade do jogo, depois cria uma sessão com tempo limitado e recebe do provedor uma URL de lançamento.
01
Validar o jogador e a disponibilidade do jogo
A plataforma verifica o status da conta, moeda, país, restrições, limites, modo de dinheiro real ou demo e disponibilidade do jogo.
02
Criar uma sessão interna
Um identificador de sessão é criado com dados do jogador, jogo, marca, moeda, idioma, IP e expiração.
03
Obter a URL de lançamento do jogo
O provedor recebe a chave da sessão, URLs de notificação e retorno, tipo de dispositivo, jurisdição e parâmetros da interface.
04
Abrir o jogo no navegador
O jogador abre a URL retornada, enquanto as operações financeiras posteriores são processadas diretamente entre servidores.
Operações de saldo
Principais operações de saldo
Os nomes dos métodos variam entre provedores, mas a lógica permanece a mesma: consulta de saldo, débito da aposta, crédito do ganho e cancelamento de uma operação previamente confirmada.
Consulta de saldo
Retorna o saldo disponível do jogador na moeda da sessão ativa sem alterar o razão financeiro.
Débito da aposta
Valida jogador, sessão, moeda e fundos disponíveis e, em seguida, debita a aposta confirmada uma única vez.
Crédito do ganho
Credita os ganhos usando identificadores únicos de operação e rodada, inclusive quando o resultado é zero.
Aposta e resultado em uma única requisição
Aplica a aposta e o resultado do jogo juntos quando o provedor oferece suporte a esse modelo.
Cancelamento da operação
Cria uma operação corretiva separada para uma aposta ou pagamento previamente confirmado, sem excluir o lançamento original.
Bônus e giros grátis
Transmite dados da campanha de bônus e da rodada do jogo, mantendo separados os fundos reais e os de bônus.
Moeda e precisão do valor
Cada operação valida a moeda, as unidades de valor, as casas decimais e as regras de arredondamento.
Resposta da plataforma
Retorna o status da operação, o identificador interno, o saldo atual e um código de erro unificado.
Ciclo de vida da rodada
Ciclo de vida da rodada do jogo
Uma rodada pode incluir várias apostas e resultados. Seu estado é determinado pelas regras do jogo, e não apenas pela ordem das requisições de rede.
Rodada criada
A plataforma recebe o identificador da rodada pela primeira vez e cria um registro interno.
Rodada ativa
A rodada pode conter apostas adicionais, ações de jogo e ganhos intermediários.
Aposta aceita
O débito é confirmado pela plataforma e vinculado ao identificador único da operação do provedor.
Resultado recebido
Um ganho ou resultado zero foi recebido, mas a rodada pode continuar aberta conforme as regras do jogo.
Rodada encerrada
O provedor confirmou o fim da rodada e todas as operações financeiras esperadas foram processadas.
Operações canceladas
Uma ou mais operações foram corrigidas, preservando todo o histórico original.
Uma rodada pode incluir várias operações
O identificador da rodada não deve ser a única chave de idempotência. Cada aposta, pagamento e cancelamento deve ter seu próprio identificador único.
Confiabilidade e conciliação
Proteção contra duplicidades e conciliação financeira
A API de jogos deve tratar com segurança requisições repetidas, atrasos de resposta, operações fora de ordem e a recuperação do provedor após uma falha.
Processamento seguro de repetições
O identificador da operação do provedor é único para cada tipo de ação financeira.
Uma requisição repetida retorna o resultado original e o saldo atual sem movimentar fundos novamente.
Uma nova tentativa com valor, moeda ou jogador diferentes é rejeitada como conflito de dados.
Um cancelamento referencia uma operação original específica e também recebe seu próprio identificador único.
Razão e conciliação da rodada
Armazene os identificadores de sessão, rodada, operação do provedor e operação da plataforma.
Registre o tipo de operação, valor, moeda, saldos antes e depois e tempo de processamento.
Não altere lançamentos contabilizados; crie uma operação corretiva separada.
Concilie relatórios do provedor, rodadas de jogo, movimentações de saldo, GGR e divergências identificadas.
Testes
O que testar no ambiente de teste
As verificações devem cobrir lançamento do jogo, restrições do jogador, saldo insuficiente, operações repetidas, atrasos de resposta, cancelamentos e conciliação de uma rodada encerrada.
Lançamento e sessão de jogo
Modos de dinheiro real e demo, moeda inválida, país proibido, acesso expirado e jogo indisponível.
Rejeição de saldo e aposta
Fundos insuficientes, jogador bloqueado, divergência de moeda e limite excedido.
Atraso e resultado desconhecido
O provedor não recebe uma resposta após o débito ter sido realmente realizado e reenvia a operação com o mesmo identificador.
Apostas e ganhos repetidos
O mesmo identificador chega antes ou depois da conclusão do processamento, inclusive com parâmetros conflitantes.
Cancelamentos de operações
Cancelamento de aposta, cancelamento de ganho, cancelamento repetido e referência a uma operação original desconhecida.
Conciliação da rodada
Os valores de aposta, ganho e cancelamento, o status final, a movimentação de saldo e o relatório do provedor devem coincidir.
Checklist antes do lançamento
O lançamento ocorre depois que as sessões de jogo, operações de saldo, proteção contra duplicidades, cancelamentos e relatórios são verificados.
Os ambientes de teste e produção usam credenciais de acesso, endpoints de API e configurações de lançamento diferentes.
A chave da sessão de jogo tem tempo limitado e é vinculada ao jogador, jogo, moeda e marca.
Cada operação de saldo é protegida por um identificador exclusivo do provedor.
Apostas, ganhos e cancelamentos repetidos não alteram o saldo uma segunda vez.
Lançamentos contabilizados não são excluídos e são corrigidos por operações de ajuste separadas.
Logs de eventos, alertas, relatórios do provedor e o processo de conciliação de rodadas estão configurados.
Precisa configurar o fluxo da API de jogos?
Envie a documentação do provedor, a lista de operações de saldo, o modelo de rodada do jogo, as moedas e os requisitos de relatórios. A APIACE ajudará a estruturar o lançamento do jogo, apostas, ganhos, cancelamentos e conciliação financeira.