Integration FAQ

The short version: you send us events, we send you payouts, and two script tags to integrate on the frontend. Unibo runs the campaigns, leaderboards, prize logic, notifications and backoffice.

What's required?

Three things. Nothing else.

1. Event stream (you call us)
One endpoint, one API key per brand, JSON batches.

POST https://consumer.unibo.io/api/v1/events
x-api-key: <your brand key>

2. Rewards endpoint (we call you)
When a player wins a prize, Unibo calls your API with the player id, the reward, amount, currency and a unique reference. You credit the player. Auth is an API key header or an IP allow-list.

3. Widgets (script tags)
Set required cookies per integration type and load one script per widget. The widget mounts itself.

How long does the integration take?

About one week end-to-end.

Piece	What you build	Effort
Event stream	Forward bets and wins to one Unibo endpoint	1–2 days
Rewards	One endpoint on your side that credits a bonus or free spins	1–2 days
Players & games	Send `player` and `game` events on the same stream	Hours
Widgets	Script tags	Hours

General FAQs

What should be included in a game round?

Two events per round, a bet and a win, sharing the same round_id. Nine fields, all required:

{
  "event": "gameround",
  "data": {
    "unique_id": "bet-f7ltid",
    "timestamp": "2025-01-15T12:00:00Z",
    "player_id": "StQ-1",
    "game_id": "GD8",
    "round_id": "f7ltid",
    "amount": 0.5,
    "currency": "EUR",
    "is_win": false,
    "is_bonus": false
  }
}

timestamp is when the bet happened, in UTC. Not when you sent it.
amount is a positive number. currency is an ISO-4217 code.
The win is the same event again with is_win: true.

Do you need a separate API for games and players?

Optional. Send player and game events on the same stream: one initial seed of what you have, then updates as they happen.

Unibo stores only your IDs, never names or emails. A pull API on your side is optional and used only for reconciliation.

What prizes can Unibo pay out?

Anything your rewards API can credit today. Cash, free spins, bonus money etc.

We map your reward IDs into the Unibo backoffice. Every payout carries a unique reference, so a retried call never pays twice. Prizes your API cannot issue can still exist as manually handled catalog prizes.

How do we add the UI?

Mark the game container with data-unibo-gameframe, set the player cookies or data attributes, load /in-game/widget.js. A button plus progress and win notifications mount automatically. Works for every operator running your games.

Ready to get started?

Pick the guide that matches your next step.

Event Stream — check the event requirements and send your first event
Metadata — understand the player and game data requirements
Rewards — connect your existing rewards API
In-Game Widget — add the in-game UI component

Was this helpful?