Jogos live casino no seu site

Não é necessário liberar IP do seu lado: a liberação já está feita no gateway.

GET/api/v2/providers

Lista os provedores. Não precisa de credenciais.

GET/api/v2/games?provider={ID}

Lista os jogos de um provedor, sem credenciais. Cada jogo traz name, game_code, image_url, provider.name, currency e lang.

POST/api/v2/game_launch

curl -X POST https://evolutiongames.site/api/v2/game_launch \
  -H "Content-Type: application/json" \
  -d '{
    "agentToken": "SEU_TOKEN",
    "secretKey": "SEU_SECRET",
    "user_code": "jogador@email.com",
    "user_balance": 100,
    "provider": "OFICIAL - EVOLUTION LIVE",
    "game_code": "GPKEVO_002f1c169f987367a76460647f4d38f5",
    "lang": "pt"
  }'

<?php
$payload = [
    'agentToken'   => 'SEU_TOKEN',
    'secretKey'    => 'SEU_SECRET',
    'user_code'    => 'jogador@email.com',
    'user_balance' => 100,
    'provider'     => 'OFICIAL - EVOLUTION LIVE',
    'game_code'    => 'GPKEVO_002f1c169f987367a76460647f4d38f5',
    'lang'         => 'pt',
];
$ch = curl_init('https://evolutiongames.site/api/v2/game_launch');
curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS     => json_encode($payload),
    CURLOPT_TIMEOUT        => 25,
]);
$res = json_decode(curl_exec($ch), true);
curl_close($ch);
if (($res['status'] ?? 0) == 1) {
    header('Location: ' . $res['launch_url']); // ou abra em iframe
} else {
    echo $res['msg'] ?? 'Erro ao abrir o jogo';
}

{
  "status": 1,
  "msg": "SUCCESS",
  "launch_url": "https://...",
  "user_code": "jogador@email.com",
  "user_balance": 100,
  "name": "Roulette"
}

Redirecione o jogador, ou abra em iframe, para o launch_url.

O saldo de cada jogador fica no banco do seu site. Durante o jogo, chamamos o seu site a cada consulta, aposta, ganho ou reembolso, e ele responde com o saldo novo. Veja o contrato na seção Carteira.

O jogador é identificado pelo user_code. Envie sempre no mesmo formato para o mesmo jogador, por exemplo o e-mail em minúsculas. Um formato diferente é tratado como outro jogador. O user_balance é o saldo na abertura do jogo; durante a partida vale o saldo que o seu site devolve.

• Chame game_launch apenas do backend e redirecione o jogador para o launch_url.
• Gere um novo launch_url a cada abertura de jogo: cada link é de uso único.
• Use /api/v2/games?provider={ID} para montar o catálogo e guarde em cache por alguns minutos.
• Mostre uma mensagem amigável ao jogador e registre o msg de erro no seu log.

Autenticação

Cada chamada traz X-Signature: sha256=<hex>, o HMAC-SHA256 do corpo bruto com a chave da carteira (enviada por canal privado). Rejeite assinaturas inválidas e timestamp com mais de 5 minutos de diferença.

Tipos de chamada

Campos de WinBet e Refund: user_code, txn_id, round_id, txn_type (debit_credit, debit, credit ou bonus), bet, win, delta (valor líquido a somar, já calculado por nós) e timestamp. BALANCE envia só type, user_code e timestamp.

Exemplo de aposta e resposta

{
  "type": "WinBet",
  "user_code": "jogador@email.com",
  "txn_id": "tx_88123",
  "round_id": "rd_5521",
  "txn_type": "debit_credit",
  "bet": 10.00,
  "win": 40.00,
  "delta": 30.00,
  "timestamp": 1793920000
}

{ "msg": "", "balance": 130.00 }

Regras

• Sem duplicidade: o txn_id é único. Se já foi processado, devolva o saldo atual sem alterar nada. Podemos reenviar em caso de falha de rede.
• Atomicidade: leia, valide e atualize o saldo numa única transação do banco, travando a linha do jogador.
• Saldo insuficiente: se bet > 0 e saldo < bet, responda HTTP 400 com {"msg":"INSUFFICIENT_USER_FUNDS","balance":...} sem alterar nada. Em Refund não valide saldo.
• Jogador inexistente: HTTP 404 com {"msg":"INVALID_USER","balance":0}.
• Prazo: responda em até 10 segundos. Resposta diferente de 200, 400 ou 404 é tratada como falha temporária e a transação é reenviada.

Exemplo: entra com R$100 e sai com R$130

• Você abre o jogo com user_balance: 100.
• Chamamos BALANCE e você responde balance: 100.
• O jogador aposta R$10 e ganha R$40: chamamos WinBet com delta: 30. Você soma 30 e responde balance: 130.
• Se reenviarmos o mesmo txn_id, você responde 130 sem somar de novo.
• Não existe acerto separado: o saldo já está com você.

Referência de implementação (PHP)

<?php
// 1) valide a assinatura sobre o corpo BRUTO
$raw = file_get_contents('php://input');
$esperada = 'sha256=' . hash_hmac('sha256', $raw, CHAVE_DA_CARTEIRA);
if (!hash_equals($esperada, $_SERVER['HTTP_X_SIGNATURE'] ?? '')) {
    http_response_code(401); exit;
}
$in = json_decode($raw, true);
// 2) em uma transação do seu banco:
//    - se txn_id já existe: devolva o saldo atual, sem alterar
//    - se bet > 0 e saldo < bet: HTTP 400 {"msg":"INSUFFICIENT_USER_FUNDS","balance":<saldo>}
//    - senão: saldo += delta, grave o txn_id e devolva {"msg":"","balance":<novo saldo>}

Em caso de dúvida ou erro, envie ao suporte: o user_code, o game_code, o provider, o horário da requisição e a resposta completa recebida.