Esta é a página oficial de integração do i-Gaming. Aqui você encontra tudo o que precisa para conectar seu operador à nossa plataforma: SDKs oficiais em Node/TS, Python e PHP, sandbox Docker espelhando produção, quickstarts copy-paste para Laravel/NestJS/FastAPI, playground interativo, webhooks assinados, OpenAPI 3.1, checklist interativo de go-live com testes ao vivo e histórico sincronizado, além de guias de HMAC, idempotency-key e troubleshooting — feitos para reduzir o time-to-production de dias para horas.
Do zero ao primeiro spin real em menos de um dia usando o sandbox Docker.
Assinatura SHA-256, timing-safe, nonce anti-replay e idempotency-key nativos nos SDKs.
Clientes oficiais em Node/TS, Python 3.9+ e PHP 8.1+ — mesmo contrato em todos.
Backoff exponencial, logs estruturados e trends de auth failure no painel.
Marque cada etapa conforme for concluída. Faça login para sincronizar entre dispositivos — sem login, salvamos neste navegador.
0 de 5 etapas concluídas
Suba o Docker Compose com wallet mock, Postgres e MailHog para testar sem tocar em produção.
Copie o exemplo pronto para Laravel, NestJS ou FastAPI com callbacks e launch token.
Use o cliente Node/TS, Python ou PHP para assinar HMAC, fazer retries e enviar idempotency-key.
Dispare bet, win e rollback, valide assinatura e confira webhooks em tempo real.
Valide domínio, HMAC, secrets, webhook e RTP antes de liberar o ambiente de produção.
Faça login para salvar seu histórico entre dispositivos. Sem login, mostramos apenas esta sessão.
Sem alterações registradas ainda. Marque uma etapa ou rode um teste para começar.
Um mapa rápido do que você acessa aqui — do primeiro spin no sandbox até o go-live em produção.
Do docker compose up ao cutover — cada passo com link para a ferramenta certa.
Marque seu progresso, teste ao vivo (sandbox, SDK, OpenAPI, playground) e sincronize entre dispositivos.
Timeline das últimas ações do seu checklist com data, hora e resultado dos testes.
Clientes oficiais, exemplos por stack e ambiente local em Docker — tudo linkado nos cards de ferramentas.
Assinatura HMAC e chamada de bet em Node/TS, Python e PHP, prontos para copiar.
Respostas curtas sobre HMAC, idempotency-key, retries e subdomínio próprio.
Links rápidos para cada ferramenta correspondente do checklist acima.
docker compose up e você tem wallet mock, Postgres, Adminer e MailHog espelhando produção.
Ver Docker stackQuickstarts copy-paste para Laravel, NestJS e FastAPI com callbacks completos.
Abrir quickstartsUm npm/pip/composer install e você já assina HMAC, faz retries e envia idempotency-key.
Ver SDKs oficiaisDispare bet, win e rollback direto no navegador; valide webhooks contra seu endpoint.
Abrir playgroundConfigure operator + secrets no painel, ative o cutover e monitore auth trends em tempo real.
Checklist de go-liveCada peça foi construída pensando no dia a dia de quem integra — não em slides de marketing.
bet, win e rollback. Assinatura HMAC SHA-256, timing-safe, nonce anti-replay. Idempotency-key garante que retries não dupliquem crédito.
import { IgamingClient } from "@i-gaming/sdk";
const client = new IgamingClient({
apiToken: process.env.IGAMING_API_TOKEN!, // Bearer
hmacSecret: process.env.PORTAL_HMAC_SECRET!, // x-dl-sig
});
const result = await client.bet({
launch_token: "eyJhbGc...",
game_slug: "gold-tiger",
round_id: "r_abc",
amount_cents: 500,
user_ref: "user_123",
idempotency_key: crypto.randomUUID(),
});
console.log(result.ok ? result.data.balance_cents : result.message);Respostas curtas sobre os pontos que mais geram dúvidas na integração.
HMAC é uma assinatura criptográfica que prova que a requisição veio realmente do seu servidor. Todas as chamadas de wallet (/seamless/bet, /win, /rollback) exigem o header x-dl-sig assinado com o PORTAL_HMAC_SECRET compartilhado entre portal e jogo. Sem ele, o portal recusa a chamada.
É um identificador único que você envia em cada chamada financeira. Se a rede falhar e você reenviar a mesma requisição, o portal reconhece a chave e devolve o resultado anterior, sem duplicar débito ou crédito. Envie sempre em bet, win e rollback.
Os SDKs oficiais fazem backoff exponencial com jitter (até 3 tentativas por padrão). Eles repetem apenas erros de rede ou 5xx; 4xx de assinatura ou validação de payload não são repetidos, pois a requisição está incorreta.
Não é obrigatório, mas recomendado. Aponte um CNAME para www.i-gaming.co e adicione o domínio no painel. Isso garante que o iframe de launch token seja servido do mesmo origin do seu operador, evitando bloqueios de cookie e third-party iframe.
SDKs oficiais nas 3 linguagens mais usadas. Outras via OpenAPI + gerador.
SDKs, quickstarts, sandbox local e playground — pensados para reduzir seu time-to-production de dias para horas.
Node/TS, Python e PHP com HMAC signing, retries e idempotency-key nativos.
Laravel, NestJS e FastAPI — wallet callbacks completos + launch token em um arquivo.
Wallet mock + Postgres + Adminer + MailHog espelhando produção. `docker compose up`.
Dispare bet.settled / invoice.paid pro seu endpoint e veja a resposta em tempo real.
Especificação completa — importe no Postman/Insomnia ou gere seu próprio SDK.
Teste os endpoints direto no navegador com seu token, sem escrever código.
Coleção pronta com todas as rotas, exemplos e variáveis de ambiente.
Guia passo a passo para diagnosticar `bad_signature`, timestamp skew e nonce replay.
Se você tem 10 minutos, você já pode ter um bet real rodando no seu ambiente local.