Quick Start
Get a working iFrame integration in 3 steps.
Step 1: Embed the iFrame
Copy the integration module into your project, then configure it and mount the iFrame into a container element:
integration.init({ languages: ["en"] });
integration.mount("sportsbook", "https://{iframe-host}/{lang}/?jwt={jwt-token}");mount() creates the iframe element for you, with the attributes the iFrame needs — including the allow permissions that video streaming depends on.
See Getting Started for the URL parameters and a complete integration with event handling.
Step 2: Implement Seamless Login
Generate a JWT token on your backend and pass it to the iframe URL. You’ll need:
- Generate RSA key pair (
openssl genrsa > private.pem && openssl rsa -in private.pem -pubout -out public.pem) - Expose the public key via a secure endpoint (IP-whitelisted)
- Sign JWT tokens with your private key containing
externalUserIdanddefaultCurrency
See Players Authorization for full details.
Step 3: Implement Wallet Endpoints
Implement three endpoints on your platform:
| Endpoint | Purpose |
|---|---|
GET /balances | Return player’s current balance |
POST /transactions | Process deposits, withdrawals, rollbacks |
GET /transactions/{id} | Look up a transaction by ID |
The wallet flow is identical for iFrame and Sportsbook API integrations, so it is documented in its own top-level section: see Wallet Integration for full details.
What’s Next?
- Frontend Integration — the integration module, embedding, and every event
- All Events — what the iFrame sends you, and what you send it
- Bonuses — Freebet, Sport Bonus, Cash Bonus
- Supported Languages & Currencies