Glossary
Settlement is when the result becomes money
Settlement closes a round or a market. A casino round settles with a credit, including a zero credit. A sports bet settles when the result is applied. A void settles by releasing the stake.
3 min readUpdated By the Turnkeyxgaming team
Pending stake is not revenue
Pending is not settled. Reporting that counts pending stake as revenue will reverse itself the next morning. Use settlement time as the reporting clock and say so in the file, which is the point of the daily GGR guide.
Corrected results re-settle. The correction should be a new ledger entry that references the original, not an overwrite that erases the mistake. Auditors follow the references.
Corrections are new entries
When a result is corrected, post a reversing entry and a new settlement that both point at the original bet. Overwriting the row leaves you unable to explain the balance the player saw yesterday.
Casino rounds and sports bets can settle hours apart for the same player. A daily file that uses bet-placement time for one and settlement time for the other will not match either invoice.
Print the clock on the file: settlement time, and the timezone name. Traders who want placement time can have it in a second column. One field called 'date' that sometimes means the bet and sometimes means the result is how Sunday's pending coupons become Monday's revenue and then reverse when the match ends.
Give voids, cash-outs and ordinary results different codes. A single 'closed' flag does not say whether the stake went back, whether a cash-out price was paid, or whether the original odds stood. Support will invent an explanation, and the ledger will disagree with it. The daily GGR guide is the file shape. This page is the meaning of the moment the file is allowed to count the row.
What each end-state does to money and to the report
| End state | Wallet | What the report may count |
|---|---|---|
| Still pending | Stake or liability stays reserved | Nothing as revenue |
| Settled win | A credit posts | Stake and winnings, on the settlement clock |
| Settled loss | The reservation is consumed. A casino loss still closes, including at zero | The stake, once the round is closed |
| Void | The stake is released | Neither stake nor winnings |
| Corrected result | A reversing entry and a new settlement, both citing the original id | The mistake and the fix, not a silent overwrite |
Pending is a balance state, not a quiet success
If the player can still see the stake as unavailable, the bet is not finished. A dashboard that paints pending rows green will be quoted in the dispute. Show reserved, settled or voided, and use those words in the history line.
Three tickets, three settlement paths
Ticket one is a single €20 at 2.50. It wins, so €50 is credited and the €20 reservation is consumed: a net gain of €30.
Ticket two is a €10 double at 1.80 and 2.10 with the second leg void. The void leg is treated as 1.00, so the bet pays 1.80 and returns €18.00 rather than the €37.80 it would have paid had the leg won. A platform that voids the whole ticket returns €10 and is out by €8.
Ticket three is a €50 single on a match abandoned before kick-off. The bet is void, the €50 is released, and history shows it as voided rather than cancelled, because the difference is whether the stake went back.
All three settle. Only one is a win. A report that counts settled tickets as revenue books the loss as a stake and the void as nothing, which is correct, and then books the pending rows as revenue, which is not.
What each end state is worth on a €20 ticket at 2.50
| End state | Credit | Reservation | What the report may count |
|---|---|---|---|
| Won | €50.00 | Consumed | Stake €20 and winnings €50 |
| Lost | €0.00 | Consumed | Stake €20 |
| Void before the start | €20.00 | Released | Nothing |
| Cashed out at 1.40 | €28.00 | Consumed | The cash-out price, not the original odds |
| Corrected after settlement | A reversing entry and a new credit | Reopened, then closed | The corrected result, with both entries visible |
Where settlement and reporting part company
- A zero-credit casino round is left pending, so the stake stays reserved and the day never closes cleanly.
- Corrections overwrite the original row, and yesterday's balance can no longer be explained to the player who saw it.
- Void, cash-out and ordinary result share one closed flag, so support invents a story the ledger cannot support.
- Pending bets are counted at placement time in one report and at settlement time in another, on purpose, by different teams.
- A multi-leg ticket pays after each winning leg, as though it were several single bets placed together.
FAQ
Questions operators ask
Is a cash-out a settlement?
It settles that bet early, at the cash-out price, if the product accepted it. Until acceptance it is pending, and the original bet is still open.
Does a zero-credit casino round still settle?
Yes. A lost round settles at zero. Leaving it pending because there was nothing to credit keeps the stake reserved and the report open.
When does a multi-leg ticket settle?
When that betslip's rules say the last open leg is determined, or sooner if a lost leg already decides the ticket. Do not pay a return after each winning leg unless the product was built as separate bets. Open legs stay reserved until their own settlement code arrives.
Can a settlement be reversed after the player has withdrawn?
It can, and the outcome is a negative balance or a debt depending on your terms. The rule has to exist before the event: either the correction is absorbed, or the account is flagged and told why. Discovering the answer while applying a correction is how a small arithmetic error becomes a formal complaint.
What is the right treatment when a market settles the wrong way by mistake?
Post a reversing entry that cites the original, then settle again at the correct result, and keep both visible. Moving the player's balance is unavoidable either way. What differs is whether you can show why it moved, and an auditor will ask for the reason rather than for the corrected total.
Keep reading
Related pages
- 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
- Guide · WalletVoids and rollbacksWhen a studio voids a round, the rollback returns exactly the stake the debit took, keyed to the original transaction id.Read
- GlossaryOdds feedAn odds feed sends fixtures and prices into a book you operate. It does not draw the coupon, price your book or settle the bets.Read
- Product · WalletWalletBalance, bet, win and rollback on one seamless wallet: idempotent transaction ids shared by casino games and sportsbook alike.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.