Seamless wallet vs transfer wallet: come si muove davvero il denaro nei giochi da casinò

Di Soft of Games editorial team · Aggiornato 2026-10-07

Ogni integrazione di giochi deve rispondere a una domanda: dove sta il saldo del giocatore mentre gioca? Un seamless wallet lo tiene sul vostro server e riceve una chiamata per ogni puntata. Un transfer wallet sposta il denaro nel sistema del provider e poi indietro. Questa guida li esamina entrambi, con i casi di errore che decidono quale scegliere.

Due posti in cui può stare un saldo

Quando un giocatore apre una slot, il denaro deve trovarsi da qualche parte dove il gioco possa raggiungerlo. Le risposte sono due.

In un seamless wallet (a volte chiamato single wallet) il saldo resta sul server dell’operatore per tutta la sessione. Il provider del gioco non detiene nulla. Ogni puntata arriva al vostro server come richiesta di debit e ogni vincita come richiesta di credit. Voi rispondete con il nuovo saldo.

In un transfer wallet l’operatore sposta una parte del denaro del giocatore su un saldo gestito dal provider. Il giocatore gioca su quel saldo. Quando esce, l’importo residuo viene riportato indietro.

Entrambi i modelli funzionano. Si rompono in modi molto diversi, ed è tra questi guasti che state davvero scegliendo.

Come funziona un seamless wallet, chiamata per chiamata

Una tipica integrazione seamless espone dal vostro lato quattro o cinque endpoint:

• Balance: restituisce il saldo attuale del giocatore nella valuta della sessione.
• Debit (puntata): sottrae un importo, identificato da un ID transazione univoco.
• Credit (vincita): aggiunge un importo, con un proprio ID transazione e collegato a un round.
• Rollback: annulla uno specifico debit precedente.
• Alcuni fornitori aggiungono una chiamata combinata bet-and-win per i giochi istantanei, o un messaggio di fine round.

L’aggregatore firma ogni richiesta, di solito con un hash HMAC calcolato sul body e un segreto condiviso, così il vostro server può rifiutare tutto ciò che non arriva da lui.

Con SoftAggregator, per esempio, l’operatore espone callback HTTP per balance, debit e credit, e le stesse callback servono slot, live casino, virtual e sportsbook. È il grande vantaggio del modello seamless: un solo set di endpoint copre ogni prodotto. SOFTSWISS, Hub88, St8 e la maggior parte dei grandi studi seguono lo stesso schema, con differenze nei nomi e nel modo di raggruppare i round.

Le tre regole che contano

1. Idempotenza. Se lo stesso ID transazione arriva due volte, applicatelo una volta e restituite la stessa risposta entrambe le volte. I retry sono normali. I doppi pagamenti no.
2. Atomicità. Il controllo del saldo e la detrazione devono avvenire in un’unica transazione di database. Altrimenti due puntate rapide da due schede possono superare entrambe un controllo del saldo che solo una avrebbe dovuto superare.
3. Tolleranza ai rollback. Riceverete rollback per debit che avete elaborato, e a volte per debit che non avete mai ricevuto perché la richiesta si è persa per strada. Registrate comunque il rollback, così se il debit tardivo arriva dopo potete rifiutarlo.

Gli sviluppatori che azzeccano queste tre regole hanno fatto la maggior parte del lavoro difficile.

Come funziona un transfer wallet

Sulla carta il flusso è più semplice:

1. Il giocatore apre un gioco. Chiamate l’endpoint “deposit” o “transfer in” del provider con un importo.
2. Il provider accredita il proprio saldo per quel giocatore.
3. Il giocatore gioca. Durante il gioco non ricevete nulla.
4. Il giocatore esce, oppure chiamate “transfer out”. Il provider rimanda indietro il saldo residuo.

Il vostro server non è nel percorso di ogni puntata, quindi velocità e uptime contano meno durante il gioco. È questo il vero vantaggio, ed è il motivo per cui alcuni operatori con backend fragili lo preferivano.

Dove si rompe ciascun modello

Seamless: il vostro server fa parte di ogni spin

Se l’endpoint wallet rallenta, rallentano tutti i giochi. Se va offline, ogni puntata fallisce su tutti gli studi contemporaneamente. I giocatori se la prendono con il gioco, non con voi, ma lasciano comunque il vostro casinò.

Le contromisure sono ingegneria standard: tenete il servizio wallet piccolo e separato dal resto del sito, posizionatelo vicino ai server dell’aggregatore, monitorate la latenza per endpoint e impostate alert sui tassi di errore.

Seamless: il round lasciato a metà

Il giocatore punta, il debit va a buon fine, il gioco mostra una vincita e la chiamata di credit fallisce tre volte. L’aggregatore continuerà a riprovare, oppure metterà il credit in coda, oppure segnalerà il round per una chiusura manuale. Chiedete al fornitore quale delle tre. Poi assicuratevi che il vostro supporto veda i round non liquidati, perché il giocatore scriverà nel giro di pochi minuti.

Transfer: denaro bloccato a metà strada

Un transfer in va a buon fine lato provider ma il vostro server non riceve mai la conferma. Per voi il denaro ha lasciato il saldo del giocatore, ma non sapete se è arrivato. O il contrario sul transfer out. Ogni caso richiede un job di riconciliazione che chiede al provider la sua versione e corregge la differenza. Moltiplicate per ogni provider e la riconciliazione diventa una fatica quotidiana.

Transfer: il giocatore su due giochi

Con un transfer wallet, un giocatore che apre due giochi di due provider ha bisogno di denaro in due posti. Molti casinò semplicemente lo impediscono, oppure ritirano tutto dal gioco A prima di aprire il gioco B. L’esperienza diventa macchinosa, soprattutto su mobile, dove i giocatori passano rapidamente da un gioco all’altro.

Transfer: il denaro bonus

Se gestite saldi bonus con requisiti di puntata, un transfer wallet rende difficile capire quale denaro viene giocato, perché il provider vede un unico saldo indistinto. Con un seamless wallet vedete ogni puntata e potete applicare le vostre regole su ciascuna.

Fianco a fianco

Dove sta il saldo durante il gioco. Seamless: sul vostro server. Transfer: sul server del provider.

Chiamate per spin. Seamless: una o due verso il vostro server. Transfer: nessuna durante il gioco, due per sessione.

Cosa si blocca se il vostro server è lento. Seamless: ogni puntata. Transfer: solo apertura e chiusura delle sessioni.

Sforzo di riconciliazione. Seamless: confrontare il vostro log con il report del fornitore. Transfer: inseguire ogni trasferimento non confermato.

Sessioni su più giochi. Seamless: naturali. Transfer: scomode.

Controllo sul wagering dei bonus. Seamless: per singola puntata. Transfer: al massimo per sessione.

Impegno di sviluppo. Seamless: maggiore all’inizio, soprattutto su idempotenza e rollback. Transfer: minore all’inizio, maggiore nella riconciliazione continua.

Quale scegliere

Per un casinò nuovo nel 2026, scegliete il seamless salvo un motivo preciso per non farlo. È il modello su cui sono costruiti quasi tutti gli aggregatori e gli studi, vi dà il pieno controllo della logica bonus e rende possibile un saldo unico su tutti i prodotti. Il lavoro che richiede è reale, ma si fa una volta sola.

Un transfer wallet ha ancora senso in pochi casi:

• State aggiungendo un singolo provider che offre solo la modalità transfer e non volete costruire un secondo percorso wallet per un unico fornitore.
• Il vostro backend non può garantire risposte rapide e non potete cambiarlo a breve.
• State costruendo un game hub che rivende a operatori con livelli tecnici molto diversi e vi serve un’opzione minima comune.

Cosa testare prima del go-live

Chiedete al vostro sviluppatore di eseguire questi test in sandbox, non solo il percorso in cui tutto va bene:

• Inviate due volte lo stesso debit. Il saldo deve cambiare una volta sola.
• Fate dormire il vostro endpoint debit oltre il timeout del fornitore. Verificate che arrivi un rollback e che venga applicato.
• Inviate un rollback per un ID transazione mai visto. Il server deve accettarlo e registrarlo.
• Aprite due giochi in due schede e puntate velocemente su entrambi. Controllate a mano il saldo finale.
• Spegnete il servizio wallet a metà round, riavviatelo e verificate se il credit in sospeso arriva.
• Confrontate un giorno del vostro log transazioni con il report del fornitore, al centesimo.

Se tutti e sei passano, il vostro wallet è pronto per i giocatori veri. Se il fornitore non vi permette di eseguirli in sandbox, aggiungetelo alle domande della nostra guida alla scelta di un aggregatore di giochi.

Una nota sul credito prepagato

Modello di wallet e modello di pagamento sono cose separate, ma gli operatori a volte li confondono. Alcuni aggregatori vi fatturano mensilmente il GGR. Altri chiedono un credito prepagato che si consuma man mano che i giocatori perdono. Con un modello prepagato il vostro seamless wallet funziona esattamente allo stesso modo. L’unico compito in più è tenere d’occhio il livello del credito, così i giochi non si fermano quando finisce. SoftAggregator usa questo approccio prepagato, con ricariche in USDT o USDC: comodo per i casinò crypto che detengono già stablecoin, ma qualcuno deve occuparsi delle ricariche.