Guia da API da Evolution
Já decidiu pela Evolution? Esta parte explica como a SSG conecta você: as 27 APIs, a sequência de lançamento, as regras da carteira, os requisitos de iframe e um checklist de go-live.
27APIs em 6 famílias
6etapas de lançamento do jogo
2estilos de liquidação
10itens no checklist de go-live
Autenticação e lançamento, o fluxo financeiro da One Wallet, modos de jogo, regras de iframe, segurança e relatórios, e o checklist de integração, tudo em um só lugar.
Abrir o guia completo da API ▾Fechar o guia da API ▴
A · Mapa das APIsVinte e sete APIs, seis funções
Algumas APIs vêm ativadas por padrão em novas integrações; as demais são ativadas com o seu gerente de conta.
Jogador e lançamento
Crie ou autentique um jogador, abra uma sessão de jogo, retorne o endereço de lançamento e incorpore os jogos em um iframe.
- User Authentication
- Client API
- Iframe Integration
Transações
Apostas, prêmios, gorjetas e promoções pela One Wallet, além de transferências do caixa, envios de saldo e consultas de transações.
- One Wallet
- eCashier
- Balance Push
- Wallet Transactions Status
Dados e relatórios
Histórico de jogos, streaming de jogos finalizados, renderização de jogos, banners de jackpot, classificação, taxas de câmbio e lançamento direto do jogo para o seu próprio lobby.
- Direct Game Launch
- Game History
- Game Rendering
- Game Streaming
- Jackpot Banner
- Game Classification
- Currency Rates
- Chat Backoffice
Conformidade
Lembrete de tempo unificado, checksums, versões de aplicativo e relatórios para Dinamarca, Portugal, Finlândia e América do Norte.
- Checksum
- Unified Reality Check
- Denmark (Safe3)
- Portugal Safe
- Finland Reporting
- Application Version
- North America Reporting
Promoções
Campanhas Reward Games e o respectivo fluxo de eventos, notificações de bônus em tempo real e notificações push para jogadores.
- Reward Games
- Reward Games Streaming
- Bonus
- Push Notification
Gestão do cassino
Crie e configure instâncias de cassino.
B · Lançamento do jogoDo clique à mesa em seis passos
O jogador escolhe uma mesa
Depois de entrar no seu site, o jogador abre um jogo ao vivo a partir do seu lobby.
O seu servidor chama a Evolution
Um POST servidor a servidor por HTTPS envia o jogador, a moeda, o idioma e as configurações do jogo.
A Evolution verifica a carteira
A carteira confirma o jogador com o seu sistema. Esta etapa é ignorada no modo Demo.
A sessão de jogo é criada
O serviço de autenticação da Evolution avisa o servidor de jogos que uma sessão está chegando e espera que ela fique pronta.
O endereço de lançamento retorna
A Evolution responde com um JSON contendo os valores de entrada e de localização desta sessão.
A mesa abre
O seu servidor redireciona o navegador para esse endereço e a mesa ao vivo carrega com os seus parâmetros personalizados.
Somente servidor a servidor
A chamada de autenticação é feita pelo seu servidor por HTTPS e nunca é exibida ao jogador. Use um nome de domínio e coloque os IPs dos seus servidores na lista de permissões antes (IPv6 não é compatível).
Nomes de host rotativos para jogadores
Opcional. Quando ativado, o endereço do jogo muda entre as requisições e rotaciona de uma a quatro vezes por dia por cerca de 14 dias. Leia-o sempre da resposta mais recente.
Códigos de resposta padrão
2xx significa sucesso, 4xx indica um problema na sua requisição e 5xx indica um erro do lado da Evolution.
C · Carteira e dinheiroOne Wallet: a Evolution chama você, e você responde rápido
Na One Wallet, o seu sistema continua sendo a única fonte da verdade para os saldos. A Evolution envia solicitações de débito, crédito e cancelamento para você e espera um status claro de volta a cada vez.
Estilo de liquidação
Exemplo: blackjack, aposta de 10, o jogador divide um par e ganha as duas mãos.
Misto
Um crédito para cada débito: dois débitos de 10, depois créditos de 20 e 20. O mais simples de construir, porque cada débito e seu crédito ou cancelamento compartilham um ID de referência.
Por jogo
Um único crédito agregado no fim do jogo, não importa quantos débitos tenham ocorrido: aqui 10, 10 e depois 40. Ideal quando você precisa saber exatamente quando uma rodada terminou; depois de aceita, a rodada fica fechada para novos créditos.
O que significa a sua resposta
SucessoA operação foi concluída. Também usado para “aposta já existe” e “já liquidado”, então chamadas repetidas são seguras.
RepetívelAlgo passageiro. A aposta é recusada por enquanto, o jogador permanece no jogo e a Evolution pode repetir a chamada.
FinalNão será repetida, mas a sessão pode ser reutilizada. Por exemplo, saldo insuficiente: o jogador vê uma mensagem curta e continua no jogo.
FatalA sessão do jogador é encerrada imediatamente, por exemplo com um token inválido. O jogador precisa entrar e iniciar o jogo de novo.
Responda sempre HTTP 200 com um status e o ID da requisição, mesmo em rejeições por limite ou bloqueio. Uma resposta diferente de 200 é tratada como falha técnica.
Se uma chamada falhar: novas tentativas
Apostas online
A cada 0,1 a 1 segundo enquanto a aposta ainda pode entrar na rodada.
Novas tentativas offline
Cerca de 5 horas, a cada 1 a 10 minutos, em segundo plano.
Pagamentos de promoções
Cerca de 72 horas, com uma política separada.
Não são repetidas: verificações de saldo e de usuário. Faça com que toda chamada de débito, crédito, cancelamento e gorjeta seja idempotente usando o ID da transação, e vincule as liquidações à aposta original pelo ID de referência.
Gorjetas para o dealer
Débito, cancelamento e encerramento de gorjeta seguem as mesmas regras de idempotência. O suporte completo a gorjetas é obrigatório para estúdios nos EUA e no Canadá.
eCashier
Para mover dinheiro entre a sua carteira e a da Evolution: consulta de saldo disponível, crédito e débito externos, informações do jogador e status da transação, por HTTPS com autenticação básica e lista de IPs permitidos.
Balance Push
Avise a Evolution quando um saldo mudar no seu site. Inclua um carimbo de data/hora para que atualizações antigas sejam descartadas, envie em lotes cerca de uma vez por segundo e nunca envie mudanças causadas por jogos da Evolution. Slots e reward games não são compatíveis.
D · Modos de jogoCinco formas de colocar um jogador na mesa
PadrãoDinheiro real
O jogador registrado joga com o saldo mantido no seu sistema.
MarketingReward Games
Vouchers de “dinheiro grátis” com saldo separado e limite de ganhos. Os ganhos voltam para você pagar. Um clique troca o jogador para dinheiro real.
RegistradoPlay For Fun
Moeda artificial para jogadores registrados, com troca instantânea para dinheiro real.
PromoFun Bonus
Jogo com voucher gerenciado inteiramente do seu lado. Não pode ser convertido em dinheiro real e inicia direto em uma mesa.
VisitantesDemo
Sem cadastro, apenas idioma e moeda. Somente lançamento direto; o lobby não é permitido por motivos de segurança.
E · Front-endIncorpore certo desde a primeira vez
16:9 no desktop
O iframe deve manter a proporção 16:9. Nenhum estilo em html, body ou no iframe que altere o seu tamanho.
Permissões desde o início
Tela cheia é obrigatória, além de acesso à área de transferência. Geolocalização, Bluetooth e sensores de movimento são necessários em alguns mercados regulados. Devem estar na tag; adicioná-los por script não funciona.
Evite
Nada de atributo sandbox, nada de iframe dentro de outro iframe e nada de overflow:hidden no iOS na página ou no body.
Converse com o jogo
A Client API envia eventos como aplicativo pronto e atualizações de ciclo de vida, e aceita comandos como parar o autoplay ou sair da tela cheia. Útil para lembretes de tempo.
Menor espaço compatível para o jogo: 320×529 em retrato, 568×320 em paisagem (pixels CSS), depois do seu próprio cabeçalho ou rodapé. Informe ao jogo a altura da sua barra ao incorporá-lo, ou ele não será dimensionado corretamente.
F · Segurança e relatóriosO que os reguladores e as equipes financeiras perguntam
Somente HTTPS
Toda chamada entre a Evolution e os seus servidores é criptografada. Chaves ou tokens errados são rejeitados.
Relatórios
Histórico de jogos com apostas, decisões, cartas e resultados; um feed de streaming de jogos finalizados; classificação de jogos e apostas; taxas de câmbio; dados de banners de jackpot.
Jurisdições
Relatórios dedicados para Dinamarca, Portugal, Finlândia e América do Norte, além de APIs de checksum, lembrete de tempo unificado e versão do aplicativo.
Keepalive
O jogo envia um ping a um endereço de sua escolha em um intervalo fixo enquanto o jogador está ativo, para que você saiba quando uma sessão terminou. Somente jogos ao vivo; jogos RNG não são compatíveis.
G · Go-liveO seu checklist de integração
Decida três coisas antes dos testes REST
Estilo de liquidação, se os jogadores podem ter uma ou várias sessões e como você trata os IDs de mesa (não depender deles é a escolha recomendada). Compartilhe isso com o seu Technical Integration Manager.
- Coloque os IPs dos seus servidores na lista de permissões (somente IPv4; use nomes de domínio, não IPs, nos endpoints)
- Crie a chamada de autenticação e leia o endereço de lançamento em cada resposta
- Implemente a One Wallet: débito, crédito, cancelamento, saldo e verificação de usuário, tudo idempotente
- Retorne HTTP 200 com os valores de status exatos para limites, bloqueios e saldo
- Trate as novas tentativas com segurança: o mesmo ID de transação deve sempre dar a mesma resposta
- Adicione gorjetas ao dealer se você atende os EUA ou o Canadá
- Incorpore com a tag de iframe correta: 16:9, permissões na tag, sem sandbox, sem aninhamento
- Execute a verificação de integração da Evolution no Chrome e corrija os problemas de iframe que ela apontar
- Configure os relatórios e a conciliação, além das APIs de lembrete de tempo e de país que se aplicam a você
- Faça a certificação com os seus gerentes de conta e de integração; reward games e rodadas grátis são combinados com o seu gerente de conta
SSG Gaming
