# PG Soft / Pragmatic Play — ligação à ReelSparkz

A demonstração independente Fortune Tiger tem agora um adaptador local de testes ligado à carteira Arcade. Não é uma sessão oficial PGSoft nem usa matemática certificada do fornecedor.

Estado dos fornecedores oficiais: catálogo inicial e acessos oficiais disponíveis. Nenhum destes fornecedores está ligado à carteira ReelSparkz. As demonstrações externas utilizam a carteira e o interface do fornecedor.

## O que falta para ativar

Precisamos do acesso contratado, ambiente de homologação, documentação atual, identificadores oficiais dos jogos e endpoints fornecidos diretamente pelo fornecedor ou pelo agregador contratado. Chaves são guardadas no servidor, nunca no browser nem no catálogo. Não existem chaves configuradas ou adaptadores ativos nesta entrega.

## Fluxo a implementar após obter a documentação

1. Operador autentica o seu backend na ReelSparkz, indica jogador, jogo, origem autorizada, idioma e moeda.
2. ReelSparkz verifica o estado do operador, permissão do produto, domínio e modo demo/real.
3. Adaptador específico solicita uma sessão ao fornecedor e devolve a URL de lançamento validada. Não aceitamos uma URL arbitrária enviada pelo jogador.
4. O iframe recebe apenas essa sessão, com CSP adequada ao fornecedor e domínios de utilização. A documentação determina os hosts exatos permitidos.
5. O fornecedor consulta saldo e envia débito, crédito, reversão e estado da ronda. Validar assinatura, sessão, moeda, operador e jogador; persistir transações idempotentes de forma atómica antes de responder. Repetições não duplicam débitos/prémios.
6. O painel inferior ReelSparkz mostra o saldo confirmado pelo servidor. Durante perda de ligação, indica atualização pendente; nunca inventa saldo ou prémio.
7. Cada ronda alimenta relatórios e GGR com a comissão do operador. Promoções/free rounds são ativadas apenas quando suportadas pelo contrato/API daquele jogo.

## Interface do jogador

Nos jogos ReelSparkz, seleção, valor, ação principal e crédito usam o mesmo painel inferior com paleta ardósia, menta e dourado. Nos jogos de fornecedores, não substituímos o seletor interno por botões sem efeito nem tentamos alterar o DOM do iframe externo. Um controlo externo de aposta só será oferecido se existir SDK/API documentada para essa função. Eventos de iframe, se disponíveis, devem validar origem e janela emissora; valores financeiros são sempre confirmados pelo servidor.

## Validação necessária

- Lançamento em demo e produção nos domínios autorizados, com moeda/idioma corretos.
- Saldo insuficiente, repetição de débito/crédito, reversões, timeout após confirmação e reconexão.
- Encerramento de ronda, liquidação de sessões antigas e relatório de GGR.
- Bloqueio por operador/Admin, isolamento entre clientes e nenhuma chave no browser.
- Funcionamento em iframe mobile, fullscreen e comportamento do saldo com SDK do fornecedor.

## Fontes oficiais

- PG Soft: https://www.pgsoft.com/ e https://www.pgsoft.com/en/games/
- Fortune Tiger: https://www.pgsoft.com/uploads/Games/Pdf/Fortune_Tiger_Gameinformation_EN.pdf
- Gates of Olympus demo: https://www.pragmaticplay.com/en/games/gates-of-olympus/
- Sweet Bonanza demo: https://www.pragmaticplay.com/en/games/sweet-bonanza-slot/
- Pragmatic Client Hub: https://clienthub.pragmaticplay.com/

As demonstrações públicas não são credenciais de integração nem autorização para redistribuir os jogos. Os produtos e o motor da ReelSparkz continuam independentes.