Guide · Bonuses
Free-round winnings arrive as flagged credits
An awarded free round has no cash debit. The win, if any, arrives as a credit marked so you can tell it from a normal spin. What happens next is your campaign: cash, bonus balance, or wagering.
7 min readUpdated By the Turnkeyxgaming team
Do not treat the credit as a deposit
If the campaign says winnings are bonus funds, move them to the bonus balance and start the wagering requirement you showed the player. If the campaign says they are cash, they are withdrawable and they are still not GGR in the way a normal spin is, because the stake was not cash. The daily file needs that distinction. The player needs it in the history line.
Not every game accepts external free rounds. The free spins page covers the award call. A campaign that targets ineligible games will look 'sent' and never appear. Filter the game list first. Expiry is part of the award. A round that expires unused is not a loss and not a win.
Route the flagged credit to the balance the campaign named, and start wagering only if that campaign said the winnings wager. A credit dropped into cash because the flag was ignored becomes withdrawable immediately, which may contradict the terms the player accepted. A credit dropped into the bonus balance when the terms said cash does the reverse. The history line has to say free-round win either way, so it is not read as a deposit or as an ordinary spin the player funded.
How a free-round outcome hits the wallet
There is no cash debit at the start. Everything that follows is a campaign rule applied to a flagged credit, or to the absence of one.
| Outcome | Cash stake? | What you record |
|---|---|---|
| Rounds awarded, not yet played | No. | An award against eligible game ids, with an expiry. Nothing in GGR. |
| A win on a played free round | No. The win is promotional cost. | A flagged credit to the balance the campaign named. History says free-round win. |
| Unused rounds expire | No. | Neither a loss nor a win. Do not post a zero-stake debit to 'use them up'. |
| A later spin the player funds in cash | Yes. This one is ordinary stake. | A normal debit and credit. Wagering, if any, follows the campaign from here. |
After the credit lands
- 01
Read the flag
Route flagged free-round credits to the balance the campaign specified.
- 02
Show the source
Label the history line as a free-round win, not as a deposit.
- 03
Eligible games
Only award rounds on titles the catalogue marks as eligible.
An unflagged free-round win looks like a deposit
Deposits have a payment trail. This credit does not. If the flag is dropped, finance, wagering and the player history will all treat a promotional win as money the player added. Keep the flag on the line.
One campaign, four documents, and the morning the credits arrive
Take a campaign of fifty rounds at a fixed stake on a single title, aimed at players who deposited in the previous week. The brief marketing signs holds four facts: the game, the stake per round, how many rounds, and the moment the unused ones stop being usable. That brief is the only place the number fifty exists. If the award call is assembled from a screenshot of it, the expiry will be missing, and support will have nothing to quote when a player asks where the rounds went.
The order matters. Eligibility is a query on your side, not the studio's. Filter the game list before the award, because a title without the free-round flag stores a promise the client cannot show. The award then goes out with the stake, the count and the expiry attached. The studio plays the rounds and returns credits. Your wallet routes each flagged credit to the balance named in the brief, writes a history line, and posts the promotional cost where the daily file can keep it apart from cash stake.
The step that slips is the campaign reference. Two campaigns can run on the same title in the same week, and a credit carrying no reference is matched by guesswork. Put the reference on the award you send, keep it beside the campaign terms, and record how each credit was matched back. When the studio's promotional report and your ledger disagree, that reference is the field that lets finance find four credits rather than a week of them.
Four fields an award needs, and the failure when one lives only in the brief
Each belongs on the award itself, so a colleague who missed the campaign meeting can still answer a ticket.
| Field | Where it has to exist | What breaks without it |
|---|---|---|
| Stake per round | On the award, and in the campaign record | The player meets a different stake from the one the terms promised |
| Number of rounds | On the award, as a count the wallet can read back | Support cannot tell a partial award from a complete one |
| Expiry | On the award, in the timezone the terms use | Rounds die while the terms page still offers them |
| Campaign reference | On the award and in the bonus engine | Two campaigns on one title become indistinguishable at credit time |
FAQ
Questions operators ask
Does a free-round win count as player stake?
No. There was no cash stake. Count the win as promotional cost, and only count later cash spins as stake.
Does the free-round win count toward stake for the daily revenue file?
No. There was no cash stake. The win is promotional cost. Only a later spin the player actually funds is stake. Mixing the two is how the cash line stops matching the studio.
Why did the award succeed in the tool and never appear in the game?
The title was not eligible. Filter to games the catalogue marks for external free rounds before you send the award. A success response against an ineligible id means the campaign stored a promise the client cannot show.
Two campaigns are running on the same title. How do we tell one credit from the other?
Put a campaign reference on each award and keep it with the terms. If the credit that comes back does not carry the reference, match on the award you sent and the window it was valid for, then write the match down. Do not assume the earlier campaign, because the second one is usually the one still being advertised.
The title a campaign was built on gets disabled before players open their rounds.
The rounds cannot be launched, so the award is a promise with nowhere to go. Cancel the awards for that game id and decide in writing whether to reissue on a title the catalogue still marks eligible, or to let the campaign lapse. Read the published terms on substitution before choosing, and tell support which of the two you picked.
Keep reading
Related pages
- Feature · Free spinsFree spinsAward free-spin campaigns across studios in one call. Wins arrive as flagged credits on your wallet, with no cash stake behind them.Read
- Guide · BonusesWagering contributionBonus wagering weights live in your bonus engine. Slots, live tables and crash rounds should not count the same toward clearing.Read
- Guide · FinanceThe daily GGR fileThe daily GGR file agrees stake, win and the difference in one closing timezone, with bonus-funded wins marked for reconciliation.Read
- Solution · PlatformCasino platformPlayer accounts, a back office, a bonus engine and multi-brand support, wired to the game aggregator and the shared wallet.Read
Get a written quote and sandbox access
Tell us your licence, target markets and products. You get the GGR rate in writing, the studio list for your markets and sandbox credentials.