Lotterie-Zahlungsgateway: Webhooks, Wiederholungen und Erstattungen
Eine Lotterie-Zahlungsgateway-Integration ist bereit, wenn Zahlungen, Wallet-Buchungen und Abrechnungsberichte übereinstimmen – auch nach Wiederholungen, Timeouts, Erstattungen und verspäteten Benachrichtigungen. Eine erfolgreiche Checkout-Anzeige beweist nicht ausreichend, dass der Betreiber Geld erhalten oder das richtige Konto genau einmal gutgeschrieben hat. Dieser Leitfaden beschreibt Integrationsanforderungen, keine tatsächlichen WhiteLotto-API-Felder und keine Zusage zur Unterstützung eines genannten Zahlungsdienstleisters. Anbieterzulässigkeit, akzeptierte […]
Eine Lotterie-Zahlungsgateway-Integration ist bereit, wenn Zahlungen, Wallet-Buchungen und Abrechnungsberichte übereinstimmen – auch nach Wiederholungen, Timeouts, Erstattungen und verspäteten Benachrichtigungen. Eine erfolgreiche Checkout-Anzeige beweist nicht ausreichend, dass der Betreiber Geld erhalten oder das richtige Konto genau einmal gutgeschrieben hat.
Dieser Leitfaden beschreibt Integrationsanforderungen, keine tatsächlichen WhiteLotto-API-Felder und keine Zusage zur Unterstützung eines genannten Zahlungsdienstleisters. Anbieterzulässigkeit, akzeptierte Produkte und Konditionen sind separat zu bestätigen. Lesen Sie den Leitfaden zur Lotterie-Zahlungsarchitektur für den gesamten Betriebs- und Kostenkontext.
Dienstleister-, Wallet- und Finanzdatensätze trennen
Vereinbaren Sie, welches System Zahlungsversuch, endgültiges Anbieterergebnis, Spieler-Wallet-Buchung, Auszahlungsanweisung und buchhalterischen Abgleich verantwortet. Verknüpfen Sie Kennungen, ohne sie als austauschbar zu behandeln. Definieren Sie Beträge, Währung, Rundung und Gebühren an jeder Grenze.
| Situation | Erforderliches Verhalten | Aufzubewahrende Nachweise |
|---|---|---|
| Erstellt oder offen | Einen gestarteten Vorgang nicht mit abgeschlossener Guthabenaufladung verwechseln. | Vorgangskennung, Anbieterreferenz und aktueller Status. |
| Autorisiert oder eingezogen | Die vereinbarte Wallet-Gutschriftregel für die tatsächliche Zahlungsmethode anwenden. | Verifiziertes Anbieterereignis und zugehörige Buchung. |
| Unklare Antwort | Den ursprünglichen Ausgang ermitteln, bevor ein neuer Vorgang angelegt wird. | Wiederholungs- und Abfragehistorie sowie endgültige Lösung. |
| Erstattung oder Rückbuchung | Die Anpassung mit der ursprünglichen Zahlung verbinden und Doppeleffekte vermeiden. | Anpassungsreferenz, Betrag, Grund und Freigabe. |
| Streitfall oder Abrechnungslücke | Eine zugeordnete Ausnahme mit Finanzbearbeitung anlegen. | Anbieterbericht, interner Datensatz und Lösungsspur. |
Webhooks für Wiederholungen und Verzögerungen entwerfen
Verifizieren Sie den Ereignisursprung mit dem dokumentierten Mechanismus des Anbieters, bevor Sie dem Inhalt vertrauen. Prüfen Sie referenziertes Konto, Zahlung, Betrag und Währung. Speichern Sie das akzeptierte Ereignis oder den Vorgang dauerhaft, bevor Sie dem Sender die erfolgreiche Zustellung bestätigen. Längere Verarbeitung benötigt einen wiederherstellbaren Ablauf.
Gehen Sie nicht davon aus, dass Ereignisse einmalig oder in Reihenfolge eintreffen. Stripe dokumentiert Signaturprüfung, doppelte Ereignisse und nicht garantierte Reihenfolge. Adyen dokumentiert eigene Regeln für Bestätigung und Duplikatbehandlung. Das sind anbieterspezifische Referenzen, keine Nachweise einer WhiteLotto-Integration mit einem der Unternehmen.
Wählen Sie Deduplizierungsschlüssel und Zustandsübergänge aus dem tatsächlichen Anbietervertrag. Eine neue Zustellkennung kann dasselbe Geschäftsereignis repräsentieren. Ein verspätetes Ereignis darf einen bereits geklärten Vorgang nicht zurückstufen. Fehler müssen in einer Ausnahmewarteschlange sichtbar bleiben; Wiederholung erfolgt kontrolliert.
Sichere Wiederholungen und unklare Ausgänge definieren
Angenommen, der Anbieter führt eine Guthabenaufladung aus, die Antwort erreicht die Plattform jedoch nie. Eine neue Zahlung kann den Spieler erneut belasten. Verwenden Sie die unterstützte Vorgangsreferenz oder den Idempotenzmechanismus erneut und rufen Sie den ursprünglichen Ausgang ab.
Die Idempotenzdokumentation von Stripe zeigt das Wiederholungsverhalten eines Anbieters. Übertragen Sie dessen Aufbewahrungsfenster oder Fehlersemantik nicht auf einen anderen. Ihr Vertrag benötigt Schutzdauer, Verhalten bei widersprüchlichen Nutzdaten und einen Wiederherstellungspfad nach Ablauf der Schutzdauer.
Testen Sie Gleichzeitigkeit ebenso wie Wiederholung: Zwei Worker können dasselbe Ereignis gleichzeitig erhalten. Eine Wiederholungssperre, die nur innerhalb einer Browsersitzung funktioniert, schützt kein gemeinsam genutztes Wallet-Buchungsregister.
Bruttobewegungen und Differenzen abstimmen
Ordnen Sie Anbietervorgänge den Wallet-Buchungen und Anbieterabrechnungen zu. Erklären Sie Gebühren, Teilerstattungen, strittige Beträge, Wechselkursdifferenzen und Zeitunterschiede separat. Einzahlungen sind keine Spielscheinverkäufe; eine erfolgreiche Aufladung beweist nicht, dass ein späterer Spielscheinkauf akzeptiert wurde.
Finance muss einen nicht zugeordneten Betrag anhand zulässiger Referenzen, Zeitstempel und Statushistorie untersuchen können. Nutzen Sie den KPI-Rahmen, um ungelöste Werte und ihr Alter auszuweisen, ohne gegensätzliche Differenzen durch Saldierung zu verbergen.
Abnahmecheckliste für Zahlungen
- Erfolgreiche, abgelehnte, abgebrochene und offene Aufladungsabläufe testen.
- Die erste Antwort verlieren, dann den ursprünglichen Vorgang abrufen oder sicher wiederholen.
- Doppelte, gleichzeitige, verspätete und ungeordnet eintreffende Testereignisse senden.
- Ungültige Signaturen, falsche Währungen und fremde Kontoreferenzen ablehnen.
- Vollständige und teilweise Erstattungen, Auszahlungsfehler und Abgleichlücken testen.
- Bestätigen, dass keine Geheimnisse im Browsercode oder unbeschränkten Logs stehen.
Führen Sie diese Fälle in autorisierten Anbietersandboxes mit synthetischen Daten aus. Die OWASP-Empfehlungen für Zahlungstests helfen bei Geschäftslogik- und Timing-Prüfungen. Dokumentieren Sie die tatsächlichen finanziellen Effekte im UAT-Abnahmepaket; diese Checkliste autorisiert keine Live-Zahlungen.
Häufige Fragen zur Zahlungsintegration
Sollte eine Browserweiterleitung die Wallet gutschreiben?
Die Gutschriftentscheidung benötigt maßgebliche serverseitige Nachweise nach dem vereinbarten Vertrag. Eine Erfolgsseite im Browser allein liefert diese nicht.
Garantiert eine Gateway-Integration die Zulassung eines Lotterieunternehmens?
Nein. Zulässigkeit, Markt- und Produktfreigabe sowie kommerzielles Onboarding sind separate Entscheidungen des Anbieters und der zuständigen Verantwortlichen.
Besprechen Sie Zahlungsmethoden, Märkte und Abrechnungsanforderungen mit WhiteLotto. Beginnen Sie mit der Integrationsarchitektur. KONTAKT.