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, rondas, cancelamentos de operações e reconciliação financeira.
Sessão
lançamento do jogador e do jogo
Saldo
apostas e ganhos
Rondas
fluxo da sessão de jogo
Cancelamento
recuperação de operações
Ciclo de vida do jogo
Do lançamento ao encerramento da ronda
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 ronda
Resultado final, cancelamentos, razão financeiro e relatório do fornecedor.
Visão geral
A API de jogos liga o jogador, a ronda 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 ronda liga as ações do fornecedor e a API da plataforma confirma cada débito, crédito e cancelamento.
Controlo 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 ronda, o tipo de operação, o valor e os saldos antes e depois são mantidos para controlo e reconciliaçã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 fornecedor uma URL de lançamento.
01
Validar o jogador e a disponibilidade do jogo
A plataforma verifica o estado 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 fornecedor 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 devolvida, 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 fornecedores, 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
Devolve o saldo disponível do jogador na moeda da sessão ativa sem alterar o registo 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 ronda, inclusive quando o resultado é zero.
Aposta e resultado numa único pedido
Aplica a aposta e o resultado do jogo juntos quando o fornecedor oferece suporte a este modelo.
Cancelamento da operação
Cria uma operação corretiva separada para uma aposta ou pagamento previamente confirmado, sem eliminar o lançamento original.
Bónus e giros grátis
Transmite dados da campanha de bónus e da ronda 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
Devolve o estado da operação, o identificador interno, o saldo atual e um código de erro unificado.
Ciclo de vida da ronda
Ciclo de vida da ronda do jogo
Uma ronda pode incluir várias apostas e resultados. Seu estado é determinado pelas regras do jogo, e não apenas pela ordem dos pedidos de rede.
Ronda criada
A plataforma recebe o identificador da ronda pela primeira vez e cria um registo interno.
Ronda ativa
A ronda 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 fornecedor.
Resultado recebido
Um ganho ou resultado zero foi recebido, mas a ronda pode continuar aberta conforme as regras do jogo.
Ronda encerrada
O fornecedor confirmou o fim da ronda 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 ronda pode incluir várias operações
O identificador da ronda não deve ser a única chave de idempotência. Cada aposta, pagamento e cancelamento deve ter o seu próprio identificador único.
Fiabilidade e reconciliação
Proteção contra duplicidades e reconciliação financeira
A API de jogos deve tratar com seguranço pedidos repetidos, atrasos de resposta, operações fora de ordem e a recuperação do fornecedor após uma falha.
Processamento seguro de repetições
O identificador da operação do fornecedor é único para cada tipo de ação financeira.
Um pedido repetido devolve o resultado original e o saldo atual sem voltar a movimentar fundos.
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 o seu próprio identificador único.
Razão e reconciliação da ronda
Armazene os identificadores de sessão, ronda, operação do fornecedor 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 fornecedor, rondas 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 reconciliação de uma ronda 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 fornecedor 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.
Reconciliação da ronda
Os valores de aposta, ganho e cancelamento, o estado final, a movimentação de saldo e o relatório do fornecedor devem coincidir.
Lista de verificação antes do lançamento
O lançamento ocorre depois da verificação das sessões de jogo, operações de saldo, proteção contra duplicados, cancelamentos e relatórios.
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 fornecedor.
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 fornecedor e o processo de reconciliação de rondas estão configurados.
Precisa configurar o fluxo da API de jogos?
Envie a documentação do fornecedor, a lista de operações de saldo, o modelo de ronda do jogo, as moedas e os requisitos de relatórios. A APIACE ajudará a estruturar o lançamento do jogo, apostas, ganhos, cancelamentos e reconciliação financeira.