Introduction
Visão geral da plataforma FourPlay, arquitetura real e fluxo completo de integração
Idioma da documentação
Esta documentação está disponível atualmente em Português Brasileiro (PT-BR). Uma versão em inglês (EN) está prevista para versões futuras.
O que é a FourPlay?
A FourPlay é uma plataforma de iGaming que fornece jogos proprietários (Mines, e outros) e infraestrutura para operadores de jogos online. O modelo de integração é baseado em seamless wallet — o operador mantém a carteira do jogador no próprio sistema, e a FourPlay se comunica via callbacks HTTP para debitar apostas e creditar ganhos em tempo real.
O que você obtém com a integração FourPlay:
- Sessões de jogo autenticadas via JWT para seus jogadores
- Callbacks em tempo real para gestão de saldo (balance, debit, credit, rollback)
- Jogo Mines rodando em
https://mines.fourplay.studio - Portal administrativo em
https://admin.fourplay.studio - Sandbox integrado ao painel para testes sem risco
Arquitetura
┌──────────────────────────────────────────────────────────────────┐
│ Seu Backend (Operador) │
│ │
│ ┌──────────────────────┐ ┌────────────────────────────────┐ │
│ │ POST /session/create │ │ Callbacks Wallet (você expõe) │ │
│ │ → mines.fourplay.studio│ │ POST /wallet/balance │ │
│ │ ← { token } │ │ POST /wallet/debit │ │
│ └──────────────────────┘ │ POST /wallet/credit │ │
│ │ POST /wallet/rollback │ │
│ └────────────────────────────────┘ │
└──────────────────────┬───────────────────────┬────────────────────┘
│ HMAC-SHA256 │ HMAC-SHA256
┌─────────▼──────────┐ ┌────────▼──────────────┐
│ FourPlay Mines │ │ FourPlay → Operador │
│ /api/operator/ │ │ Callbacks em tempo │
│ session/create │ │ real durante o jogo │
└─────────┬──────────┘ └───────────────────────┘
│ token JWT
┌─────────▼──────────────────────────┐
│ Jogador no Browser (iframe) │
│ mines.fourplay.studio/?token=eyJ... │
│ Conecta via WebSocket (Socket.IO) │
└────────────────────────────────────┘Fluxo Completo de Integração
O ciclo de vida de uma sessão de jogo:
- Jogador clica "Jogar" no site do operador
- Backend do operador autentica o jogador e chama
POST /api/operator/session/createno Mines Provider - FourPlay retorna
{ "token": "eyJ..." }— um JWT de sessão - Operador constrói a URL do jogo:
https://mines.fourplay.studio/?token={token} - Operador redireciona o jogador para essa URL (ou embuda via iframe)
- Jogo carrega e conecta via WebSocket (Socket.IO) usando o token
- Antes de cada aposta: jogo chama
POST {callbackUrl}/wallet/balanceno servidor do operador - Quando o jogador aposta: jogo chama
POST {callbackUrl}/wallet/debit - Se o jogador fizer cashout/ganhar: jogo chama
POST {callbackUrl}/wallet/credit - Se ocorrer erro: jogo chama
POST {callbackUrl}/wallet/rollback
URLs do Sistema
| Serviço | URL |
|---|---|
| Mines Provider | https://mines.fourplay.studio |
| Session API | https://mines.fourplay.studio/api/operator/ |
| Jogo (iframe) | https://mines.fourplay.studio/?token={token} |
| Portal Admin | https://admin.fourplay.studio |
Conceitos Importantes
| Conceito | Descrição |
|---|---|
| Operador | Empresa parceira que integra os jogos FourPlay e gerencia os jogadores |
| externalPlayerId | ID do jogador no sistema do operador — identificador único que você define |
| callbackUrl | URL base do seu servidor onde a FourPlay enviará as requisições de wallet |
| Seamless Wallet | Modelo onde o operador mantém o saldo e a FourPlay debita/credita via callbacks |
| gameId | ID interno gerado pelo Mines para cada rodada — usado como referência nas transações |
| token JWT | Token de sessão retornado pelo session/create — identifica o jogador no WebSocket do jogo |