Sportsbook: SDK

The sportsbook runs in an iframe inside your site. The SBRenderer library mounts the iframe, hands over the player session and tells your site when the player wants to log in or deposit, or when the session expires.

Overview#

1. On the server, launch with game: "sportsbook" and extract the jwt parameter from the launch_url.
2. In the browser, load the library and call initialize with the jwt and your brand.
3. Bets reach your wallet through the callbacks, like any game.

1. Launch on the server#

import { talos } from './talos' // see Authentication

export async function sportsbookToken(playerId: string, lang: string): Promise<string> {
  const res = await talos('POST', '/v1/game/launch', { player_id: playerId, game: 'sportsbook', lang })
  if (!res.success) throw new Error(`${res.error.code}: ${res.message}`)
  return new URL(res.data.launch_url).searchParams.get('jwt')!
}

The jwt is valid for 10 minutes and is single-use: generate a new one every time you mount the sportsbook and when the session expires. For visitors (not logged in) do not launch — mount the sportsbook with token: null.

2. Library in the browser#

The library is served by the sportsbook itself:

<div id="sportsbook" style="height: 100vh"></div>
<script src="https://<sportsbook>/sb-renderer.min.js"></script>
<script>
  const sportsbook = new SBRenderer()
  sportsbook.initialize({
    target: document.getElementById('sportsbook'),
    brand_id: 'my-brand',             // GET /v1/merchant → brand
    token: jwtFromYourServer,         // null = visitor
    lang: 'en',
    onLogin: () => openLogin(),
    onRegister: () => openSignUp(),
    onRecharge: () => openDeposit(),
    onTokenExpired: async () => (await fetch('/api/sportsbook/token', { method: 'POST' }).then((r) => r.json())).jwt,
    onBalanceChange: ({ amount, currency }) => updateHeaderBalance(amount, currency)
  })
</script>

The iframe fills 100% of the target: give it a height. The sportsbook URL comes from the script origin; to serve the script from elsewhere, pass url.

Options#

Events#

Errors inside your callbacks are caught and logged; they do not bring the sportsbook down.

Methods#

sportsbook.updateOptions({ token: newJwt })      // login/logout without reloading
sportsbook.updateOptions({ lang: 'es' })        // live language switch
sportsbook.updateOptions({ themeName: 'gold-navy', layout: 'classic' })
sportsbook.navigate('/soccer')                   // navigates inside the sportsbook
sportsbook.refreshBalance()                      // after a deposit/withdrawal on your site
sportsbook.kill()                                // removes the iframe

updateOptions accepts everything except target, brand_id and url. Calling initialize again replaces the iframe.

Login, visitor and renewal#

• Visitor: mount with token: null. The player browses and builds the betslip; the betslip and "My bets" show the "Log in" button, which calls onLogin.
• After login: launch on the server and call updateOptions({ token }), without reloading the iframe.
• Logout: updateOptions({ token: null }).
• Expired session: implement onTokenExpired returning a new token. Several simultaneous expirations become a single call. If your callback fails, the player continues as a visitor.

Themes and layouts#

By default, theme and layout come from your brand configuration. themeName and layout override them only on that page.

Themes: mint-carbon, azure-carbon, gold-navy, emerald-carbon, flame-carbon, lilac-plum, brasil-navy, lilac-light, canary-plum, red-navy, coral-light, aqua-carbon, navy-light, amber-carbon.

Without the library#

The launch_url also opens directly in an <iframe src>. You lose the events (login, deposit, balance, expired session) and automatic renewal; use it only for tests.