O que não se vê à primeira vista nas telas: o que dispara cada estado, que etapas a interface segue, qual mensagem exata o jogador vê e onde ela aparece. Cada fluxo leva à tela real para reproduzi-lo e indica o que o backend deve fornecer.
ToastAviso temporário no canto inferior direito; no celular, acima da pílula. Fecha sozinho após 4 s, pode ser deslizado e há no máximo 3 ao mesmo tempo.
AlertaCaixa colorida dentro do modal ou da tela. Fica até o estado mudar.
Erro no campoMensagem abaixo do campo, que fica marcado em vermelho. Some ao digitar de novo.
Tela de resultadoSubstitui o formulário do caixa ou da página pelo resultado final.
Diálogo de confirmaçãoModal genérico antes de uma ação irreversível, com botão principal ou de perigo.
Camada de carregamentoSpinner com título e texto sobre o modal durante o processamento. O botão mostra seu próprio texto de carregamento.
Bloco na telaCard, aviso ou estado vazio que a página mostra conforme o status do jogador.
Para integraçãoQuais dados, eventos ou validações o backend deve fornecer para que o fluxo funcione de verdade.
SucessoInformativoAvisoErroMesma cor do componente real.
Controles do protótipo
?auth=in?auth=outForça a sessão iniciada ou encerrada em qualquer URL.
#login#register#forgot-password#deposit#withdraw#search#notificationsAbrem o modal ou o painel correspondente.
Painel de camadasBotão no canto inferior direito: sessão, país, status do KYC e redefinir dados de demonstração.
?market=BR?market=GBMuda o país do site (17 mercados): moeda, pagamentos, documentos, regulador e regras de jogo. Também em Países do site, que funciona no celular.
?demo=0Oculta o painel de camadas para capturas ou demos.
Links pré-configuradosPreparam os dados de demonstração (status de KYC, saldo ou Moedas V1) antes de abrir a tela.
Nenhum fluxo corresponde à busca
Tente outra palavra, por exemplo depósito, KYC, cash out ou 666.
Acesso
Login, cadastro, recuperação de senha e ações que exigem conta. Tudo acontece em modais que abrem de qualquer tela.
Para integraçãoEndpoint de login que retorne o token de sessão, o perfil (nome, ID, nível VIP), o saldo real e de bônus, o status KYC e os giros grátis pendentes usados na saudação. A caixa “Manter conectado” define a duração do token.
Para integraçãoCódigo de erro de bloqueio com os minutos restantes. A mensagem convida a recuperar a senha, que deve continuar disponível durante o bloqueio.
Para integraçãoResponder sempre igual, exista ou não a conta. Token de uso único que expira em 30 minutos. A tela para criar a nova senha não está simulada (ver propostas).
Cadastro com e-mail: acesso, dados pessoais e confirmação.
SucessoModal de cadastro
Gatilho
JogadorToca em “Crie sua conta”, “Cadastrar-se” ou abre o hash #register.
Passos
Acesso: e-mail, senha com pelo menos 8 caracteres com medidor de força e o país do site (moeda e documento fixos).
Dados: nome, sobrenome, data de nascimento e celular.
Confirmar: bônus de boas-vindas (cassino, esportes ou sem bônus), código promocional e aceite dos termos.
Camada de carregamento enquanto a conta é criada.
Conta criada com sessão iniciada, saldo $0, verificação pendente e nível Bronze 1.
O que o jogador vê
Erro no campo · Validações de cada etapa
Digite um e-mail válido, por exemplo nome@dominio.comA senha deve ter pelo menos 8 caracteres.Digite um número de telefone válido.Você precisa aceitar os termos para criar sua conta.
Camada de carregamento · Modal de cadastro
Criando sua conta…
Isso leva só um momento.
Tela de resultado · Modal de cadastro
Conta criada!
Enviamos um e-mail de confirmação. Faça seu primeiro depósito para ativar os 200% de boas-vindas.
Para integraçãoCadastro com o país do site, dados pessoais e bônus escolhido; e-mail de confirmação e SMS para verificar o celular. A conta nova começa com KYC "Não verificado", o que bloqueia o saque até a verificação.
Para integraçãoOAuth com e-mail e nome. Mesmo que a conta venha de uma rede social, a data de nascimento e o telefone são obrigatórios antes de criá-la.
Para integraçãoTodo endpoint protegido deve responder 401 para que o front abra o login. Hoje “Resgatar” nas missões reutiliza o toast genérico de dinheiro real (ver propostas).
Conta e verificação
Status de verificação de identidade (KYC) e seu efeito em cada tela, dados pessoais, telefone, segurança, configurações e notificações.
Quatro status que mudam o menu do usuário, a página de verificação e o saque.
AvisoVerificação · Saque · Caixa · Menu
O que muda em cada tela
Status
Menu do usuário
Página Verificação
Página Sacar
Caixa · Sacar
Não verificada
Pendente
Verifique sua identidade
Formulário oculto; card para verificar
Alerta e botão desabilitado
Em análise
Em análise
Documentos em análise; envio desabilitado
Formulário oculto; aviso de análise
Alerta e botão desabilitado
Verificada
Verificada
Conta verificada · Nível 2
Formulário de saque ativo
Saque liberado
Recusada
Recusada
Motivos da recusa e etapas marcadas para corrigir
Formulário oculto; card para verificar
Alerta e botão desabilitado
Gatilho
SistemaO status muda ao se cadastrar (não verificada), ao enviar documentos (em análise) e quando o compliance aprova ou recusa.
Passos
Cadastro: a conta nasce não verificada.
Envio de documentos: passa para em análise.
Aprovação: verificada, nível 2, saques de até $10.000 por dia.
Recusa: são exibidos os motivos e as etapas a repetir.
O que o jogador vê
Bloco na tela · Verificação, não verificada
Verifique sua identidade
Precisamos do seu documento, de uma selfie e de um comprovante de residência. Analisamos em menos de 24 horas e seus dados ficam guardados com criptografia.
Bloco na tela · Verificação, em análise
Documentos em análise
Recebemos seus documentos em 12 nov às 10:42. Avisaremos você por e-mail e notificação assim que terminarmos. Tempo estimado: menos de 24 horas.
Bloco na tela · Verificação, verificada
Conta verificada · Nível 2
Você verificou sua identidade em 12 nov 2026. Pode sacar até $10.000 por dia. Envie um comprovante de residência para passar ao nível 3 e eliminar os limites.
Bloco na tela · Verificação, recusada
Não conseguimos verificar seus documentos
Analisamos sua solicitação de 12 nov e encontramos estes problemas:
A foto do verso do documento está borrada e não dá para ler os dados.
A selfie não corresponde à foto do documento por causa da iluminação.
Toast · Ao mudar o status no painel de camadas
Status KYC: Em análiseAplica-se a saques e verificação.
Para integraçãoStatus KYC (none, pending, ok, rejected), nível de verificação (1 a 3), data de envio, motivos de recusa por documento e limite de saque de cada nível. Webhook do provedor KYC para atualizar o status e enviar a notificação “Identidade verificada”.
Para integraçãoUpload de arquivos validado no servidor, sessão de prova de vida do provedor de KYC e endpoint de envio que devolva o novo status. Com a conta verificada, o nível 3 pede o comprovante de residência: “Envie o comprovante de residência para passar ao nível 3.”.
Para integraçãoOs mesmos limites no servidor (tipos de arquivo e 10 MB) e o motivo de recusa por documento, para exibi-lo na sua própria área de upload.
Para integraçãoAlterar o endereço invalida o comprovante de residência do nível 3. A troca de e-mail envia um link de confirmação e mantém o e-mail anterior até a confirmação.
Para integraçãoLista de sessões com dispositivo, localização e última atividade; revogar uma ou todas menos a atual. O texto “conectada” usa o gênero do perfil de demo: convém uma forma neutra ou com o gênero do jogador.
Para integraçãoPreferências sincronizadas entre dispositivos, exportação de dados assíncrona por e-mail e política de encerramento com saldo (bloquear até sacar ou transferir). No protótipo, encerrar a conta não encerra a sessão.
Para integraçãoFeed com tipo, título, texto, data e status de leitura; contador de não lidas (hoje fixo em 3) e endpoint para marcar como lidas. Eventos mínimos: depósito confirmado, identidade verificada, novo login, giros grátis, posição em torneio, missão nova e subida de nível.
Depósito
Duas entradas: o caixa (modal #deposit, a partir de qualquer tela) e a página Depositar. Compartilham os resultados, mas no protótipo têm métodos, limites e bônus diferentes. Os métodos, os valores mínimos e máximos, os impostos e o bônus dependem do país do site (veja Mercados e países).
Para integraçãoMétodos disponíveis por país com mínimo, máximo e prazo; cálculo do bônus no servidor (o caixa simula 200% até $1.500) e uma única resposta de pagamento com status, referência e novo saldo.
Mínimo, máximo por operação ou limite diário de jogo responsável.
ErroCaixa · Página Depositar
Gatilho
JogadorToca em continuar ou depositar com um valor fora dos limites.
Passos
O valor é validado antes de chamar o pagamento.
Caixa e página: mínimo e máximo do país (veja a tabela); o máximo cai para o que resta do limite mensal LUGAS na Alemanha.
Além disso, o limite diário de depósito que o jogador definiu em Jogo responsável.
O campo de valor mostra o erro e o fluxo não avança.
O que o jogador vê
Erro no campo · Valor no caixa
O depósito mínimo é de $10.O máximo por operação é de $10.000. Divida o depósito ou fale com o suporte VIP.
Erro no campo · Valor na página Depositar
O depósito mínimo com Transferência internacional é de $100.O máximo por operação com Apple Pay é de $5.000.Você ultrapassa seu limite diário de $500 (já depositou $100). Pode alterá-lo em Jogo responsável.
Para integraçãoLimites por método, por transação e por período (incluindo os de jogo responsável do jogador) com o valor já utilizado para montar a mensagem. Hoje o caixa não verifica o limite diário (ver propostas).
Para integraçãoTokenização do cartão (nunca guardar o número completo), 3-D Secure com desafio ou redirecionamento e resposta com status, referência (DP-…), método mascarado e saldo novo.
Para integraçãoCódigo de recusa do processador (05 não autorizada, 51 saldo insuficiente…) traduzido para um texto para o jogador. No caixa, o valor de teste (666 em moeda local, ou 6.660… se o mínimo for maior) recusa cartão, carteiras, Pix e os demais métodos instantâneos; as transferências e os pagamentos em dinheiro sempre ficam pendentes.
Para integraçãoApple Pay e Google Pay pelo processador (token do dispositivo). Carteiras: URL de redirecionamento e de retorno com o status; se o jogador não voltar, o pagamento deve ficar pendente ou cancelado.
Para integraçãoBônus elegíveis por depósito com suas regras (porcentagem, teto, rollover) e validação de cupons no servidor. Hoje o caixa e a página calculam bônus diferentes no front-end: o backend deve ser a única fonte.
Saque
Saque pelo caixa (modal #withdraw) e pela página Sacar. Só se saca saldo real e só com a identidade verificada. Os links abrem a carteira de moeda única; em multimoeda, o saque é feito por moeda (ver Saque cripto e Saque em moeda local).
Para integraçãoO servidor também deve recusar saques sem KYC aprovado e devolver o motivo. Se o formulário for enviado mesmo assim, a página avisa com o toast “Verificação necessária”.
Abaixo do mínimo, acima do saldo real ou do máximo diário.
ErroCaixa · Página Sacar
Gatilho
JogadorToca em “Solicitar saque” com um valor não permitido.
Passos
Digita o valor ou toca em “Máximo”, que preenche todo o saldo real.
É validado contra o mínimo, o saldo real e o máximo diário.
O campo mostra o erro e a ordem não é enviada.
O que o jogador vê
Erro no campo · Valor
O saque mínimo é de $20.O valor excede seu saldo disponível ($2.847,50).O máximo diário é de $10.000. Suba para o nível 3 de verificação para sacar mais.
Para integraçãoMínimo, máximo diário por nível de KYC e saldo sacável (só saldo real, sem bônus nem valores em saques pendentes). O máximo diário só é validado na página.
Para integraçãoOrdem de saque com referência (WD-…), status (pendente, em processamento, concluído, recusado) e motivo da recusa; bloqueio do valor ao solicitar e notificação a cada mudança de status. As mudanças posteriores a “Pendente” não são simuladas ao vivo (ver propostas).
Para integraçãoValidação de titularidade (microdepósito de $0,01 ou serviço bancário) antes de permitir saques para essa conta.
Mercados e países
O protótipo é um site de um único país e uma única moeda (17 mercados). Cada país muda os métodos de pagamento, os documentos, o regulador, o jogo responsável, os impostos e as regras de jogo. Aqui se explica o que o backend deve fornecer por tipo de pagamento e por país.
Para integraçãoEm produção o país vem do domínio ou da licença do site (betv1.com.br, betv1.co.uk…), não de um seletor, e não muda durante a sessão. O backend define por mercado: moeda, provedores de pagamento, documentos aceitos, regulador, textos legais, limites e regras de bônus. A moeda é uma só por jogador e não há conversão nem saldo em outras moedas.
Para integraçãoCobrança com o processador do país (3-D Secure obrigatório em GB, ES, PT, DE e recomendado nos demais). Traduzir o código de recusa (05 não autorizada, 51 saldo insuficiente…) para um texto para o jogador. Apenas cartões em nome do titular. O valor de teste muda por país porque o depósito mínimo é diferente: o caixa o mostra abaixo do campo de valor.
No Brasil, Reino Unido, Espanha e Alemanha só se aceitam cartões de débito.
ErroCaixa · Página Depositar
Gatilho
JogadorInforma um cartão de crédito em um mercado onde é proibido.
Passos
O método se chama "Cartão de débito" e o formulário avisa sobre a restrição.
O tipo de cartão é detectado pelo BIN ao terminar de digitar o número.
O botão de pagar é bloqueado e o campo mostra o erro.
O que o jogador vê
Alerta · Formulário do cartão
Só são aceitos cartões de débito no seu nome: os de crédito são proibidos pela regulamentação.
Erro no campo · Número do cartão
É um cartão de crédito: no Reino Unido só se aceitam cartões de débito.
Como verReino UnidoBrasilEspanhaAlemanhaCartão de crédito de teste 5555 5555 5555 4444 (Mastercard crédito): bloqueado apenas nesses quatro mercados
Para integraçãoConsultar o tipo de cartão (débito, crédito, pré-pago) com o processador antes de cobrar e recusar os de crédito; a UKGC proíbe desde abril de 2020, assim como a DGOJ, o GlüStV e a SPA/MF do Brasil. Registrar o motivo da recusa para o suporte.
Para integraçãoPSP com Pix (ou CoDi/Yape/SnapScan): criar a cobrança com o CPF do titular, guardar o txid, receber o callback de pagamento e conciliar pelo valor exato. Se o pagador não corresponder ao CPF da conta, devolver o pagamento. Idempotência no webhook e status "expirado" após 10 minutos.
Para integraçãoConta virtual ou referência única por jogador (CLABE dinâmica no México, conta NUBAN virtual na Nigéria) para conciliar automaticamente. Prazos: SPEI e CVU imediatos, PesaLink 1 h, EFT sul-africana 24 h, SEPA 1 dia útil. Notificar ao creditar e marcar como falha se o banco devolver a transferência.
Para integraçãoGerar a ordem de pagamento com o agregador (entidade e referência do Multibanco, CIP do PagoEfectivo, convênio do Efecty…), com vencimento e valor exato; confirmar por callback e registrar o depósito como "pendente" até então. Os depósitos em dinheiro não recebem bônus até serem creditados.
Para integraçãoURL de retorno por método com o status e uma URL de callback servidor a servidor (a de retorno não é confiável). No open banking (Trustly, Pay by Bank, Klarna) o nome do titular do banco deve coincidir com o da conta; se não coincidir, devolver o pagamento.
Para integraçãoSolicitação à operadora móvel (Daraja STK push no Quênia, SIBS em Portugal, Bizum dos bancos espanhóis…) e callback de resultado com tempo máximo. Verificar que o número pertence ao titular (M-Pesa no nome do jogador). No Quênia, o caixa mostra o detalhamento do imposto especial (ver «Impostos sobre depósitos e saques»).
O jogador disca um código no celular, sem internet, com o banco de sua escolha.
PendenteCaixa · Página Depositar
Gatilho
JogadorNa Nigéria, escolha USSD, o valor e o seu banco.
Passos
A tela mostra o código do banco com o valor e a referência já preenchidos (por exemplo *737*50*{monto}*{ref}# no GTBank).
O jogador disca do celular cadastrado no banco e escolhe a conta de origem.
Toque em «Já disquei o código»: camada de carregamento e tela de pendente.
O banco confirma e o saldo é creditado.
O que o jogador vê
Alerta · USSD
Disque este código do celular cadastrado no seu banco, volte aqui e toque em «Já disquei o código».
Camada de carregamento · Caixa
Verificando o pagamento…
Normalmente leva alguns segundos.
Como verNigéria · USSDBancos de exemplo: GTBank, Access Bank, Zenith Bank, First Bank e UBA
Para integraçãoAgregador (Paystack, Flutterwave…) que gere o código USSD por banco com referência da transação e avise por webhook. Cada banco usa um código diferente; a lista de bancos e modelos deve vir da configuração.
Para integraçãoChamada de resgate ao emissor (paysafecard, Blue Label/1Voucher) que devolva o valor e o saldo restante. Os vouchers não permitem saques: oferecer outro método no nome do jogador. No Reino Unido e na Alemanha contam para o limite de depósito.
Cada país pede outros dados de destino; o saque sempre vai para uma conta ou carteira em nome do jogador verificado.
SucessoCaixa · Página Sacar
Gatilho
JogadorCom a identidade verificada, escolha o método de saque do país e informe os dados de destino.
Passos
Aparecem apenas os métodos de saque do país (mais curtos que os de depósito).
O formulário muda conforme o método: chave Pix, CLABE, CVU, CCI, IBAN, sort code, NUBAN, telefone…
O formato é validado no campo e, quando existe, o nome do titular é resolvido com o banco.
Mostra-se o detalhamento com impostos e o saque é confirmado.
O pedido fica «em análise» e sai após a revisão de segurança; o saldo é debitado ao solicitá-lo.
O que o jogador vê
Erro no campo · Chave Pix
A conta do Pix precisa estar no seu CPF; se não coincidir, o saque é recusado.
Erro no campo · CLABE
A CLABE deve ter 18 dígitos.
Erro no campo · NUBAN
Nome verificado com o seu BVN.
Tela de resultado · Caixa
Saque solicitado
Revisamos cada saque por segurança antes de enviá-lo. Avisaremos você quando sair.
País
Método
Dados do saque
Validação
Brasil
Pix · TED
Chave Pix (CPF, e-mail, celular ou aleatória) · banco, agência e conta
A chave Pix deve ser do CPF do jogador
México
SPEI
CLABE interbancária de 18 dígitos
Dígito verificador da CLABE
Argentina
CVU / CBU · Mercado Pago
CVU ou CBU de 22 dígitos, ou alias
Titular com o DNI ou CUIL
Chile
Transferência · MACH
Banco, tipo e número da conta · telefone
Conta com o RUT do jogador
Colômbia
Conta bancária · Nequi
Banco e conta · celular
Conta em nome do titular
Peru
Interbancária · Yape
CCI de 20 dígitos · celular
O CCI deve ter 20 dígitos
Espanha · Alemanha
SEPA
IBAN
Dígitos de controle do IBAN
Reino Unido
Faster Payments
Sort code de 6 dígitos e número de conta de 8
O sort code tem 6 dígitos
EUA
ACH · cheque
Routing number (ABA) de 9 dígitos e conta · endereço para o cheque
O routing number tem 9 dígitos
Canadá
Interac · EFT
E-mail do Interac · trânsito, instituição e conta
E-mail ou conta em nome do titular
Nigéria
Transferência · OPay
Número NUBAN de 10 dígitos
Resolução de nome: «Nome verificado com o seu BVN.»
Quênia
M-Pesa · PesaLink
Celular M-Pesa registrado no nome dele
Nome do titular do número
África do Sul
EFT · PayShap
Banco, conta e código da agência · telefone
A conta bancária deve estar no seu nome
Gana · Filipinas
MoMo · InstaPay
Celular da carteira · conta bancária
Carteira em nome do titular
Como verBrasilMéxicoReino UnidoNigériaQuêniaDados válidos de teste em cada país: pré-carregados pela conta de demonstração (veja Países do site)
Para integraçãoValidar o formato de cada dado de destino (dígito verificador de CLABE e IBAN, tamanho de CCI/NUBAN/sort code) e confirmar com o banco ou o PSP que o titular coincide com o nome e o documento do KYC (Pix com o CPF, NUBAN com o BVN). Nunca pagar a terceiros. Os saques saem pelo mesmo método do depósito quando o regulador exigir.
No Quênia, o caixa mostra o imposto especial de 5% ao depositar e a retenção de 5% ao sacar; nos demais países há apenas um texto informativo sobre os ganhos.
AvisoCaixa · Página Depositar · Página Sacar
Gatilho
JogadorNo Quênia, informe um valor de depósito ou de saque.
Passos
Abaixo do valor aparece o detalhamento: valor, imposto especial (5%) e total que chega ao saldo.
No saque, aparece a retenção de 5% e o valor que o jogador vai receber.
Os créditos promocionais também pagam o imposto especial.
Sem impostos sobre movimentações, o detalhamento não aparece.
O que o jogador vê
Alerta · Depósito · Quênia
Imposto especial (5%): somado ao valor do depósito.
Alerta · Saque · Quênia
Retenção sobre saques (5%): descontada do valor que você recebe.
Alerta · Informações fiscais
Retenção de 20% sobre os ganhos (Finance Act 2026).
Para integraçãoCalcular o imposto no backend e devolvê-lo detalhado (base, alíquota, imposto, total) para exibir e registrar no histórico. As porcentagens e o nome vêm da configuração do mercado e são informados à autoridade fiscal (KRA no Quênia). Os prêmios tributados (Colômbia, México, EUA, Brasil) são informados ao jogador, mas o operador só retém onde a lei exige.
Para integraçãoConsultar o LUGAS (o sistema federal de limites entre operadores) antes de cada depósito e informar o valor depositado; o operador não pode aceitar mais de € 1.000 por mês por jogador, e aumentar o limite próprio exige esperar. O OASIS (bloqueios) também é consultado no login e em cada depósito.
Para integraçãoGuardar os limites no cadastro com data e valor, aplicá-los em cada depósito e exigir o período de espera ao aumentá-los. O cadastro não deve criar a conta se faltarem os limites obrigatórios; o regulador pode pedir o histórico de alterações.
Para integraçãoProvedor de geolocalização certificado (GeoComply ou outro) no dispositivo, verificação no login, em cada aposta ou giro e no depósito, com registro da posição. Distinguir VPN, proxy e localização simulada.
Para integraçãoValidar no cliente (formato) e no servidor (dígito verificador e consulta oficial: Receita Federal para o CPF, SAT/RENAPO para a CURP, Registro Civil para o RUT, NIBSS para o BVN, Home Affairs para o ID sul-africano, NIA para o Ghana Card). A conta de saque deve coincidir com o titular.
Para integraçãoIntegrar a API do registro do país (GAMSTOP, OASIS, RGIAJ…) com consulta no cadastro, em cada login e antes de campanhas de marketing. Registrar a exclusão própria e aplicá-la em todo o site, sem possibilidade de cancelá-la antes do prazo.
Para integraçãoO relógio é controlado pelo backend (sessão de login, não apenas o navegador) e deve enviar o aviso com o tempo jogado e os ganhos ou perdas líquidos. O intervalo mínimo e o texto são definidos por cada regulador.
Para integraçãoRepassar ao provedor do jogo os parâmetros do mercado (aposta máxima por idade, velocidade mínima, autoplay desativado) ao abrir a sessão e verificar a idade do jogador. A idade é obtida da data de nascimento verificada.
Para integraçãoDesativar pela configuração do mercado todos os produtos de cassino (jogos, provedores, jackpots, torneios de cassino), inclusive na API de lançamento de jogos, e limitar as promoções a esportes.
Para integraçãoA configuração do mercado define se existe bônus de boas-vindas, seu requisito de rollover e se é permitido combinar cassino e esportes. Ocultá-lo no CMS e nas campanhas de aquisição, não só no front-end.
Para integraçãoO feed de odds chega em formato decimal e é convertido para exibição; o formato é uma preferência de apresentação e não altera o valor pago.
Para integraçãoSomente para o protótipo. No sandbox do PSP são usados os cartões e valores de teste de cada provedor; este mapa serve como guia para o QA.
Bônus e saldo
Saldo real versus saldo de bônus, rollover, cancelamento do bônus, ofertas e códigos promocionais.
Para integraçãoEndpoint de saldos com real, bônus, Moedas V1 e valor bloqueado em saques, e um evento de atualização para redesenhar todas as visualizações de uma vez (no front-end, os elementos com data-user).
Para integraçãoProgresso do rollover (apostado e requisito), contribuição por tipo de jogo, aposta máxima, data de validade e regra de perda ao sacar. Faltam os estados de bônus concluído e expirado (ver propostas).
Para integraçãoEndpoint de lançamento que retorne a URL do provedor para o jogador e o modo (token de sessão de jogo). Se dinheiro real for pedido sem sessão, o iframe inicia em demo.
Mensagens entre o jogo e a página para que o saldo seja o mesmo em todo lugar.
InformativoPágina do jogo · Header
Gatilho
SistemaCada giro, prêmio ou depósito durante a partida muda o saldo.
Passos
Dinheiro real: o iframe atualiza o saldo e avisa a página, que redesenha header, menu e barra do jogo.
Demo: o iframe informa seu próprio saldo e só a barra do jogo muda.
Se o jogador depositar no caixa enquanto joga, o iframe relê o saldo antes do próximo giro.
Um prêmio de x20 ou mais é anunciado com um toast na página.
O que o jogador vê
Toast · Grande prêmio
Grande prêmio!$250,00 no Gates of Olympus 1000 · x250
No jogo · Resultado de cada giro
GanhoGrande prêmio!Sem prêmio desta vez
Mensagens postMessage do iframe para a página
Mensagem
Quando
Efeito na página
{type:"bv:user"}
Mudança de saldo com dinheiro real
Recarrega o usuário e redesenha todos os saldos
{type:"bv:demo", balance}
Mudança de saldo na demo
Atualiza o saldo demo da barra
{type:"bv:open", id:"cashier", tab:"deposit"}
Saldo insuficiente
Abre o caixa em Depositar
{type:"bv:toast", title, text, kind}
Avisos do jogo
Mostra o toast na página
{type:"bv:spin", on}
Início e fim de cada giro com dinheiro real
Uma mudança de país ou de modo aguarda o fim do giro
{type:"bv:esc"}
Tecla Esc dentro do jogo
Fecha o jogo em tela cheia no celular
Como verJogo com sessãoJogue com dinheiro real e veja o saldo do header
Para integraçãoCom um provedor real, o saldo autoritativo vem da wallet do backend: escutar os eventos do provedor (ou consultar o saldo) e validar a origem de cada postMessage, que hoje é enviado para qualquer origem.
Para integraçãoFavoritos e recentes hoje são salvos só no dispositivo (localStorage): persisti-los na conta para vê-los em qualquer dispositivo, como a mensagem promete.
Para integraçãoFeed de odds em tempo real (WebSocket) e resposta de colocação “odd alterada” com a nova odd; preferência do jogador para aceitar aumentos.
Para integraçãoResposta de colocação com ID do cupom, odd final e status (aceita, recusada ou aguardando aprovação do operador). A recusa não está simulada (ver propostas).
Para integraçãoProgresso das missões a partir dos eventos de jogo, endpoint de resgate idempotente e condições de desbloqueio (nível ou missão anterior).
Para integraçãoClassificação em tempo real com a posição do jogador, prêmio atual, pontos para a próxima faixa e liquidação automática do prêmio ao final.
Resgate, moedas insuficientes e prêmios esgotados.
SucessoErroLoja
Gatilho
JogadorToca em Resgatar em um prêmio da loja.
Passos
Os prêmios que o jogador não pode pagar aparecem esmaecidos; os esgotados têm o botão desabilitado.
Sem moedas suficientes, o card treme e aparece um toast de erro.
Com moedas suficientes, diálogo de confirmação com o saldo restante.
As moedas são descontadas, o resgate entra no histórico e há confete.
O que o jogador vê
Toast · Moedas insuficientes
Moedas insuficientesFaltam 3.050 moedas para “Bônus de $100”.
Diálogo de confirmação
Trocar por este prêmio?
Bônus de $25 por 1.500 Moedas V1. Vão sobrar 950.
CancelarTrocar 1.500
Toast · Resgate
Troca feita!Bônus de $25 já está na sua conta.
Alerta · Loja sem sessão
Ganhe Moedas V1 jogandoCrie sua conta e receba 200 moedas de boas-vindas para sua primeira troca.
Criar conta
Esgotado
Como verLojaMoedas insuficientes: “Bônus de $100” (5.500)Sem sessão
Para integraçãoCatálogo com preço, estoque e disponibilidade; resgate com débito atômico de moedas e entrega do prêmio no saldo ou nos giros correspondentes.
Para integraçãoO prêmio é decidido pelo servidor, nunca pelo front-end, com elegibilidade diária, custo em moedas e crédito no saldo correspondente. Depois de girar, “Recarregar giro” repete a roda apenas no protótipo.
Jogo responsável
Limites de depósito, perda e sessão, lembrete de realidade, pausa e autoexclusão, na página Jogo responsável da conta.
Reduzir um limite vale na hora; aumentá-lo leva 24 horas.
SucessoAvisoJogo responsável
Gatilho
JogadorToca em “Alterar limite” no limite diário, semanal ou mensal e salva.
Passos
O valor é validado (maior que 0 e até $100.000); o botão mostra “Salvando…”.
Redução: vale a partir de agora, com a barra de uso atualizada e a etiqueta “Ativo”.
Aumento: fica pendente por 24 horas com a etiqueta “Alteração pendente”.
O depósito respeita o limite (ver “Valor fora dos limites”).
O que o jogador vê
Erro no campo · Valor do limite
Informe um valor maior que 0.O máximo permitido é $100.000.
Toast · Redução
Limite diário atualizadoVale a partir de agora: $300.
Toast · Aumento
Aumento programadoLimite diário de $800 entra em vigor em 24 horas.
AtivoAlteração pendente
Como verLimitesLimite diário atual $500: teste 300 e 800
Para integraçãoLimites por período com o valor utilizado, carência de 24 horas para aumentos, aplicação imediata das reduções e bloqueio de qualquer depósito que os ultrapasse.
Durante a pausa não é possível depositar nem jogar, mas é possível sacar o saldo real.
O que o jogador vê
Diálogo de confirmação
Pausar sua conta por 24 horas?
Você não poderá depositar nem jogar até 13 nov 2026, 15:00. Ainda poderá sacar seu saldo real.
CancelarPausar conta
Bloco na tela · Status
Conta em pausa · 24 horas
Você não poderá depositar nem jogar até 13 nov 2026, 15:00. Seus saques continuam disponíveis.
Toast · Global
Pausa ativadaAté 13 nov 2026, 15:00
Como verPausa“Desfazer (só no protótipo)” volta ao estado inicial
Para integraçãoStatus de pausa com data de término que bloqueie o depósito e o jogo em todo o site. No protótipo, só o aviso é exibido (ver propostas).
Para integraçãoEncerramento irreversível até a data, devolução do saldo real, descadastro de comunicações comerciais e registro no sistema de autoexclusão do regulador quando aplicável. No protótipo, a conta continua ativa (ver propostas).
Sistema
Logout, página não encontrada, manutenção e mensagens globais que aparecem em qualquer tela.
Para integraçãoChave de manutenção com horário estimado de término e status das tarefas; responder 503 com Retry-After e redirecionar todas as rotas para esta tela enquanto durar.
Para integraçãoConectar “Suporte ao vivo” e “Chat ao vivo” ao provedor de chat real com o contexto do jogador (e da transação, a partir do histórico).
Estados recomendados que ainda não estão simulados
Proposta: situações de que um cassino real precisa e que o protótipo ainda não mostra. Os textos são sugestões para validar com produto e jurídico, não mensagens existentes.
Depois de “Recuperar senha” não existe a tela do link.
PropostaAcesso
Tela com nova senha e confirmação, mais dois estados: link expirado ou já usado (“Este link não é mais válido. Peça um novo.”) e sucesso com login automático.
Para integraçãoValidação do token (expirado, usado, inválido) e encerramento das outras sessões ao alterá-la.
O 2FA é ativado em Segurança, mas o login não o pede.
PropostaAcesso
Etapa extra no modal de login: “Digite o código do seu app autenticador”, com opção de usar um código de backup e erro de código incorreto ou expirado.
Para integraçãoResposta de login “requer 2FA” com token temporário e endpoint de verificação do código.
SPEI, PSE, Pix e os pagamentos em dinheiro ficam «pendentes» no protótipo.
PropostaDepósito
Toast e notificação ao creditar («Depósito confirmado»), estado de código Pix vencido («O código expirou. Gere um novo para continuar.») e pagamento bancário recusado ou devolvido, também visíveis no histórico.
Para integraçãoWebhooks do processador com o status final e um canal em tempo real (WebSocket ou push) para avisar o jogador mesmo que tenha fechado o caixa.
Notificações e status “Em análise de segurança”, “Pago” e “Recusado” com motivo e devolução do valor ao saldo (“Seu saque foi recusado: a conta de destino não está em seu nome. Devolvemos $300,00 ao seu saldo.”).
Para integraçãoMáquina de estados do saque, motivos de recusa padronizados e um evento a cada mudança.
Alertas no cupom para mercado suspenso (“Mercado suspenso. Remova a seleção ou aguarde a reabertura.”), aposta acima do máximo com o valor máximo permitido e aposta aguardando aprovação do operador.
Para integraçãoCódigos de recusa da colocação (suspenso, máximo excedido, odd alterada, limite do jogador) com os dados para cada mensagem.
Toast e notificação ao cumprir o requisito (“Rollover concluído: $150,00 passam para seu saldo real.”) e ao expirar o bônus, com sua passagem para o histórico.
Para integraçãoEvento de conversão do bônus em saldo real e de expiração, com os valores.
Hoje os avisos só aparecem na página de jogo responsável.
PropostaJogo responsável
Modal ao atingir o limite de sessão com aviso 5 minutos antes, lembrete de realidade com tempo jogado e resultado, bloqueio de depósito e jogo durante a pausa e login bloqueado para contas autoexcluídas com a data de término.
Para integraçãoStatus de jogo responsável incluído na sessão e verificado em cada depósito, lançamento de jogo e aposta.