Bijna elke aggregator van casinogames koppelt tegenwoordig met operators via een seamless wallet. Het model is eenvoudig te beschrijven en makkelijk net verkeerd te bouwen. Deze gids laat zien wat er tijdens een spelronde gebeurt en wat je test voordat er echt geld stroomt.
Het principe
De operator is eigenaar van de ledger. Het saldo van de speler gaat nooit naar de aggregator of de studio. In plaats daarvan vraagt de aggregator de wallet van de operator wat het saldo is, laat hij een inzet afboeken en laat hij een winst uitbetalen. De operator beantwoordt elke call met het nieuwe saldo of een foutmelding.
Eén spelronde, stap voor stap
- Launch. De operator vraagt de aggregator om een game-URL voor een bepaalde speler, valuta en game. De aggregator geeft een URL terug die de operator voor de speler laadt.
- Saldo. De game vraagt het saldo op; de aggregator roept het saldo-endpoint van de operator aan.
- Debit. De speler draait. De aggregator roept het debit-endpoint van de operator aan met een transactie-ID, ronde-ID en bedrag. De operator controleert het saldo, boekt de inzet en geeft het nieuwe saldo terug.
- Credit. De ronde is beslist. De aggregator roept het credit-endpoint aan met het winstbedrag, dat ook nul kan zijn, en dezelfde ronde-ID.
- Rollback, indien nodig. Is de debit geboekt maar de ronde mislukt, dan stuurt de aggregator een rollback voor de oorspronkelijke transactie.
Vijf regels die saldogeschillen voorkomen
- Idempotentie bij elke call. Een herhaalde transactie-ID moet het oorspronkelijke resultaat teruggeven, nooit een tweede boeking.
- Draai alleen terug wat bestaat. Een rollback voor een onbekende transactie wordt bevestigd zonder geld te verplaatsen.
- Credits na rollbacks. Bepaal en documenteer wat er gebeurt als er een credit binnenkomt voor een ronde die al is teruggedraaid.
- Timeouts. Spreek af hoe lang de aggregator wacht en hoe vaak hij het opnieuw probeert. Een trage wallet veroorzaakt dubbele calls.
- Valutaprecisie. Spreek af of bedragen in eenheden of kleinere eenheden worden verstuurd, vooral bij crypto met veel decimalen.
Tests vóór de lancering
Draai elk scenario in de sandbox: onvoldoende saldo, dubbele debit, dubbele credit, rollback na debit, rollback van een onbekende transactie, credit na rollback en een wallet-timeout. Log elk verzoek en elk antwoord met de transactie-ID, zodat support een betwiste ronde binnen minuten kan terugvinden.
Seamless of transfer?
Transfer wallets zetten geld over naar een sessie en weer terug. Ze vereenvoudigen sommige integraties met aanbieders, maar verdelen het saldo over meerdere systemen. Seamless houdt één bron van waarheid, en daarom geven de meeste operators er de voorkeur aan. Hub88 is een van de weinige aggregators die beide documenteert.
Veelgestelde vragen
Wat is een seamless wallet?
Een integratiemodel waarbij het geld van de speler in het systeem van de operator blijft. De aggregator of gameserver roept de operator aan bij elke saldocheck, inzet en winst.
Wat is het verschil tussen een seamless en een transfer wallet?
Bij een transfer wallet wordt geld naar de sessie van de gameleverancier overgeboekt en aan het eind teruggezet. Bij een seamless wallet verlaat het nooit de ledger van de operator.
Wat is idempotentie in een wallet-API?
De garantie dat hetzelfde verzoek twee keer verwerken hetzelfde effect heeft als één keer. Elke debit en credit draagt een unieke transactie-ID, zodat een herhaalde call niet twee keer wordt geboekt.
Wat gebeurt er als een debit slaagt maar de spelronde mislukt?
De aggregator stuurt een rollback (soms refund of cancel genoemd) met verwijzing naar de oorspronkelijke transactie, en de operator geeft de inzet terug aan de speler.
Welke aggregators gebruiken een seamless wallet?
De meeste. SoftAggregator, SoftGamings en Hub88 vermelden het publiek; Hub88 biedt daarnaast een TransferWallet-optie.