Fast jeder Aggregator für Casinospiele bindet Betreiber heute über ein Seamless Wallet an. Das Modell ist einfach zu beschreiben und leicht in Details falsch umzusetzen. Dieser Ratgeber zeigt, was während einer Spielrunde passiert und was vor dem ersten Echtgeld getestet werden sollte.
Das Prinzip
Der Betreiber besitzt das Ledger. Der Saldo des Spielers wandert nie zum Aggregator oder zum Studio. Stattdessen fragt der Aggregator das Wallet des Betreibers nach dem Saldo, weist es an, einen Einsatz abzubuchen, und weist es an, einen Gewinn gutzuschreiben. Der Betreiber beantwortet jeden Aufruf mit dem neuen Saldo oder einem Fehler.
Eine Spielrunde Schritt für Schritt
- Launch. Der Betreiber fordert beim Aggregator eine Spiel-URL für einen bestimmten Spieler, eine Währung und ein Spiel an. Der Aggregator liefert eine URL, die der Betreiber für den Spieler lädt.
- Saldo. Das Spiel fragt den Saldo ab; der Aggregator ruft den Saldo-Endpunkt des Betreibers auf.
- Debit. Der Spieler dreht. Der Aggregator ruft den Debit-Endpunkt des Betreibers mit Transaktions-ID, Runden-ID und Betrag auf. Der Betreiber prüft die Deckung, bucht den Einsatz und gibt den neuen Saldo zurück.
- Credit. Die Runde ist entschieden. Der Aggregator ruft den Credit-Endpunkt mit dem Gewinnbetrag auf, der auch null sein kann, und derselben Runden-ID.
- Rollback, falls nötig. Wurde das Debit gebucht, die Runde aber ist gescheitert, schickt der Aggregator ein Rollback für die ursprüngliche Transaktion.
Fünf Regeln gegen Streit um Salden
- Idempotenz bei jedem Aufruf. Eine wiederholte Transaktions-ID muss das ursprüngliche Ergebnis liefern, nie eine zweite Buchung.
- Nur zurückbuchen, was existiert. Ein Rollback für eine unbekannte Transaktion sollte bestätigt werden, ohne Geld zu bewegen.
- Credits nach Rollbacks. Festlegen und dokumentieren, was geschieht, wenn ein Credit für eine bereits zurückgebuchte Runde eintrifft.
- Timeouts. Vereinbaren, wie lange der Aggregator wartet und wie oft er es erneut versucht. Ein langsames Wallet erzeugt doppelte Aufrufe.
- Währungspräzision. Vereinbaren, ob Beträge in Einheiten oder Untereinheiten übertragen werden, vor allem bei Krypto mit vielen Nachkommastellen.
Tests vor dem Start
Jedes Szenario in der Sandbox durchspielen: unzureichendes Guthaben, doppeltes Debit, doppeltes Credit, Rollback nach Debit, Rollback einer unbekannten Transaktion, Credit nach Rollback und ein Wallet-Timeout. Jede Anfrage und Antwort mit Transaktions-ID protokollieren, damit der Support eine strittige Runde in Minuten nachverfolgen kann.
Seamless oder Transfer?
Transfer Wallets verschieben Geld in eine Session und zurück. Sie vereinfachen manche Anbieter-Integrationen, verteilen den Saldo aber auf mehrere Systeme. Seamless hält eine einzige maßgebliche Quelle, weshalb die meisten Betreiber es bevorzugen. Hub88 ist einer der wenigen Aggregatoren, die beide Modelle dokumentieren.
Häufige Fragen
Was ist ein Seamless Wallet?
Ein Integrationsmodell, bei dem das Geld des Spielers im System des Betreibers bleibt. Aggregator oder Spielserver rufen den Betreiber bei jeder Saldoabfrage, jedem Einsatz und jedem Gewinn auf.
Was unterscheidet Seamless und Transfer Wallet?
Beim Transfer Wallet wird Geld in die Session des Spieleanbieters verschoben und am Ende zurückgebucht. Beim Seamless Wallet verlässt es das Ledger des Betreibers nie.
Was bedeutet Idempotenz bei einer Wallet-API?
Die Garantie, dass die zweimalige Verarbeitung derselben Anfrage dieselbe Wirkung hat wie die einmalige. Jedes Debit und Credit trägt eine eindeutige Transaktions-ID, damit ein wiederholter Aufruf nicht doppelt gebucht wird.
Was passiert, wenn ein Debit gelingt, die Spielrunde aber scheitert?
Der Aggregator schickt ein Rollback (manchmal Refund oder Cancel genannt) mit Verweis auf die ursprüngliche Transaktion, und der Betreiber erstattet dem Spieler den Einsatz.
Welche Aggregatoren nutzen ein Seamless Wallet?
Die meisten. SoftAggregator, SoftGamings und Hub88 nennen es öffentlich; Hub88 bietet zusätzlich eine TransferWallet-Option.