Presque tous les agrégateurs de jeux de casino s’intègrent aujourd’hui aux opérateurs via un seamless wallet. Le modèle est simple à décrire et facile à rater dans les détails. Ce guide décrit ce qui se passe pendant un tour de jeu et ce qu’il faut tester avant que l’argent réel circule.
Le principe
L’opérateur possède le registre. Le solde du joueur ne part jamais chez l’agrégateur ni chez le studio. L’agrégateur demande au wallet de l’opérateur quel est le solde, lui dit de prélever une mise et lui dit de payer un gain. L’opérateur répond à chaque appel avec le nouveau solde ou une erreur.
Un tour de jeu, étape par étape
- Lancement. L’opérateur demande à l’agrégateur une URL de jeu pour un joueur, une devise et un jeu donnés. L’agrégateur renvoie une URL que l’opérateur charge pour le joueur.
- Solde. Le jeu demande le solde ; l’agrégateur appelle l’endpoint de solde de l’opérateur.
- Débit. Le joueur lance un tour. L’agrégateur appelle l’endpoint de débit de l’opérateur avec un identifiant de transaction, un identifiant de tour et un montant. L’opérateur vérifie les fonds, enregistre la mise et renvoie le nouveau solde.
- Crédit. Le tour se termine. L’agrégateur appelle l’endpoint de crédit avec le montant du gain, éventuellement nul, et le même identifiant de tour.
- Rollback, si nécessaire. Si le débit a été enregistré mais que le tour a échoué, l’agrégateur envoie un rollback pour la transaction d’origine.
Cinq règles qui évitent les litiges de solde
- Idempotence sur chaque appel. Un identifiant de transaction répété doit renvoyer le résultat d’origine, jamais une seconde écriture.
- N’annuler que ce qui existe. Un rollback sur une transaction inconnue doit être acquitté sans mouvement d’argent.
- Crédits après rollback. Décidez et documentez ce qui se passe quand un crédit arrive pour un tour déjà annulé.
- Délais d’expiration. Convenez du temps d’attente de l’agrégateur et du nombre de nouvelles tentatives. Un wallet lent provoque des appels en double.
- Précision des devises. Convenez si les montants sont envoyés en unités ou en sous-unités, surtout pour les cryptos à nombreuses décimales.
Tests avant lancement
Jouez chaque scénario en sandbox : fonds insuffisants, débit en double, crédit en double, rollback après débit, rollback d’une transaction inconnue, crédit après rollback et expiration du wallet. Journalisez chaque requête et chaque réponse avec l’identifiant de transaction, pour que le support puisse retracer un tour contesté en quelques minutes.
Seamless ou transfer ?
Les transfer wallets déplacent l’argent vers une session puis le rapatrient. Ils simplifient certaines intégrations fournisseurs mais répartissent le solde entre plusieurs systèmes. Le seamless conserve une source de vérité unique, ce qui explique la préférence de la plupart des opérateurs. Hub88 est l’un des rares agrégateurs à documenter les deux.
Questions fréquentes
Qu'est-ce qu'un seamless wallet ?
Un modèle d'intégration où l'argent du joueur reste dans le système de l'opérateur. L'agrégateur ou le serveur de jeu appelle l'opérateur pour chaque vérification de solde, chaque mise et chaque gain.
Quelle différence entre seamless wallet et transfer wallet ?
Avec un transfer wallet, l'argent est transféré dans la session du fournisseur de jeux puis rapatrié à la fin. Avec un seamless wallet, il ne quitte jamais le registre de l'opérateur.
Qu'est-ce que l'idempotence dans une API de wallet ?
La garantie que traiter deux fois la même requête a le même effet que la traiter une fois. Chaque débit et crédit porte un identifiant de transaction unique, pour qu'un appel répété ne soit pas comptabilisé deux fois.
Que se passe-t-il si un débit réussit mais que le tour de jeu échoue ?
L'agrégateur envoie un rollback (parfois appelé refund ou cancel) qui fait référence à la transaction d'origine, et l'opérateur rend la mise au joueur.
Quels agrégateurs utilisent un seamless wallet ?
La plupart. SoftAggregator, SoftGamings et Hub88 l'indiquent publiquement ; Hub88 propose aussi une option TransferWallet.