Documentação da API
Portal da API do BetBackoffice
Para times que constroem o próprio front e usam o BetBackoffice como retaguarda de cadastro, KYC, carteira e operação.
Esta é a documentação técnica; o desenho conceitual e as opções de adoção estão no guia de integração. A referência segue a especificação OpenAPI v1.0.0, fixada neste site.
Credenciais de sandbox não são publicadas aqui: fale com a equipe para recebê-las.
Começando
Integração
Autenticação HMAC passo a passo
Como assinar cada requisição com HMAC-SHA256 no seu servidor, com exemplos em Node.js e curl.
Fluxos ponta a ponta
Do cadastro do jogador ao saque — a ordem das chamadas e onde entram KYC, depósito, jogo e webhooks.
Webhooks e verificação de assinatura
Como receber eventos do BetBackoffice no seu servidor, verificar a assinatura e lidar com retentativas.
Convenções
Idempotência e reversões
Como repetir chamadas com segurança usando Idempotency-Key e como cancelar ou compensar operações.
Erros
Formato dos erros da API, códigos estáveis, status HTTP e como tratar cada um.
Paginação e convenções
Paginação por cursor, formato de datas, valores monetários e identificadores usados pela API.
Limites de uso
Limites de taxa, tamanho e tempo da API pública e boas práticas de retentativa.