Perguntas técnicas e operacionais

Integração técnica e operações: transações rastreáveis e recuperáveis.

Respostas para tecnologia, operações e conciliação avaliarem uma API de vários provedores, da sessão à continuidade do serviço.

Fale conosco Ver documentação da API

Arquitetura de carteiraIdempotência e conciliaçãoSegurança da APIDisponibilidade e migração

Atualizado em: 2026-09-06

Integração e transações

Primeiro, conecte sessões e transações de carteira

Defina sequência, responsabilidades e tratamento de duplicidade e timeout.

Qual é a diferença entre carteira única e carteira de transferência?

Resposta direta

Na carteira única, a operadora mantém o saldo principal e o jogo a consulta para apostas e pagamentos. Na carteira de transferência, o valor passa primeiro para uma carteira do jogo e retorna por outro fluxo.

A carteira única centraliza o saldo, mas exige interface confiável, concorrente e idempotente. A transferência reduz callbacks durante o jogo, porém acrescenta entrada, saída, sincronização e conciliação de valores em trânsito.

Como isso se aplica à AG GAME

A AG GAME suporta os dois modelos. Escolha antes dos testes, pois endpoints, estados e cenários de homologação diferem.

Qual é o fluxo completo para listar e abrir um jogo?

Resposta direta

Sincronize provedores, categorias e jogos, confirme disponibilidade, crie a sessão com comerciante, jogador, jogo, idioma, moeda e retorno e entregue o resultado de abertura ao front-end.

Teste também identidade estável, expiração, abertura repetida, dispositivos, manutenção, parâmetros inválidos e retorno. Estar no catálogo não garante criação de sessão.

Como isso se aplica à AG GAME

A API AG GAME v5.0.0 oferece consultas unificadas e sessões; campos e endpoints atuais estão na documentação.

Como saldo, aposta, pagamento e reversão trabalham juntos?

Resposta direta

O jogo consulta o saldo quando necessário, uma aposta aceita debita o razão da operadora e o resultado gera pagamento. A reversão referencia a transação original e cria uma alteração rastreável.

Não dependa apenas da ordem de chegada. Use tipo, ID único, referência original, rodada e estado final. Aposta e pagamento podem chegar separados, e timeout não significa falha.

Como isso se aplica à AG GAME

A AG GAME correlaciona rastreamento, transações e rodadas; direção e campos dependem da carteira.

Como evitar débitos ou pagamentos duplicados?

Resposta direta

Atribua um ID estável e único a cada transação e imponha unicidade no razão. Repetir o ID deve devolver o resultado original sem alterar o saldo novamente.

Cubra duplicidades concorrentes, repetição de rede e recuperação em armazenamento persistente. Rejeite e registre um ID reutilizado com conteúdo diferente.

Como isso se aplica à AG GAME

Callbacks da AG GAME usam transactionId para idempotência e reqTraceId para rastreamento; a carteira do cliente deve persistir estado e responder de modo consistente.

O que fazer após timeout, desconexão ou interrupção do jogo?

Resposta direta

Timeout significa que não houve resposta definitiva no prazo, não que a operação falhou. Consulte ou concilie a transação original antes de repetir, reverter, compensar ou aguardar a rodada.

Desconexão não cancela transação aceita. Defina limites de repetição, intervalo, estados finais, rodadas abertas, escalonamento e auditoria, e reproduza nos testes.

Como isso se aplica à AG GAME

Após timeout em transferência, a AG GAME exige consultar o merchantTransactionId original antes de reenviar; duplicidades de callback usam transactionId.

Dados e desempenho

Torne saldos, moedas e desempenho verificáveis

Use identificadores compartilhados, definições explícitas e medição por camada.

Como usar IDs de transação e rodada na conciliação?

Resposta direta

Use o ID único para uma entrada do razão, o ID de rodada para agrupar apostas, pagamentos, reversões e compensações e concilie relatórios com mesma moeda, fuso e estados.

Guarde requisições, respostas, horários, precisão, vínculos e estado final. Saldo de tela ou amostra não substitui o razão. Exceções precisam de responsável e conclusão.

Como isso se aplica à AG GAME

Rastreamento, transactionId, merchantTransactionId e rodada têm usos distintos na AG GAME; informe os IDs do modelo de carteira.

Como tratar códigos de moeda, precisão e moeda de liquidação?

Resposta direta

Acorde códigos, unidade mínima, casas decimais, arredondamento e disponibilidade. Use inteiros da unidade mínima ou decimal fixo, não ponto flutuante binário.

Se jogo e liquidação usam moedas diferentes, defina fonte, horário e direção do câmbio e tratamento de diferenças. Toda conversão deve ser explícita e rastreável.

Como isso se aplica à AG GAME

Os 35 códigos de país ou moeda da AG GAME indicam escopo; códigos, precisão e liquidação do projeto são confirmados em testes e contrato.

Como medir latência da API, carregamento e concorrência?

Resposta direta

Latência da API mede requisição e resposta; carregamento mede abertura até interação; concorrência mede correção e latência-alvo sob volume e mix definidos.

Informe região, rede, dispositivo, endpoint, amostra, P50/P95/P99, erros, cache e período. Uma média isolada não descreve picos nem capacidade.

Como isso se aplica à AG GAME

A AG GAME publica latência média ao usuário abaixo de 150 ms e capacidade diária de 100 milhões de ordens; ambas exigem validação por região, rede e carga e não são garantias fixas por requisição.

O que uma CDN global melhora e quais atrasos permanecem?

Resposta direta

A CDN aproxima imagens, scripts e outros recursos estáticos armazenáveis. Sessões dinâmicas, carteira e serviços de provedores ainda acessam origem ou sistemas de negócio.

Rede, DNS, TLS, dispositivo, tamanho, cache, servidores regionais, provedor e carteira da operadora afetam a experiência; meça cada camada.

Como isso se aplica à AG GAME

A AG GAME usa quatro centros regionais e mais de 200 nós CDN. O projeto ainda deve testar recursos, sessões e carteira nas regiões-alvo.

Segurança e continuidade

Controle credenciais, incidentes, versões e migração

Leve limites de segurança e recuperação para a integração e manutenção.

Como implementar assinatura, chaves, acesso e separação de dados?

Resposta direta

Use assinatura criptográfica para verificar origem e integridade, limite credenciais por finalidade e ambiente e separe comerciantes, chaves, dados e logs de teste e produção. Não exponha segredos no front-end ou repositório público.

Defina tolerância de horário, nonce contra repetição, emissão e troca de chaves, acesso anômalo e logs mínimos. Assinatura não substitui TLS, autorização e validação contábil.

Como isso se aplica à AG GAME

A AG GAME usa HMAC-SHA256 com merchantCode, timestamp, nonce, signType e corpo no fluxo atual; credenciais de produção são controladas por projeto.

Como tratar falhas de provedor, manutenção e recuperação?

Resposta direta

Diferencie falha de jogo, provedor, agregação, carteira e rede; desabilite ou degrade apenas o escopo conhecido, comunique estado e verifique transações antes de restaurar gradualmente.

Defina monitoramento, aviso, metas, limites e registro. Não prometa isolamento sem evidência da arquitetura e do incidente.

Como isso se aplica à AG GAME

A AG GAME oferece suporte 24/7 e visa detectar em segundos e responder em minutos; isolamento e recuperação dependem do incidente e projeto.

Como atualizar API ou migrar agregador sem perder transações abertas?

Resposta direta

Congele mapeamentos, crie matriz de compatibilidade e rollback, valide com tráfego de teste e mova novas sessões em etapas, mantendo o caminho antigo para sessões e rodadas existentes.

Preserve vínculos de jogador, jogo, transação e rodada; defina corte, consulta de abertos, retenção de relatórios e diferenças. Não encerre com saldos ou estados desconhecidos.

Como isso se aplica à AG GAME

A API pública atual da AG GAME é v5.0.0. O plano depende da versão, carteira e inventário de transações abertas.

Como verificar origem, disponibilidade e documentos dos jogos?

Resposta direta

Parta da lista de provedor, jogo, versão e região. Confirme cadeia de origem, escopo, validade e restrições e relacione acordos, confirmações ou testes à lista.

Catálogo ou link de abertura prova disponibilidade técnica, não uso universal. A suficiência das evidências depende do projeto e requisitos; pode exigir revisão especializada.

Como isso se aplica à AG GAME

A AG GAME confirma provedores e jogos conforme regiões e projeto. Catálogo, idiomas e moedas públicos não substituem evidências do projeto.

AG GAME

Precisa de campos e exemplos de requisição?

Consulte a documentação da API AG GAME para endpoints, autenticação, estruturas e erros atuais, ou fale com a equipe técnica sobre capacidade e lançamento.

Ver documentação da API Falar com a equipe técnica

Qual é a diferença entre carteira única e carteira de transferência?

Qual é o fluxo completo para listar e abrir um jogo?

Como saldo, aposta, pagamento e reversão trabalham juntos?

Como evitar débitos ou pagamentos duplicados?

O que fazer após timeout, desconexão ou interrupção do jogo?

Como usar IDs de transação e rodada na conciliação?

Como tratar códigos de moeda, precisão e moeda de liquidação?

Como medir latência da API, carregamento e concorrência?

O que uma CDN global melhora e quais atrasos permanecem?

Como implementar assinatura, chaves, acesso e separação de dados?

Como tratar falhas de provedor, manutenção e recuperação?

Como atualizar API ou migrar agregador sem perder transações abertas?

Como verificar origem, disponibilidade e documentos dos jogos?

Precisa de campos e exemplos de requisição?

Fale conosco

Configurações de análise