Dieser Leitfaden ist ein Beschaffungs- und Implementierungsbriefing. Er erläutert Anforderungen vor der Wahl des Liefermodells und Nachweise vor der Abnahme. Er ist keine Dokumentation der WhiteLotto-API: Beispiele beschreiben abzustimmende Anforderungen, keine bestätigten Endpunkte, Authentifizierungsverfahren, Integrationen oder enthaltenen Funktionen. Beginnen Sie mit dem WhiteLotto-Lösungsüberblick und vereinbaren Sie den tatsächlichen Schnittstellenumfang mit dem Umsetzungsteam.
Beginnen Sie mit Systemgrenzen, nicht einer Endpunktliste
Bestimmen Sie, welches System Spielerkonto, Wallet-Buch, Losdatensatz, Ziehungsdaten, Verifizierungsentscheidung und Kundenkommunikation verantwortet. Ein separates Frontend, vorhandenes Betreiber-Backoffice und externer Zahlungsdienst bilden unterschiedliche Grenzen. Eine API kann eine Funktion bereitstellen, ohne deren operative Verantwortung zu übertragen.
Skizzieren Sie einen Transaktionsablauf mit sämtlichen Übergaben. Erfassen Sie pro Grenze aufrufendes System, maßgeblichen Datensatz, erlaubte Aktion, erwartete Antwort und Verantwortlichen für ungeklärte Zustände. Beziehen Sie Backoffice-Zugriff und Berichte ein: Eine Kaufstrecke ohne finanzielle Abstimmungsmöglichkeit ist unvollständig.
Nehmen Sie diese Übersicht in das Anbieterbewertungsbriefing auf. Klassifizieren Sie Anforderungen als verfügbar und belegt, konfigurierbar, individuell, drittanbieterabhängig oder außerhalb des Umfangs. Eine Roadmap-Funktion ist keine verbindlich zugesagte Schnittstelle.
API, iFrame oder vollständiges Frontend: die Verantwortungsgrenze wählen
Eine API-Integration, ein eingebetteter iFrame und ein vom Anbieter geliefertes Frontend stellen unterschiedliche Teile des Spielerablaufs unter Ihre Kontrolle. Wählen Sie nach dem Erlebnis, das Sie selbst gestalten möchten, den vorhandenen Systemen und dem Team für die laufende Anbindung. Diese Entscheidung ist von der kommerziellen Bezeichnung „White Label“ oder „Turnkey“ getrennt: Vereinbaren Sie den tatsächlichen Umfang der Schnittstelle und ihres Betriebs.
Nutzen Sie die Übersicht der Plattformmodule, um festzulegen, was in Ihrem bestehenden System verbleibt. Vergleichen Sie die Bereitstellungsmodelle anhand desselben Kaufablaufs statt anhand einer abgeschlossenen Demo.
| Bereitstellung | Spieleroberfläche | Zu vereinbarende Verantwortung | Abnahmeschwerpunkt |
|---|---|---|---|
| API mit eigenem Frontend | Ihr Team entwickelt den Lotterieablauf auf Basis der vereinbarten Schnittstellen. | UI-Versionen, Adapterpflege, Kontozuordnung und betrieblicher Support. | Schnittstellenverhalten und Kundenablauf müssen zusammen funktionieren. |
| Eingebetteter iFrame | Eine gelieferte Lotterieoberfläche wird in Ihre vorhandene Website eingebunden. | Sitzungsübergabe, umgebende Navigation, Kommunikation zwischen Oberflächen und Störungszuständigkeit. | Einstieg, Kauf, Wiederaufnahme und Rückkehr zur Hauptwebsite. |
| Vollständig geliefertes Frontend | Der vereinbarte Website-Ablauf wird mit dem Plattformumfang geliefert. | Marke, Inhaltsänderungen, Konten, Wallet-Grenzen, Versionen und Exporte. | Der gesamte vereinbarte Ablauf einschließlich Verwaltung und Berichten. |
Konto-, Wallet- und Sitzungsgrenzen vor der Designfreigabe klären
Legen Sie für ein bestehendes Casino oder einen Sportwettenanbieter fest, ob der Lotteriespieler sein vorhandenes Konto, ein verknüpftes Konto oder eine separate Registrierung nutzt. Benennen Sie das System, das Einschränkungen durchsetzt, und das Verhalten bei geänderter Verifizierung oder Berechtigung während einer aktiven Sitzung. Fragen Sie nach der Rückkehr nach Abmeldung, Gerätewechsel oder dem Aufruf eines abgelaufenen Links. Eine ansprechende eingebettete Oberfläche beantwortet diese Betriebsfragen nicht.
Trennen Sie den angezeigten Kontostand vom führenden Finanzdatensatz. Vereinbaren Sie, welches System einen Kauf autorisiert und wie die Hauptoberfläche Änderungen an Guthaben, Losstatus oder Berechtigungen erhält. Der Leitfaden zu Wallet und Abstimmung behandelt die Finanzgrenze; das Bereitstellungsmodell muss erklären, wie sie für den Spieler sichtbar wird.
Weisen Sie jeden sichtbaren Fehler einem Verantwortlichen zu. Unterscheiden Sie ein Sitzungsproblem der Hauptwebsite, eine nicht verfügbare eingebettete Oberfläche, eine abgelehnte Lotterieaktion und eine ungeklärte Transaktion. Definieren Sie Meldung, erlaubten nächsten Schritt und Supportreferenz. Beim erneuten Öffnen soll der Spieler einen vereinbarten Zustand erreichen; bleibt das Ergebnis unklar, muss ein Untersuchungsweg bestehen.
Das Integrationsmodell gemeinsam mit den Transaktionen abnehmen
Ergänzen Sie die UAT- und Go-Live-Abnahmecheckliste um modellspezifische Prüfungen. Testen Sie den Einstieg über die Hauptwebsite, Sitzungsablauf während der Zahlenauswahl, geänderte Kontoeinschränkungen, eine nicht verfügbare Komponente und die Rückkehr von der Zahlung. Beziehen Sie mobile Navigation, Tastaturbedienung und den Weg zurück zur Loshistorie ein.
Dokumentieren Sie für jedes Szenario das verantwortliche System, die erwartete Anzeige, den führenden Konto- oder Transaktionszustand und die zuständige Person. Berücksichtigen Sie die Supportübergabe zwischen Teams. Ein Bereitstellungsmodell ist bereit, wenn diese Verantwortlichkeiten gemeinsam abgenommen sind, nicht allein, wenn eine Oberfläche lädt oder eine Schnittstelle antwortet.
KONTAKT für die Abstimmung Ihres vorhandenen Frontends, Ihrer Konto- und Wallet-Systeme und des gewünschten Lotterieablaufs.
Erstellen Sie ein beantwortbares Anforderungsregister
Nutzen Sie eine Zeile je Schnittstelle oder Geschäftsvorgang statt einer einzigen „API-Integration“. Ergänzen Sie Verantwortlichen, Priorität, Abhängigkeit, Nachweisreferenz und Abnahmeentscheidung zu folgenden Fragen.
| Bereich | Zu definierende Anforderung | Anzufordernder Nachweis |
|---|---|---|
| Schnittstellenvertrag | Operationen, Felder, Kennungen, Fehler, Version und unterstützte Umgebung. | Versionierte Spezifikation und repräsentative synthetische Anfrage-/Antwortbeispiele. |
| Zugriffsgrenze | Erlaubte Clients, Rollen, Marken und Ressourcen; Ausgabe, Rotation und Entzug. | Zugriffsmatrix und Tests verweigerter Aktionen im vereinbarten Deployment. |
| Geld und Lose | Maßgebliche Datensätze, Zustandswechsel, Verkaufsschluss und Dubletten. | Transaktionsspur mit Los-, Wallet- und Anbieterreferenzen. |
| Asynchrone Ereignisse | Authentifizierung, Dubletten, Reihenfolge, Wiederholungen und Lückenbehebung. | Dokumentierter Ereignisvertrag und Fehlerfallnachweise. |
| Kapazität und Grenzen | Lastspitzen, Parallelität, Timeouts, Anfragelimits und Überlastreaktion. | Vereinbarte Lastannahmen und Tests des festgelegten Umfangs. |
| Daten und Berichte | Pflichtfelder, Aufbewahrung, Exportrechte, Zeitstempel und Abstimmungsansichten. | Datenwörterbuch und nutzbarer Beispielexport ohne personenbezogene Datensätze. |
| Änderung und Support | Kompatibilität, Abkündigungsfrist, Incident-Verantwortung und Ausstieg. | Release-Prozess, Eskalationsweg und Vertragsumfang. |
Die OpenAPI-Spezifikation standardisiert die Beschreibung von HTTP-Schnittstellen. Fragen Sie nach aktueller Beschreibung, verwendeter Version und separat zu dokumentierendem Verhalten. Ein maschinenlesbarer Vertrag erleichtert die Prüfung; er beweist weder Transaktionskorrektheit noch Sicherheit oder operativen Support.
Vereinbaren Sie Datenmodell und führendes System
Ordnen Sie Kennungen zwischen Betreiber, Plattform und externem Dienst zu. Unterscheiden Sie Anfragekennung, Loskennung, Zahlungsreferenz und Buchung. Definieren Sie deren Verknüpfung für den Support ohne personenbezogene Angaben in URLs oder unbeschränkt zugänglichen Logs.
Spezifizieren Sie Beträge, Währungen, Genauigkeit, Zeitzonen, Zeitstempelbedeutung und Statusdefinitionen. „Angenommen“ kann den Eingang zur Verarbeitung statt ein bestätigtes Los bedeuten. „Bezahlt“ kann ein Prozessorereignis statt endgültiger Abrechnung sein. Dokumentieren Sie Änderungsberechtigte und Korrekturaufzeichnungen.
Bei Ziehungen und Ergebnissen definieren Sie maßgebliche Quelle, Aktualität, Korrekturregeln und Verantwortlichen für betroffene Lose. Legen Sie Zeitzone des Verkaufsschlusses und Grenzfallregel fest; der Frontend-Countdown entscheidet nicht über die Annahme.
Fordern Sie nur notwendige Spielerdaten. Stimmen Sie Zugriff, Aufbewahrung, Export und zulässige Nutzung mit den Verantwortlichen ab. Der Leitfaden zu Spielerdatenrechten trennt operativen Zugriff von Vertrag und Datenschutz. Technische Verbindung begründet kein Übertragungs- oder Wiederverwendungsrecht.
Planen Sie ungewisse Ergebnisse und wiederholte Nachrichten
Betrachten Sie einen synthetischen Kauf: Der Empfänger akzeptiert die Anfrage, aber die Verbindung endet vor der Bestätigung beim Aufrufer. Ein Timeout beweist nicht, dass nichts geschehen ist. Die Spezifikation braucht einen unterstützten Weg zur Klärung des ursprünglichen Ergebnisses und zum Ausschluss einer zweiten finanziellen Wirkung.
Die HTTP-Semantik in RFC 9110 unterscheidet idempotente Vorgänge und warnt vor automatischer Wiederholung nicht idempotenter Anfragen ohne Sicherheitswissen. Für Käufe und Wallet-Änderungen vereinbaren Sie Dublettenregeln der Anwendung, Schutzdauer und Verhalten bei gleicher Referenz mit anderem Inhalt. Die HTTP-Methode allein gibt keine solche Garantie.
Fragen Sie bei Ereignissen oder Callbacks nach Herkunftsprüfung, Dublettenerkennung, verspäteter oder ungeordneter Zustellung und Wiederherstellung versäumter Verarbeitung. Die Stripe-Webhook-Dokumentation beschreibt anbieterbezogen Signaturen, Wiederholungen und asynchrone Verarbeitung. Das sind Vertragsfragen, kein Nachweis einer WhiteLotto-Stripe-Integration oder desselben Ereignismodells.
Die Abnahme verbindet Geschäftsergebnis und Datensätze: einen beabsichtigten Kauf, vereinbarte Wallet-Wirkung, nachvollziehbaren Losstatus und zugeordneten Ausnahmefall bei ungeklärter Bestätigung. Wenden Sie dies auch auf Erstattungen, Rückbuchungen und Abrechnung an. Der Leitfaden zum Zahlungsstack trennt erfolgreiche Zahlungsantwort und nutzbare Abstimmung.
Sicherheit und Kapazität gehören zur Abnahme
Bestätigen Sie Authentifizierung, Berechtigungen, Zugangsdatenverantwortlichen, Speicherung, Rotation und Entzug. Produktionszugänge gehören nie in Beschaffungsbriefing, gemeinsame Beispiele oder Browsercode. Trennen Sie Umgebungen und nutzen Sie synthetische Demodaten.
Prüfen Sie Autorisierung für Vorgang und Ressource, nicht nur gültige Anmeldung. Verlangen Sie Tests unerlaubter Rollen, fremder Marken-/Kontogrenzen und gesperrter Clients. Die OWASP API Security Top 10 behandelt Objektzugriff, Authentifizierung, Ressourcenverbrauch und Inventarrisiken. Sie ist weder Zertifizierung noch Nachweis bestandener Plattformkontrollen.
Beschreiben Sie Regelverkehr, Ziehungsspitze, parallele Käufe, Berichtsjobs und Nachverarbeitung. Vereinbaren Sie Limitreaktion und sicher aufschiebbare Anfragen. Dokumentieren Sie Messgrenzen für Latenz und Verfügbarkeit samt Abhängigkeiten statt unbelegter Ziele. Nutzen Sie die Sicherheits-, Verfügbarkeits- und SLA-Checkliste für weitere Nachweise und Eskalation.
Ein kleines, vollständiges Abnahmepaket
Erfassen Sie Version, Konfiguration, Testumgebung, synthetische Fälle, Sollresultat und tatsächlichen Nachweis. Nennen Sie Aufrufer, Empfänger und Betriebsverantwortlichen. Ein Bildschirmvideo allein beweist nicht den resultierenden Buchungs- oder Loszustand.
- Verfolgen Sie einen Erfolgsablauf bis Bestätigung und Bericht.
- Prüfen Sie Ablehnung, ungültige Anfrage, Verkaufsschluss und ungeklärte Antwort.
- Wiederholen Sie erlaubte Testanfrage und Ereignis gemäß Dublettenregeln.
- Testen Sie verweigerten, abgelaufenen oder entzogenen Zugang, fehlerhafte Eingaben und Limits.
- Unterbrechen Sie eine Abhängigkeit und zeigen Sie Wiederherstellung oder verantwortete Ausnahmequeue.
- Prüfen Sie Untersuchung durch Support und Finanzen mit erlaubten Datensätzen.
Trennen Sie blockierende Fehler von optionalen Verbesserungen. Die Plattform-Demo-Checkliste strukturiert Nachweise, ersetzt aber keine Abnahme der beauftragten Integration.
Ungelöste API-Vorgänge statt nur erfolgreicher Antworten testen
Fordern Sie eine isolierte Demonstration mit synthetischen Datensätzen: eine Scheinanfrage senden, ihre Bestätigung unterbrechen und mit demselben Vorgangsschlüssel wiederholen. Der Nachweis sollte Anfrage, Scheinstatus und Finanzbuchung verbinden, ohne eine echte Zahlung durchzuführen.
- Legen Sie fest, welches System das endgültige Ergebnis verwaltet und wie es bei fehlender erster Antwort abgerufen wird.
- Definieren Sie ausstehende, angenommene, abgelehnte und stornierte Zustände; eine Zeitüberschreitung bedeutet nicht automatisch einen gescheiterten Kauf.
- Wiederholen Sie Anfrage und Ereignisnachricht, um doppelte Scheine oder Finanzbuchungen auszuschließen.
- Listen Sie ungelöste Vorgänge im Abstimmungsexport mit Referenzen, Zeitstempeln und zugewiesenem Bearbeitungsverantwortlichen auf.
Nehmen Sie Wiederherstellungszeit und Eskalationsverantwortung in die Serviceanforderungen auf. Übertragen Sie dieselben Szenarien in die RFP-Abnahmematrix, statt eine Liste von API-Schnittstellen als Nachweis funktionierender Wiederherstellung anzusehen.
Zuerst die Architektur wählen, dann Integrationen priorisieren
Behalten Sie diesen Leitfaden als übergeordnete Anforderungsübersicht. Beginnen Sie nicht mit allen verfügbaren Anbietern gleichzeitig: Wählen Sie führende Systeme und den kleinsten vollständigen Ablauf für die vereinbarte Version. Erfassen Sie pro Schnittstelle fachliche Abhängigkeit, Datenverantwortlichen, Adapterverantwortlichen, erforderlichen Drittanbieterzugriff und Abnahmenachweise.
| Arbeitsbereich | Entscheidung vor dem Aufbau | Detaillierter Leitfaden |
|---|---|---|
| Ziehungen und Ergebnisse | Maßgebliche Ziehungsidentität, Annahmeschluss, Ergebnisrevisionen und Abrechnungsverantwortung. | Ziehungs- und Ergebnisintegration |
| Zahlungen | Wallet-Gutschriftregel, sichere Wiederholung, verifizierte Ereignisse und Finanzabgleich. | Zahlungsgateway-Integration |
| KYC | Zuordnung von Entscheidungszuständen, Kontoberechtigungen, manuelle Bearbeitung und benötigte Daten. | KYC-Integrationsanforderungen |
| Verkaufsstellen | Gültige Spielscheinannahme, Offline-Regeln, Gerätewiederherstellung und Verkaufsstellenabrechnung. | Stationäre POS-Integration |
| Spielerkonten (PAM) | Identitätsverantwortung, Kontozustände, Beschränkungen, Sitzungszugriff und Ereigniswiederherstellung. | Integration der Spielerkontoverwaltung |
| Abonnements und Mehrfachziehungen | Verlängerung oder Vorauszahlung, Zahlungswiederholungen, Annahmeschluss und Loszuordnung. | Anforderungen für Abonnements und Mehrfachziehungen |
| Sofortlotterien und digitale Rubbellose | Verbindliche Rundenannahme, Ergebnisverantwortung, Buchungen und Wiederherstellung unterbrochener Spiele. | Checkliste zur Sofortlotterie-Integration |
| Jackpot-Risiko und Gewinnfinanzierung | Gewinnverpflichtungen, Finanzierungsquelle, Expositionsgrenzen und Abrechnungsnachweise. | Gewinnfinanzierung und Risikoprüfung |
Abhängigkeiten um eine wiederherstellbare Transaktion ordnen
Stimmen Sie bei einem Kauf Konto- und Kontrollgrenze, Aufladungs- oder Wallet-Regeln, akzeptierten Spielscheindatensatz, Ziehungs- und Ergebnisverarbeitung sowie Finanzexport gemeinsam ab. Bauen und testen Sie einen vollständigen synthetischen Ablauf, bevor Sie Anbieter vervielfachen. Eine unverbundene Reihe erfolgreicher API-Aufrufe kann den Support dennoch daran hindern, einen unklaren Kauf aufzulösen.
Trennen Sie „für die Veröffentlichung erforderlich“ von „spätere kommerzielle Erweiterung“. Zum Integrationsumfang gehören Monitoring, Sandboxzugriff, Ereigniswiederherstellung, Dokumentation und Partnerkoordination, nicht nur Adaptercode. Ein Anbieter ohne Betriebsmodellfreigabe oder brauchbare Testumgebung bleibt eine Abhängigkeit, selbst wenn die interne Entwicklung fertig ist.
Änderungsverantwortung in den Vertrag aufnehmen
Führen Sie ein versioniertes Schnittstelleninventar mit Verantwortlichen und Abkündigungsregeln. Vereinbaren Sie Ankündigung und Abnahme von Änderungen an Feldern, Signaturen, Statusbedeutungen und Reporting. Bewahren Sie den bisherigen Versionspfad, soweit sicher, beachten Sie aber, dass ein Adapter-Rollback bereits geschriebene Finanzdatensätze nicht zurücknimmt.
Die OpenAPI-Spezifikation beschreibt HTTP-Verträge. Geschäftliche Zustandswechsel, Wiederherstellungsverfahren und Verantwortungsgrenzen benötigen daneben ausdrückliche Dokumentation. Überführen Sie die vereinbarten Anforderungen in die UAT-Abnahmematrix und bestätigen Sie mit dem KPI-Rahmen, dass die veröffentlichte Integration beobachtbar bleibt.
Budgetieren Sie Verantwortung nach dem ersten Release
Benennen Sie Eigentümer von Adaptern, Monitoringregeln und Incident-Wegen. Vereinbaren Sie Kompatibilitätsprüfungen, Änderungsvorwarnung, sichere Updates und Zahlung außerhalb des Umfangs. Berücksichtigen Sie Partnerkoordination, Berichte, Tests und spätere Migration statt nur Erstverbindung.
Nehmen Sie das Register zum Integrationsgespräch mit WhiteLotto mit. Bringen Sie Systemgrenzen, Operationen, Lastannahmen, Sequenz und Abhängigkeiten. Fragen Sie nach heute belegbaren und noch zu analysierenden Anforderungen. Senden Sie keine Spielerexporte, Geheimnisse oder privaten Produktionslogs.
FAQ zur Lotterie-API-Integration
Dokumentiert dieser Leitfaden die WhiteLotto-API?
Nein. Er beschreibt Anforderungen und Abnahme. Beschaffen Sie aktuelle vereinbarte Spezifikation und Umsetzungsscope vor der Entwicklung.
Entfällt durch API die Abstimmung?
Nein. Schnittstellen transportieren Informationen; Abstimmung klärt zusammengehörige Datensätze und Differenzverantwortung. Definieren Sie sie für Wallet, Lose, Zahlungen und Abrechnung.
Reicht eine Anbieterliste zur Aufwandsschätzung?
Sie ist ein Anfang. Verlässliche Schätzung braucht Vorgänge, Verträge, Umgebungen, Mapping, Fehlerverhalten, Last und Abnahmeverantwortung.
Können wir unsere bestehenden Wallet-, Zahlungs-, KYC- und CRM-Systeme behalten?
Ob ein bestehendes System weiterverwendet werden kann, muss anhand des vereinbarten Umfangs und seiner aktuellen, dokumentierten Schnittstellen bewertet werden; die Bezeichnung „API-Integration“ garantiert dies nicht. Bestimmen Sie die führenden Systeme für Konten, Salden, Verifizierungsentscheidungen und Kundennachrichten und ordnen Sie anschließend Kennungen und Geschäftsstatus zwischen den Systemen zu. Vereinbaren Sie zulässige Aktionen, die Behandlung von Ausnahmen, Abnahmenachweise und eine verantwortliche Person für jede Verbindung. Nehmen Sie diese Anforderungen in die Bewertungscheckliste für die Ausschreibung auf, bevor Sie entscheiden, welche Komponenten bleiben, welche Adapter benötigen und welche eine andere Aufteilung der betrieblichen Verantwortung erfordern.
Wie sollten Wiederholungsversuche und doppelte Rückmeldungen behandelt werden?
Legen Sie im Schnittstellenvertrag das erforderliche Wiederholungsverhalten fest: eine stabile Geschäftsreferenz und einen ausdrücklichen Geltungsbereich der Idempotenz mit vereinbarter Schutzdauer. Eingehende Rückmeldungen erfordern eine Herkunftsprüfung und eine dauerhafte Duplikaterkennung, damit ihre erneute Zustellung kein weiteres Los und keine weitere Finanzbuchung erzeugt. Ist eine Antwort unklar, verlangen Sie eine Statusabfrage oder einen Abgleich, bevor die Operation blind wiederholt wird. Abnahmetests sollten doppelte oder ungeordnet eintreffende Rückmeldungen, unterbrochene Antworten und wiederholte Anfragen mit verändertem Inhalt abdecken. Der Leitfaden zur Integration von Zahlungsgateways bietet eine gezielte Anforderungsliste; er dokumentiert keine WhiteLotto-Endpunkte.
Wojciech Lysak ist der Geschäftsführer von WhiteLotto.com. LinkedIn