Turnkeyxgaming

Glossary

What is a seamless wallet?

A seamless wallet is a casino integration model in which the player's balance lives only in the operator's ledger, and every bet and win from any game is a real-time debit or credit request to that ledger.

3 min readUpdated By the Turnkeyxgaming team

How it works in practice

When a player opens a game, the game asks the operator's wallet for the balance. Each bet becomes a debit request and each result a credit request, both carrying a unique transaction ID so that retries never move money twice. Because the balance never leaves the operator, the player has one balance across every studio and the sportsbook.

The alternative is a transfer wallet, where funds are moved into separate game balances. The seamless vs transfer wallet guide compares the two.

What the operator wallet has to get right

Every debit and every credit needs an id you have stored with the decision. A retry after a lost response must return that decision and must not move the balance again. A timeout policy is a different rule: it says what you do when the answer never comes. Idempotency says the second delivery is safe. You need both, and they are not the same paragraph in the design doc.

The balance the game shows has to be the balance the cashier shows. A player who deposits and cannot bet, or who wins and cannot withdraw, is looking at a wallet that split the truth. Limits and self-exclusion belong in the same decision as the debit. A limit checked only on the lobby, and skipped by the callback, does not cover the round.

Checks that show the wallet is actually seamless

  • One spendable balance is visible in the cashier and inside two studios that do not share a client
  • A repeated debit with the same transaction id does not take the stake twice
  • A credit retry after a dropped response still pays exactly once
  • A zero win closes the round instead of leaving the stake reserved
  • A deposit limit or self-exclusion refuses the debit, not only the tile on the homepage
  • Sports reservations and casino rounds draw on that same ledger, or you have documented a second balance on purpose

The game never holds the cash balance

If a studio can only move funds into its own pot, ask whether that pot can be hidden behind the seamless contract so the player still sees one balance. A second balance the player must transfer is the other model, even if the sales line used the word seamless.

A €50 round that times out, in balance terms

A player opens a slot with €120.00 spendable. At 12:00:01 the game asks for a €50.00 debit. The operator commits it, so the balance is €70.00, but the response is lost on the way back. At 12:00:04 the game retries with the same transaction id. A wallet that treats the retry as new work debits again and the player is at €20.00 for one spin.

The retry has to return the stored result: the €70.00 balance and the original acceptance. At 12:00:09 the studio voids the round because its own session died. The wallet receives a rollback for the same transaction id, releases €50.00, and the player is back at €120.00 with three ledger lines and a net movement of zero.

Now the same player wins €12.40 on a €2.00 stake. Debit to €118.00, then a credit of €12.40 at settlement to €130.40. If your cashier showed €118.00 for the seconds in between, it was right. If it showed the win before the credit arrived, the player has a screenshot that your own ledger contradicts.

The same round read from the wallet's side

MomentCallBalanceWhat a wrong wallet does
Launchbalance query€120.00Returns the total including locked bonus funds, so the game sizes bets against money the player cannot stake
Debit accepteddebit €50.00€70.00Commits the row after sending the response, so a crash loses the record of a live stake
Response lostretry, same id€70.00Treats the retry as new work and the player is at €20.00
Studio voidsrollback €50.00€120.00Posts the release as a win, which inflates turnover and GGR for a round that returned nothing
Next rounddebit €2.00€118.00Reserves nothing, so a slow settlement drives the balance negative mid-round

FAQ

Questions operators ask

Does Turnkeyxgaming use a seamless wallet?

Yes. Integration is seamless by default. The casino wallet API page documents the calls.

Where does the player's money sit during a round?

In the operator ledger. The stake is reserved or debited there. The studio asks for the movement. It does not open a balance of its own for that player.

What fails first if the wallet is slow?

Launches start to time out and debits get retried. If the retry is not idempotent, the slow wallet also becomes a double stake. Fix the response time and the stored decision together.

Can a player withdraw while a round is still open?

The reservation has to win. Treat the staked amount as unavailable until the round settles or rolls back, so a withdrawal request cannot empty the balance underneath a live round. If the cashier calculates available balance as total minus pending withdrawals only, a player can withdraw the stake of a spin that is still running and the round then settles into a negative balance.

Do we send a rollback if the studio never debited?

No, and sending one is worse than useless because it credits money that was never taken. Match every rollback to the debit's transaction id and reject any release whose debit is not in your table. That single check catches most duplicate-payout incidents, since a rollback with no matching debit is either a retry or a bug on the studio side.

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 · WalletsSeamless vs transfer walletA seamless wallet debits your ledger per round. A transfer wallet moves a balance into the game and back, and that split shows.Read
  • GlossaryGame aggregatorA game aggregator links an operator to many studios through one integration, one contract, one shared wallet and one reconciliation file.Read
  • Product · Casino APICasino APIThe casino API is one contract — a catalogue, a launch call and wallet callbacks — built once and reused for every studio we connect.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.

Telegram @turnkeyxhub WhatsApp Email Contact form