Lotterie-API für Ziehungen und Ergebnisse: Annahmeschluss und Abrechnung
Eine Integration für Lotterieziehungen und Ergebnis-APIs muss die Verbindung zwischen der richtigen Ziehung, dem akzeptierten Spielschein, dem autorisierten Ergebnis und der anschließenden Abrechnung erhalten. Die anspruchsvolle Arbeit liegt in Annahmeschlüssen, Zeitzonen, Ergebnisrevisionen und der Wiederherstellung bei fehlenden oder wiederholten Nachrichten, nicht in der bloßen Anzeige von Gewinnzahlen. Dies ist ein anbieterneutraler Anforderungsleitfaden, keine Spezifikation tatsächlicher […]
Eine Integration für Lotterieziehungen und Ergebnis-APIs muss die Verbindung zwischen der richtigen Ziehung, dem akzeptierten Spielschein, dem autorisierten Ergebnis und der anschließenden Abrechnung erhalten. Die anspruchsvolle Arbeit liegt in Annahmeschlüssen, Zeitzonen, Ergebnisrevisionen und der Wiederherstellung bei fehlenden oder wiederholten Nachrichten, nicht in der bloßen Anzeige von Gewinnzahlen.
Dies ist ein anbieterneutraler Anforderungsleitfaden, keine Spezifikation tatsächlicher WhiteLotto-Endpunkte und keine Zusage, dass jede beschriebene Schnittstelle enthalten ist. Beginnen Sie mit dem Leitfaden zur Lotterie-API-Architektur und vereinbaren Sie den tatsächlichen Vertrag mit dem Umsetzungsteam.
Stabile Ziehungskennungen statt ausschließlich Datumsangaben verwenden
Ein Ziehungsdatum identifiziert eine Ziehung nicht zuverlässig, wenn ein Produkt mehrere tägliche Ziehungen, Terminänderungen oder mehrere Zeitzonen hat. Ordnen Sie Produktkennung, Ziehungskennung des Anbieters und Plattformkennung einander zu. Bewahren Sie diese Referenzen auf Spielscheinen und in Berichten auf. Entscheiden Sie, ob eine verschobene Ziehung ihre Identität behält und wie eine abgesagte Ziehung akzeptierte Spielscheine betrifft.
| Datensatz | Vor der Implementierung definieren | Abnahmenachweis |
|---|---|---|
| Ziehungsplan | Stabile Kennung, Produkt, geplanter Zeitpunkt, Annahmeschluss und geltende Zeitzone. | Eine durchgehende Spur zwischen Katalog, Kauf und Reporting. |
| Spielscheinannahme | Maßgeblicher Annahmezeitpunkt, Stichtagsregel und Behandlung unklarer Antworten. | Fälle unmittelbar vor, genau an und nach der Grenze. |
| Ergebnis | Maßgebliche Quelle, Status, Veröffentlichungszeit, Version und Vollständigkeit. | Unveröffentlichte, vorläufige und endgültige Ergebnisszenarien. |
| Korrektur | Revisionsreferenz, Grund, Freigabe und Behandlung betroffener Spielscheine. | Auditspur zwischen bisherigem und korrigiertem Ergebnis. |
| Abrechnung | Auslöser, Berechnungsverantwortung, Buchungsreferenzen und Abgleich. | Ein finanzieller Effekt je vorgesehener Abrechnung. |
Zeitsemantik und Annahmeschluss vereinbaren
Speichern Sie einen eindeutigen Zeitpunkt zusammen mit der benannten lokalen Zeitzone für Kundenanzeige und Geschäftsregeln. Das Zeitstempelformat RFC 3339 ist eine hilfreiche Referenz für einen Zeitpunkt mit UTC-Versatz. Der Versatz allein beschreibt nicht die zukünftigen Sommerzeitregeln einer Region.
Legen Sie fest, ob die Annahme vom Eingang auf der Plattform, der Annahme beim Lieferanten oder einem anderen vertraglichen Ereignis abhängt. Ein Countdown im Frontend informiert; er sollte nicht entscheiden, ob ein Spielschein existiert. Testen Sie Zeitsynchronisierung, Uhrabweichungen, verspätete Anfragen und Sommerzeitwechsel. Zeigen Sie einen klaren Ausgang an, wenn der Verkauf geschlossen ist.
Ein Timeout kurz vor Annahmeschluss benötigt eine Ergebnisabfrage oder einen zugeordneten Ausnahmeprozess. Blindes Wiederholen kann ein Duplikat oder einen Spielschein für eine andere Ziehung erzeugen. Bewahren Sie die ursprüngliche Vorgangsreferenz und die Referenz der angeforderten Ziehung auf.
Ergebniskorrekturen als kontrollierte Änderungen behandeln
Unterscheiden Sie empfangene, validierte, endgültige und korrigierte Ergebnisse im vereinbarten Zustandsmodell. Ein fehlendes Feld bedeutet keinen verlorenen Spielschein. Legen Sie fest, wer die Abrechnung freigeben darf und wie die Quelle authentifiziert wird. Bewahren Sie bei einer Korrektur die frühere Version auf und verknüpfen Sie die Anpassung mit Grund und Freigebendem.
Eine wiederholte Benachrichtigung darf denselben Spielschein nicht zweimal abrechnen. Ein verspätetes älteres Ergebnis darf keine neuere autorisierte Revision überschreiben. Finanzielle Korrekturen müssen nachvollziehbar bleiben, statt den ursprünglichen Buchungsverlauf still umzuschreiben. Der Leitfaden zur Zahlungsintegration behandelt die entsprechende Disziplin für asynchrone finanzielle Ereignisse.
Fehlende Ereignisse sichtbar machen
- Ziehungen erkennen, deren erwartete Ergebnisse nicht im vereinbarten Betriebsfenster eintreffen.
- Nach einem Ausfall den Quellkatalog mit dem lokalen Ziehungsbestand vergleichen.
- Fehlende Ereignisse über unterstützte Wiederholungs- oder Abrufmechanismen wiederherstellen.
- Auf Ergebnisse wartende Spielscheine getrennt von auf Abrechnung wartenden Spielscheinen anzeigen.
- Eskalationsverantwortung und Kundenmeldungen für verspätete Ziehungen und Ergebnisse festlegen.
Die HTTP-Empfehlungen zur Idempotenz helfen bei sicheren Wiederholungen. Anwendungsgarantien für Spielscheine und Abrechnung müssen jedoch separat definiert werden. Nutzen Sie den KPI-Rahmen für Betreiber, um Abrechnungsvollständigkeit und Alter der Ausnahmen zu messen.
Abnahmecheckliste für einen Ergebnisfeed
Verwenden Sie synthetische Ziehungen und Spielscheine in einer autorisierten Testumgebung. Prüfen Sie Terminänderungen, Absagen, doppelte und ungeordnet eintreffende Nachrichten, nicht verfügbare Quellen, unvollständige Ergebnisse und die Korrektur eines endgültigen Ergebnisses. Prüfen Sie Spielscheinzustand, Spieleranzeige, Abrechnungsbuchungen und Exporte gemeinsam. Erfassen Sie Schnittstellenversion und getestete Konfiguration im UAT-Abnahmepaket.
Ergebnisveröffentlichung, Abrechnungsfreigabe und Auszahlungsfreigabe trennen
Ein Ergebnisfeed sollte nicht zu einer uneingeschränkten Anweisung für Geldbewegungen werden. Definieren Sie drei Freigabegrenzen: Was darf Spielern angezeigt werden, welche Ergebnisversion darf die Spielscheinabrechnung auslösen und was erlaubt die Freigabe einer damit verbundenen Auszahlung? Diese Entscheidungen können unterschiedlichen Systemen und Teams zugeordnet sein. Lassen Sie den Anbieter diese Grenzen anhand der tatsächlich vorgeschlagenen Konfiguration demonstrieren, statt anzunehmen, dass ein Feld „endgültig“ sämtliche Folgeaktionen autorisiert.
Stellen Sie dem Betreiber für jede Entscheidung einen prüfbaren Datensatz bereit: Quellnachweis, betroffene Ziehung, Ergebnisversion, Berechtigungsumfang und verantwortliche Person oder genehmigte automatisierte Regel. Eine Anzeigeänderung darf eine Auszahlungsentscheidung nicht stillschweigend verändern. Stimmen Sie die Grenze mit dem Leitfaden zur Spielerkontoverwaltung und dem Leitfaden zur Zahlungsintegration ab; eine Gewinnbuchung und eine abgeschlossene externe Zahlung sind unterschiedliche Datensätze.
| Entscheidungspunkt | Aufzubewahrende Nachweise | Zuständigkeitsfrage |
|---|---|---|
| Veröffentlichung für Spieler | Quellreferenz, zulässige Anzeigetexte und angezeigte Ergebnisversion. | Wer genehmigt die Veröffentlichung oder Korrektur kundenbezogener Informationen? |
| Abrechnungslauf | Genehmigtes Ergebnis, Umfang betroffener Spielscheine und Berechnungs- oder Buchungsübersicht. | Wer darf den Lauf freigeben und Ausnahmen klären? |
| Wallet-Gutschrift | Spielscheinergebnis, Gutschriftreferenz und Abgleich mit dem Abrechnungslauf. | Wer prüft einen Unterschied zwischen Spielscheinergebnis und verfügbarem Guthaben? |
| Auszahlungsfreigabe | Zahlungsreferenz, anzuwendende Prüfungen und dokumentierte Entscheidung für diese Auszahlung. | Wer genehmigt Freigabe, Prüfung oder eine zulässige Pause? |
| Streit um den Annahmeschluss | Angeforderte Ziehung, Annahmenachweis und vertragliche Grenzregel. | Wer entscheidet über die Teilnahme und teilt die Klärung mit? |
Korrekturen nach bereits erfolgten Geldbewegungen planen
Erweitern Sie Korrekturtests über einen noch nicht abgerechneten Spielschein hinaus. Beziehen Sie einen gutgeschriebenen Gewinn auf dem Konto, eine Auszahlung in Prüfung und eine außerhalb der Plattform bereits abgeschlossene Zahlung ein. Erfassen Sie betroffene Spielscheine, ursprüngliche Buchungen, Auszahlungsreferenzen und die aus der genehmigten Revision folgende Differenz. Vereinbaren Sie vor einer Anpassung, wie diese Fälle Finanzteam, Betrieb und Support erreichen.
Die Reaktion muss dem geltenden Vertrag, den Kundenbedingungen und dem autorisierten Entscheidungsverfahren folgen; dieser Leitfaden schreibt keine universelle Rückforderungsregel vor. Gehen Sie nicht davon aus, dass eine Änderung des angezeigten Ergebnisses eine externe Zahlung rückgängig macht oder ein negatives Guthaben die richtige automatische Antwort ist. Fragen Sie, wie das Team eine Entscheidung gegen eine Anpassung, eine zulässige Anpassung oder einen offenen Fall dokumentiert. Trennen Sie die im Leitfaden zu Jackpot-Risiko und Gewinnfinanzierung behandelten Finanzierungsverantwortlichkeiten von der Ergebnisfeed-Lieferung.
Fordern Sie ein ausgearbeitetes Korrekturszenario im UAT-Abnahmepaket. Verwenden Sie ausschließlich Testdatensätze und prüfen Sie die Entscheidungsnachweise des Betreibers sowie die Kundenerklärung, nicht nur den neu berechneten Gewinnbetrag.
Eine umstrittene Teilnahme mit dokumentierter Klärung abschließen
Stellen Sie für einen umstrittenen Kauf rund um den Annahmeschluss einen Fall mit ursprünglich angeforderter Ziehung, Annahmespur, Zahlungsdatensatz und geltender Regel zusammen. Eine Abbuchung allein sollte nicht als Teilnahmenachweis gelten. Benennen Sie, wer Anbieternachweise beschaffen kann und wer die Entscheidung für den Kunden genehmigt. Jede Entscheidung zu Teilnahme, Zahlungsbehandlung oder Kundenkommunikation sollte mit diesem Fall verbunden bleiben, statt zu einer undokumentierten Supportlösung zu werden.
Legen Sie fest, welche Nachweise jede Ausnahme abschließen, einschließlich offener Unterschiede zwischen Anbieter-, Spielschein- und Finanzdatensätzen. Nutzen Sie den KPI-Rahmen für Betreiber, um Fallabschluss und bloßen Nachrichteneingang zu unterscheiden, sowie die Bibliothek zur Betreiberbereitschaft zur Vorbereitung der beteiligten Teams. Besprechen Sie mit WhiteLotto Ihre Freigabegrenzen und Anforderungen an umstrittene Fälle. KONTAKT
Häufige Fragen zur Ziehungs-API
Reicht die Veröffentlichung der Gewinnzahlen?
Nein. Ein Betreiber benötigt außerdem Ziehungsidentität, maßgeblichen Ergebnisstatus, Zuordnung akzeptierter Spielscheine und nachvollziehbare Abrechnung.
Darf ein korrigiertes Ergebnis den alten Datensatz ersetzen?
Die Anzeige kann sich ändern. Der Betrieb sollte jedoch eine Auditspur und die Beziehung zwischen ursprünglicher Abrechnung und jeder autorisierten Anpassung erhalten.
Bringen Sie Ziehungsanbieter, Produkte, Annahmeschlussregeln und Reporting-Anforderungen zur Abstimmung des Plattformumfangs mit. KONTAKT.