Visão geral

O OrbiSportbook fornece o sportsbook por um iframe incorporado ao cassino do cliente. Operamos odds, mercados, aceite de apostas, liquidação e cash-out, com integração à carteira existente por chamadas assinadas entre servidores.

Cadastro, login, validação de CPF, KYC e caixa, incluindo depósitos e saques, são responsabilidade da plataforma do cliente. Os jogadores mantêm suas contas e seu saldo nessa plataforma; não fazem um novo cadastro no OrbiSportbook.

URLs da OrbiSportbook

Recurso	URL
API de integração	https://api.orbisportbook.com/api/v1
Origem do sportsbook e do iframe	https://api.orbisportbook.com
SDK de incorporação	https://api.orbisportbook.com/embed/v1.js
Documentação de integração	api.orbisportbook.com/docs/pt-br
Landing e galeria de temas	orbisportbook.com

O ambiente hospedado atualmente é staging. Solicite à OrbiSportbook seu ID de tenant e sua chave de integração e cadastre as origens permitidas do seu site e o endpoint da sua carteira antes de integrar. As credenciais de desenvolvimento do início rápido valem somente para o ambiente local.

Quem é responsável pelo quê?

Área	Plataforma do cliente	OrbiSportbook
Contas de jogador	Cadastro, login, autenticação e gestão da conta.	Vincula um registro interno do sportsbook ao seu externalPlayerId e emite sessões para o iframe.
Identidade	Coleta e validação de CPF, KYC, verificação de idade e elegibilidade do jogador.	Recebe a referência do jogador autenticado pelo seu servidor; não fornece o serviço de cadastro ou KYC do cliente.
Caixa e fundos	Depósitos, saques, provedores de pagamento e saldo da carteira do jogador.	Chama seus endpoints balance, debit, credit e rollback para as movimentações do sportsbook.
Sportsbook	Incorpora o iframe ao cassino e escolhe tema, margens e limites de aposta.	Odds, mercados, boletim, aceite de apostas, liquidação, cash-out e back office do sportsbook.

Um credit na carteira representa uma liquidação do sportsbook, não um saque para uma conta bancária. O botão Depositar do iframe solicita a abertura do seu caixa; ele não processa o depósito.

A sessão usa somente o externalPlayerId da sua plataforma para identificar o jogador, inclusive no perfil BR. Não envie CPF. Consulte o contrato de sessões.

Como funciona

1. Login. O jogador entra no seu site. O seu servidor chama POST /api/v1/integration/sessions com a sua chave de API e recebe um launch token: de uso único, válido por 120 segundos.
2. Abertura. A sua página monta o sportsbook com o SDK de incorporação e o launch token. O iframe troca o token, uma única vez, por um token de sessão que só existe dentro do iframe; assim, tokens de longa duração nunca aparecem em URLs, logs ou cabeçalhos Referer.
3. Aposta. Quando o jogador aposta, chamamos POST {sua walletUrl}/debit, assinado com HMAC-SHA256. Você responde com o novo saldo, ou insufficient_funds.
4. Liquidação. Quando o mercado tem resultado, chamamos credit: o prêmio de uma aposta vencedora, o valor apostado de uma aposta anulada e um crédito de valor zero para uma aposta perdida, para que toda aposta seja encerrada nos seus registros.
5. Eventos. O iframe avisa a sua página do que acontece via postMessage: balance_changed, bet_placed, bet_settled, login_required, deposit_requested e outros, para que o seu cabeçalho e o seu caixa fiquem sincronizados.

O servidor do operador cria a sessão com a chave de API e entrega um launch token à página; o iframe troca o token por uma sessão; cada aposta debita a carteira do operador e cada liquidação credita, inclusive com valor zero para apostas perdidas.

O que você desenvolve

No seu servidor

Crie sessões de jogador com a sua chave de API (Sessões de jogador) e exponha os quatro endpoints de carteira (API de carteira).

Na sua página

Monte o sportsbook com o SDK de incorporação e reaja aos eventos dele (Incorporação, referência postMessage).

No back office

Autorize as origens do seu site a enquadrar o sportsbook e defina o seu tema (Incorporação, Tema).

Antes do go-live

Rode os casos de teste no sandbox e o checklist de go-live.

Convenções

• Uma mesma origem serve o sportsbook (/), a API (/api/v1), o SDK de incorporação (/embed/v1.js) e esta documentação (/docs/). O seu gerente de conta informa as origens de sandbox e de produção; localmente é http://localhost:8080.
• JSON na entrada e na saída. Toda chamada à API identifica o tenant com X-Tenant-ID.
• Valores monetários são inteiros em unidades menores (centavos): 1050 é R$ 10,50 ou US$ 10.50. Nunca ponto flutuante.
• Erros vêm como {"error": {"code": "...", "message": "...", "details": {...}}}. Decida pelo code (e por details.reason), nunca pela message.

Integração com agentes de IAEntregue ao seu agente os contratos, o roteiro de implementação e os critérios de aceite.

Início rápidoRode o sandbox e o operador de referência e veja uma aposta chegar à sua carteira.

PlaygroundMonte o sportsbook do sandbox e acompanhe cada evento.

Agregadores e provisionamento

Automatize o cadastro e a ativação de clientes pelo backend do agregador.