Guide · Wallet
One player can have more than one wallet currency
Operators sometimes keep EUR for casino and a local currency for sport, or a cash wallet beside a bonus wallet. The game has to be told which balance to use. It must not convert money on its own.
7 min readUpdated By the Turnkeyxgaming team
The launch call picks the wallet
Pass the currency and the player id that together identify the balance. A game session sticks to that currency until it ends. Switching currency mid-round is how you get a debit in EUR and a credit in BRL for one spin. If the player changes wallet, close the session and launch again.
Foreign-exchange conversion, if you offer it, happens in your cashier before the balance exists. The stake the game sees is already in the session currency. Doing a second conversion inside the game client produces a rate nobody can reproduce for a dispute. Show the currency code on the balance chip so a player with two wallets knows which one is open.
A bonus balance beside a cash balance is not a second currency, and it is not an exchange rate. If the campaign stakes from the bonus balance, the launch has to name that balance. A session opened against cash will debit cash even while a bonus sits unused, and a session opened against the bonus will refuse a stake the cash wallet could have covered. Close and relaunch when the player switches. Do not retarget the open round.
Checks before the session is allowed to stake
The launch call is the moment the wallet is chosen. Everything after that assumes the choice was deliberate.
- Player id and currency together identify one balance. Currency alone is not a wallet when the player holds two.
- The session stays on that currency until it ends. A mid-round switch would debit one code and credit another for a single spin.
- Any conversion already happened in the cashier, with the rate stored there. The game receives a balance, not a request to convert.
- The balance chip shows the currency code, not a symbol that several currencies share.
- Closing the session is the only path onto a different wallet. The open round is not edited.
Currency rules
- 01
Bind the session
Lock the round to the currency you passed at launch.
- 02
Convert earlier
If you convert, do it in the cashier and record the rate there.
- 03
Show the code
Display the currency code beside the balance, not only a symbol that several currencies share.
Do not let the client convert a shortfall
If the euro wallet is short and a dollar wallet would cover the stake, that is a cashier transfer the player asks for. A game that silently borrows from the other wallet writes a round nobody can replay, because the rate existed only inside the client.
Worked example
A two-wallet session, line by line
A player holds a EUR cash balance and a BRL sports balance. The casino session launches against the EUR wallet and stays there: the balance call, the debit and the credit all carry EUR, and the round's history line records EUR. When the player moves to the BRL product, the platform closes the EUR game session and opens a BRL session against the other balance. Nothing is converted during either round.
If the player wants to move value between the two, the cashier does it before the next launch and stores the rate on the transfer. The new session then sees the post-transfer balance. The failure case is a client that covers a shortfall by borrowing from the other wallet: it writes a round with a rate that exists only inside the client, and no one can reproduce the number when the player disputes it.
One player, two balances, no silent conversion
| Event | Wallet used | Currency on the line | What is stored |
|---|---|---|---|
| Casino launch | EUR cash | EUR | Session id bound to the EUR balance |
| Spin debit and credit | EUR cash | EUR | One round id, both lines in EUR |
| Switch to sport | BRL sport | BRL | The EUR session is closed, a new BRL session opens |
| Cashier transfer | Both | Two lines | The rate and the transfer id, before the next launch |
FAQ
Questions operators ask
Can one spin stake EUR and pay the win in USD?
It should not. Debit and credit for a round use the session currency. Conversion between player wallets is a separate cashier action.
Can two game windows stake different currencies for the same player?
Only as two sessions, each launched against its own balance. They must not share a round id or a single debit stream. If your policy is one open session, refuse the second launch instead of merging the currencies.
Where is the exchange rate stored for a later dispute?
On the cashier transfer that created the balance, if you converted at all. The round itself has one currency. There is no rate to attach to the spin, because the spin never converted anything.
Is a bonus balance a second currency?
No. It is a second balance in the same currency, and the launch call has to name which balance the session uses. Treating it as a currency hides the real decision and makes the wallet history harder to explain.
Keep reading
Related pages
- Product · WalletWalletBalance, bet, win and rollback on one seamless wallet: idempotent transaction ids shared by casino games and sportsbook alike.Read
- Guide · WalletDisplay currencyShowing one currency while the game settles in another becomes a dispute when the rate stays hidden. Publish the rule first.Read
- Product · PaymentsPaymentsDeposits and withdrawals stay with your payment firms. The aggregator never moves SEPA, cards or USDT and never holds player funds.Read
- Guide · ArchitectureHow a casino API worksOne casino round traced end to end: catalogue, launch, wallet callbacks, settlement and the report line the next morning.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.