Integration Guide · 2026
Free spins and jackpots through a casino API: how bonuses reach the game
Most bonus work happens on your side: deposit offers, cashback, wagering. Two promotions cross into the game itself: free rounds and jackpots. How they are issued, played and paid through a casino API decides whether your bonus team can launch a campaign in a day or has to raise a ticket with every studio.
The short version
- Free rounds are issued to a player for set games, a bet value, a number of rounds and an expiry.
- Their winnings reach your wallet as a normal credit, tagged so wagering can apply.
- Jackpot contributions and wins arrive as their own events; reconcile them separately.
- Support differs by studio: confirm which games accept free rounds before you plan.
- Keep bonus rules in one place, not in each game.
How free rounds work
A free-round award typically names the player, one or more games, the number of rounds, the bet value, the currency and an expiry date. When the player opens a listed game, it shows the rounds available. The rounds are played without taking a stake from the balance, and the winnings are credited to your wallet per round or when the award is completed, depending on the studio.
The exact fields and the moment of payout differ between studios, which is why a normalised layer helps: your bonus system talks to one interface instead of learning each provider’s variant.
Wagering and tagging
A free-round win is still a win. What makes it manageable is the tag: the credit carries a reference to the award, so your bonus engine can move it to a bonus balance and apply wagering, or pay it as cash if that is your offer. Without the tag, bonus money and real money mix in reporting.
Three kinds of jackpot
| Type | Who funds it | How it reaches you | What to reconcile |
|---|---|---|---|
| In-game fixed jackpot | The game’s own maths | A normal win in the round | Nothing extra; it is a win |
| Provider network progressive | Contributions from bets across connected operators | Contribution and win events from the provider | Contributions per bet and each jackpot win |
| Local or operator jackpot | Your own promotion budget | Your platform, using round data from the API | Qualifying bets and the prize you paid |
One stream for reporting
Bonus and jackpot activity is a common source of differences between provider reports and your wallet. Through the IGP online casino API, rounds, bets, wins, bonus contribution and jackpot events arrive in one normalised stream that you reconcile against your wallet daily. As our API page puts it, a bonus can be written once and honoured everywhere, because there is only one place for it to land.
Before you run a campaign
- Get the list of games that accept free rounds in your market.
- Set the bet value and currency per award, not per campaign.
- Test an award that expires unused and one that is used halfway.
- Check that the win arrives tagged and lands in the right balance.
- Reconcile the first day of the campaign before scaling it.
Frequently asked questions
Bonuses that land in one place
One integration for 150+ providers and 18,000+ games, with rounds, bonus and jackpot events in one normalised stream.
