Quasi tutti gli aggregatori di giochi da casinò oggi si integrano con gli operatori tramite un seamless wallet. Il modello è semplice da descrivere e facile da sbagliare nei dettagli. Questa guida ripercorre cosa succede durante un round di gioco e cosa testare prima che circoli denaro reale.
Il principio
L’operatore possiede il ledger. Il saldo del giocatore non passa mai all’aggregatore né allo studio. L’aggregatore chiede invece al wallet dell’operatore qual è il saldo, gli dice di registrare una puntata e gli dice di pagare una vincita. L’operatore risponde a ogni chiamata con il nuovo saldo o con un errore.
Un round di gioco, passo dopo passo
- Lancio. L’operatore chiede all’aggregatore l’URL di un gioco per un dato giocatore, valuta e gioco. L’aggregatore restituisce un URL che l’operatore carica per il giocatore.
- Saldo. Il gioco chiede il saldo; l’aggregatore chiama l’endpoint di saldo dell’operatore.
- Debito. Il giocatore gira. L’aggregatore chiama l’endpoint di debito dell’operatore con un ID transazione, un ID round e un importo. L’operatore verifica i fondi, registra la puntata e restituisce il nuovo saldo.
- Credito. Il round si conclude. L’aggregatore chiama l’endpoint di credito con l’importo vinto, che può essere zero, e lo stesso ID round.
- Rollback, se serve. Se il debito è stato registrato ma il round è fallito, l’aggregatore invia un rollback della transazione originale.
Cinque regole che evitano contestazioni sul saldo
- Idempotenza su ogni chiamata. Un ID transazione ripetuto deve restituire il risultato originale, mai una seconda registrazione.
- Rollback solo di ciò che esiste. Un rollback per una transazione sconosciuta va confermato senza muovere denaro.
- Crediti dopo i rollback. Decidete e documentate cosa succede quando arriva un credito per un round già annullato.
- Timeout. Concordate quanto aspetta l’aggregatore e quante volte riprova. Un wallet lento provoca chiamate duplicate.
- Precisione delle valute. Concordate se gli importi vengono inviati in unità o sottounità, soprattutto per le crypto con molti decimali.
Test prima del lancio
Eseguite ogni scenario in sandbox: fondi insufficienti, debito duplicato, credito duplicato, rollback dopo il debito, rollback di una transazione sconosciuta, credito dopo il rollback e timeout del wallet. Registrate ogni richiesta e risposta con l’ID transazione, così l’assistenza può ricostruire un round contestato in pochi minuti.
Seamless o transfer?
I transfer wallet spostano denaro in una sessione e poi indietro. Semplificano alcune integrazioni con i fornitori, ma dividono il saldo tra più sistemi. Il seamless mantiene un’unica fonte di verità, ed è per questo che la maggior parte degli operatori lo preferisce. Hub88 è uno dei pochi aggregatori che documenta entrambi.
Domande frequenti
Che cos'è un seamless wallet?
Un modello di integrazione in cui il denaro del giocatore resta nel sistema dell'operatore. L'aggregatore o il server di gioco chiama l'operatore per ogni verifica del saldo, puntata e vincita.
Qual è la differenza tra wallet seamless e transfer?
Con un transfer wallet il denaro viene spostato nella sessione del fornitore di giochi e riportato indietro alla fine. Con un seamless wallet non lascia mai il ledger dell'operatore.
Cos'è l'idempotenza in un'API di wallet?
La garanzia che elaborare due volte la stessa richiesta abbia lo stesso effetto che elaborarla una volta. Ogni debito e credito porta un ID transazione univoco, così una chiamata ripetuta non viene registrata due volte.
Cosa succede se un debito va a buon fine ma il round di gioco fallisce?
L'aggregatore invia un rollback (a volte chiamato refund o cancel) che fa riferimento alla transazione originale, e l'operatore restituisce la puntata al giocatore.
Quali aggregatori usano un seamless wallet?
La maggior parte. SoftAggregator, SoftGamings e Hub88 lo dichiarano pubblicamente; Hub88 offre anche un'opzione TransferWallet.