Perguntas frequentes

Por que um launch token e não o próprio token de sessão?

Uma URL é copiada para o histórico do navegador, logs de servidor, analytics e cabeçalhos Referer. Um launch token encontrado nesses lugares é inútil: ele funcionou uma vez, em até dois minutos. O token de sessão, de longa duração, nunca sai do seu servidor nem do iframe.

Os jogadores podem navegar antes de entrar?

Sim. Monte sem launchToken. Cotações, placares ao vivo e o boletim funcionam; fazer uma aposta ou abrir Minhas Apostas envia login_required. Depois do seu login, envie o novo launch token com setLaunchToken(): o iframe não é recarregado e o boletim é mantido.

Preciso avisar a plataforma quando o saldo do jogador muda do meu lado?

Não. O sportsbook consulta o seu endpoint /balance quando mostra o saldo. Depois de um depósito no seu caixa, chame refreshBalance() para o iframe mostrar o valor na hora.

Com base em quais eventos devo contabilizar dinheiro?

Nenhum. Contabilize dinheiro só pelas chamadas de carteira que você recebe e confirma. Eventos do navegador (bet_placed, balance_changed, bet_settled) são para a sua interface e para analytics.

O jogador perdeu. Por que recebo um crédito?

Toda aposta liquidada recebe exatamente um crédito payout:, com amount: 0 quando perde. Ele avisa que a aposta foi encerrada. Veja Créditos de valor zero.

E se a minha carteira cair?

As apostas são recusadas enquanto não conseguimos falar com você (o jogador vê que o sportsbook está temporariamente indisponível). Créditos e rollbacks são retentados com o mesmo txId até você responder, então nada se perde; basta processar cada txId uma única vez.

Por que recebi um rollback de um débito que nunca vi?

O nosso débito não chegou até você, ou a sua resposta não chegou até nós, em 5 segundos. Recusamos a aposta e revertemos por segurança. Responda 2xx, guarde o ref e recuse esse débito se ele chegar algum dia.

Um saldo pode ficar negativo?

Só por uma correção depois de uma reliquidação: se um resultado é corrigido e o jogador recebeu a mais, debitamos a diferença (kind: resettle), que você deve aplicar mesmo que o jogador já tenha gastado o valor.

Posso incorporar em vários domínios?

Sim: adicione cada origem aos embedOrigins. Origens são exatas: https://www.example.com e https://m.example.com são duas entradas.

Quais idiomas estão disponíveis?

Inglês (en) e português do Brasil (pt-BR). Passe locale ou chame setLocale().

Posso usar as minhas fontes e cores?

Sim, pelo tema: todas as cores, a fonte, o arredondamento, a densidade e o layout são tokens que você edita no back office (Tema).

Existe um ambiente de testes?

Sim: o sandbox, com partidas simuladas e dinheiro de mentira. Veja Testes.