Resposta direta
Muitos problemas em projetos de Slots API surgem porque áreas diferentes usam a mesma palavra para objetos diferentes. “Disponível”, por exemplo, pode significar apenas incluído no catálogo, validado em staging, ativado em production ou aprovado para um mercado. Definições curtas e estáveis ajudam avaliação de fornecedor, desenho da interface, testes e decisão de lançamento a apontar para o mesmo fato.
Este glossário oferece definições reutilizáveis. Os procedimentos de seleção, aceite, confiabilidade e mercado ficam nos artigos específicos.
Papéis e catálogo
| Termo | Definição prática | O que não pode ser presumido |
|---|---|---|
| Provider / fornecedor de jogos | Parte que fornece conteúdo, serviço de jogo ou interfaces relacionadas | Não prova que a AG tenha direitos de distribuição nem que o conteúdo sirva a um mercado |
| Aggregator / agregador | Camada que unifica ou coordena a integração entre uma plataforma e vários providers | Não elimina diferenças, contratos, certificações ou avaliação de mercado |
| Platform / plataforma | Sistema de contas, carteira, operação ou experiência voltada ao jogador | Não é necessariamente provider, RGS ou entidade operadora regulatória |
| Operator / entidade operadora | Entidade responsável pela operação dentro do projeto ou mercado definido; o sentido exato depende do contrato e da jurisdição | Não obtém autorização apenas por integrar uma API |
| RGS / Remote Game Server | Componente que hospeda ou coordena execução, estados e transações de jogos remotos | Não é sinônimo de agregador e não compartilha automaticamente o mesmo escopo de certificação |
| Catalog / catálogo | Conjunto de registros com origem, identidade, versão, estado e revisão | Inclusão não significa estoque em tempo real, ativação em production ou aptidão de mercado |
| Catalog Record ID | Identificador interno estável de um registro do catálogo | Não substitui o código do fornecedor ou o ID de transação |
| Provider Game Code | Código usado pelo provider ou pela interface a montante para identificar o jogo | Não deve ser deduzido do nome ou da URL da página |
| Game Version | Versão identificável do software ou conteúdo do jogo | Pode ser diferente da versão do modelo matemático |
| Math Model Version | Versão do modelo que determina probabilidades, prêmios e propriedades estatísticas teóricas | Interface inalterada não comprova modelo inalterado |
Sessão, rodada e transação
| Termo | Definição prática | O que não pode ser presumido |
|---|---|---|
| Launch / abertura do jogo | Processo em que a plataforma solicita o acesso ao jogo com parâmetros acordados | Receber uma resposta de abertura não aprova o fluxo completo nem o mercado |
| Launch URL | Endereço ou endereço com token criado para um contexto de abertura específico | Não é link público permanente e não deve ser reutilizado fora do escopo |
| Game Session / sessão de jogo | Contexto delimitado de interação para jogador, jogo, ambiente e identidade definidos | Não é conta, sessão de login, carteira nem uma única rodada |
| Round / rodada | Unidade de negócio que relaciona uma ou mais apostas e resultados conforme as regras do jogo | Uma rodada pode conter várias transações |
| Transaction / transação | Registro de negócio com efeito auditável em saldo ou estado | Uma resposta bem-sucedida não prova consistência final entre todos os sistemas |
| Bet / aposta | Transação que solicita ou confirma o débito da aposta em uma rodada | A animação do cliente não prova sucesso da transação |
| Win / prêmio | Transação que aumenta o saldo ou registra valor devido após resultado confirmado | Não promete lucro em outras rodadas ou no longo prazo |
| Refund / reembolso | Devolução total ou parcial do efeito de uma transação conforme as regras | Não deve apagar o registro original |
| Rollback / estorno | Operação rastreável que neutraliza um efeito de negócio anterior | Não é repetição arbitrária de reembolso; deve se relacionar ao evento original e ser idempotente |
| Balance / saldo | Valor monetário de uma conta e moeda em determinado instante | Uma leitura não demonstra que eventos assíncronos já foram conciliados |
| Currency / moeda | Unidade monetária e regra de precisão para exibição, aposta, liquidação ou relatório | Suporte técnico não equivale a autorização de mercado |
Carteira e confiabilidade
| Termo | Definição prática | O que não pode ser presumido |
|---|---|---|
| Single Wallet / carteira única | A plataforma mantém o saldo central e integra transações do jogo em tempo real | Não elimina timeout, duplicidade, estado desconhecido ou conciliação |
| Transfer Wallet / carteira de transferência | Valores entram e saem das carteiras da plataforma e do ambiente do jogo conforme um fluxo registrado | Não garante consistência instantânea entre os dois saldos |
| Callback | Interação em que uma parte chama o endereço acordado da outra para comunicar ou processar um evento | Ordem, unicidade e entrega exatamente uma vez dependem do protocolo |
| Idempotency / idempotência | Reprocessar a mesma intenção sem gerar efeito de negócio duplicado | Não significa apenas devolver a mesma resposta; exige reconhecer a intenção |
| Idempotency Key | Chave estável para identificar a mesma solicitação de negócio | Não deve mudar em cada tentativa nem ser reutilizada sem limite fora de seu escopo |
| Retry / retentativa | Nova tentativa sob condições, quantidade e backoff limitados | Timeout não é falha confirmada; retentativa cega pode duplicar efeitos |
| State Unknown / estado desconhecido | Estado em que o chamador não sabe, pela resposta disponível, se o negócio foi concluído | Não deve ser lançado como sucesso ou falha sem consulta ou conciliação |
| Correlation ID / ID de correlação | Identificador que conecta solicitações, callbacks, logs e registros entre sistemas | Não substitui ID de transação nem chave de idempotência |
| Reconciliation / conciliação | Comparação de registros independentes de transação, rodada ou saldo para identificar e tratar diferenças | Não substitui idempotência, consulta de estado ou controles em tempo real |
| Final State / estado final | Estado de negócio que, pelo protocolo, não muda mais no fluxo normal | Sucesso HTTP nem sempre é estado final de negócio |
Ambientes, versões e evidências de mercado
| Termo | Definição prática | O que não pode ser presumido |
|---|---|---|
| Staging | Ambiente e configurações não produtivos usados em integração, testes e aceite | Aprovação em staging não significa deployment em production |
| Production | Ambiente que processa tráfego e dados reais autorizados | Ter endereço ou credencial não aprova todos os jogos, versões e mercados |
| API Version | Versão identificável do contrato, campos e comportamentos da API | Não equivale à versão do jogo ou do modelo matemático |
| Integration Version | Registro versionado da topologia e configuração entre plataforma, agregador, RGS e provider | Mudança de componente pode invalidar evidências antigas |
| RTP / retorno teórico ao jogador | Percentual teórico médio calculado em grande número de eventos sob regras e modelo matemático definidos | Não garante resultado de uma sessão, período curto ou jogador específico |
| RNG / gerador de números aleatórios | Componente ou mecanismo que produz valores aleatórios para resultados ou processos relacionados | Mencionar RNG não comprova implementação, versão ou certificação |
| Certification / certificação ou evidência de conformidade | Evidência produzida por instituição específica para objeto, versão, requisitos e escopo definidos | Não é licença global nem cobre automaticamente entidade, marca, domínio ou versão nova |
| Integration Certification / certificação da integração | Evidência sobre uma combinação específica de plataforma, RGS, agregador, provider e interações | Não substitui outras verificações do jogo ou da entidade |
| Test Body / instituição de teste | Organização que testa ou emite relatório dentro de um reconhecimento definido | Reconhecimento por um regulador não cobre todo serviço ou relatório da instituição |
| Standard / padrão | Especificação de requisitos técnicos, testes ou controles | Usar GLI-19 não concede automaticamente acesso a uma jurisdição |
| Market Availability / aptidão para o mercado-alvo | Estado limitado por mercado, entidade, jogo, versão, certificação, moeda, idioma, direitos e decisão do projeto | Não pode ser deduzido de catálogo, idioma, moeda ou conexão isolados |
| Language Support / suporte de idioma | Idioma validado em uma interface, regra, ajuda ou comunicação específica | Não prova tradução completa, certificação nem aptidão de mercado |
Nota não verificada sobre
RTP 0–1000Essa faixa não é a definição de RTP deste glossário. Ela precisa de unidade, significado, versão do modelo matemático, permissões, testes, certificação, mercado e forma de exibição. Não deve ser apresentada como desempenho, retorno garantido ou conformidade já comprovada.
Confusões frequentes
| Afirmação ambígua | Fatos que precisam ser separados |
|---|---|
| “Está no catálogo, então está disponível” | incluído, validado em staging, ativado em production, incluído comercialmente e avaliado para o mercado |
| “Deu timeout, então falhou” | resultado de transporte, estado de negócio, falha final, retentativa segura e necessidade de conciliação |
| “Uma rodada é uma transação” | rodada é uma unidade do jogo; aposta, prêmio, reembolso e estorno podem ser transações distintas |
| “Suporta BRL e português, então pode operar no Brasil” | moeda, idioma, versão, topologia, certificação, entidade, marca, domínio e regra de mercado |
| “Tem certificação, então vale globalmente” | reconhecimento da instituição, padrão, objeto, versão, jurisdição, validade e condições do projeto |
Escopo atual e limites
A referência pública usa os conceitos de catálogo, abertura, carteira única, carteira de transferência, registros e integração. Os artigos técnicos tratam duplicidade, timeout, callback, estado desconhecido e conciliação em conjunto. Este glossário não adiciona endpoint, assinatura, credencial nem regra de produção.
O catálogo mostra 11 fornecedores e 1.194 nomes no snapshot. Isso não comprova fornecimento atual, produção, direitos, versão, certificação ou mercado. Também não se prometem campos específicos, carteira, desempenho, SLA, prazo nem aptidão de qualquer jogo, provider, moeda ou idioma.
Perguntas frequentes
Provider e aggregator são o mesmo papel?
Não. O provider fornece conteúdo ou serviço; o aggregator coordena integrações com vários providers. Uma empresa pode exercer os dois papéis, mas o projeto deve registrar cada responsabilidade.
Callback, transaction e round devem compartilhar um único ID?
Em geral, não. Callback é uma forma de interação, transaction é um evento de negócio e round é a unidade do jogo. Cada um precisa de identificador adequado e a correlação deve conectá-los conforme o contrato.
RTP indica quanto o jogador recebe em cada sessão?
Não. É uma medida teórica de longo prazo sob regras e modelo definidos. Qualquer valor precisa estar ligado à versão, evidência e escopo de apresentação.
Leituras relacionadas e próximo passo
- API de slots multiprovedor
- Agregação ou integração direta
- Avaliação de fornecedor
- Aceite de staging para production
- Idempotência, retentativas e conciliação
- Governança do catálogo
- Matriz de mercado e certificação
Páginas relacionadas: referência pública da API, catálogo e processo de integração.
Ao usar “Fale conosco”, descreva mercado, catálogo, modelo de carteira, ambiente e versões com estes termos. A conversa não constitui compromisso de fornecimento, certificação ou lançamento.
Fontes e aplicabilidade
As referências de mercado e terminologia são o RTS 3 da UK Gambling Commission, as questões técnicas da SPA e os padrões da GLI. Elas explicam conceitos em seus escopos e não comprovam que um projeto atenda a esses requisitos.
Precisa transformar estas orientações em um plano de projeto?
Este artigo apoia a avaliação do projeto e não substitui a validação técnica, contratual, de certificação ou da legislação local.