Daten der Spielsitzung
Spieler, Marke, Spiel, Währung, Land, Sprache, Modus, Jurisdiktion und Ablauf des Zugriffs.
Dokumentation / Gaming-Ablauf
Gaming-API-Ablauf
Der vollständige Weg von Spielerprüfung und Spielstart über Einsätze, Gewinne, Spielrunden und Stornierungen bis zur finanziellen Abstimmung.
Sitzung
Spieler und Spielstart
Guthaben
Einsätze und Gewinne
Runden
Ablauf der Spielsitzung
Stornierung
Wiederherstellung von Operationen
Lebenszyklus des Spiels
Vom Start bis zum Abschluss der Runde
01
Spielsitzung erstellen
Spieler, Spiel, Währung, Sprache, Land, Modus und Rückgabe-URL.
02
Spiel starten
Temporärer Zugangsschlüssel, Launch-URL und Prüfung der Spielverfügbarkeit.
03
Finanzoperationen verarbeiten
Guthabenprüfung, Einsatz, Gewinn, kombinierte Operation und Plattformantworten.
04
Runde schließen und abstimmen
Endergebnis, Stornierungen, Finanz-Ledger und Provider-Bericht.
Übersicht
Die Gaming-API verbindet Spieler, Runde und Geldbewegung
Spielstart und Geldbewegung sind unterschiedliche Teile eines Prozesses. Die Sitzung identifiziert Spieler und Startbedingungen, die Runde verknüpft Provider-Aktionen, und die Plattform-API bestätigt jede Belastung, Gutschrift und Stornierung.
Guthabenkontrolle
Die Plattform prüft verfügbare Mittel und wendet jeden Einsatz, jede Auszahlung oder Stornierung nur einmal an.
Finanz-Ledger des Spiels
Operations- und Rundenkennungen, Operationstyp, Betrag sowie Guthaben vorher und nachher werden für Kontrolle und Abstimmung gespeichert.
Spielstart
Typischer Ablauf beim Spielstart
Die Plattform prüft zunächst Spieler und Spielverfügbarkeit, erstellt dann eine zeitlich begrenzte Sitzung und erhält vom Provider eine Launch-URL.
01
Spieler und Spielverfügbarkeit prüfen
Die Plattform prüft Kontostatus, Währung, Land, Einschränkungen, Limits, Echtgeld- oder Demo-Modus und Spielverfügbarkeit.
02
Interne Sitzung erstellen
Eine Sitzungskennung wird mit Spieler, Spiel, Marke, Währung, Sprache, IP und Ablaufzeit erstellt.
03
Launch-URL des Spiels abrufen
Der Provider erhält Sitzungsschlüssel, Benachrichtigungs- und Return-URLs, Gerätetyp, Jurisdiktion und Interface-Parameter.
04
Spiel im Browser öffnen
Der Spieler öffnet die zurückgegebene URL, während nachfolgende Finanzoperationen direkt zwischen den Servern verarbeitet werden.
Guthabenoperationen
Zentrale Guthabenoperationen
Methodennamen unterscheiden sich je nach Provider, die Logik bleibt jedoch gleich: Guthabenprüfung, Belastung des Einsatzes, Gutschrift des Gewinns und Stornierung einer zuvor bestätigten Operation.
Guthabenprüfung
Gibt das verfügbare Spielerguthaben in der aktiven Sitzungswährung zurück, ohne das Finanz-Ledger zu ändern.
Einsatz belasten
Prüft Spieler, Sitzung, Währung und verfügbare Mittel und belastet den bestätigten Einsatz genau einmal.
Gewinn gutschreiben
Schreibt Gewinne anhand eindeutiger Operations- und Rundenkennungen gut, einschließlich eines Nullergebnisses.
Einsatz und Ergebnis in einer Anfrage
Verarbeitet Einsatz und Spielergebnis gemeinsam, wenn der Provider dieses Modell unterstützt.
Operation stornieren
Erstellt eine separate Korrekturoperation für einen zuvor bestätigten Einsatz oder eine Auszahlung, ohne den ursprünglichen Eintrag zu löschen.
Boni und Freispiele
Überträgt Daten zu Bonuskampagne und Spielrunde und trennt dabei Echtgeld- und Bonusmittel.
Währung und Betragspräzision
Jede Operation prüft Währung, Betragseinheiten, Dezimalstellen und Rundungsregeln.
Plattformantwort
Gibt Operationsstatus, interne Kennung, aktuelles Guthaben und einen einheitlichen Fehlercode zurück.
Lebenszyklus der Runde
Lebenszyklus einer Spielrunde
Eine Runde kann mehrere Einsätze und Ergebnisse enthalten. Ihr Status wird durch die Spielregeln bestimmt, nicht nur durch die Reihenfolge der Netzwerkanfragen.
Runde erstellt
Die Plattform erhält die Rundenkennung erstmals und legt einen internen Datensatz an.
Runde aktiv
Die Runde kann weitere Einsätze, Spielaktionen und Zwischengewinne enthalten.
Einsatz angenommen
Die Belastung wird von der Plattform bestätigt und mit der eindeutigen Operationskennung des Providers verknüpft.
Ergebnis erhalten
Ein Gewinn oder Nullergebnis wurde empfangen, die Runde kann nach den Spielregeln jedoch weiter offen bleiben.
Runde geschlossen
Der Provider hat das Ende der Runde bestätigt und alle erwarteten Finanzoperationen wurden verarbeitet.
Operationen storniert
Eine oder mehrere Operationen wurden korrigiert, wobei die vollständige ursprüngliche Historie erhalten bleibt.
Eine Runde kann mehrere Operationen enthalten
Die Rundenkennung darf nicht der einzige Idempotenzschlüssel sein. Jeder Einsatz, jede Auszahlung und jede Stornierung sollte eine eigene eindeutige Kennung haben.
Zuverlässigkeit und Abstimmung
Duplikatschutz und finanzielle Abstimmung
Die Gaming-API muss wiederholte Anfragen, Antwortverzögerungen, Operationen außerhalb der Reihenfolge und Provider-Wiederherstellung nach einem Fehler sicher verarbeiten.
Sichere Wiederholungsverarbeitung
Die Provider-Operationskennung ist für jede Art finanzieller Aktion eindeutig.
Eine wiederholte Anfrage gibt das ursprüngliche Ergebnis und aktuelle Guthaben zurück, ohne erneut Geld zu bewegen.
Eine Wiederholung mit anderem Betrag, anderer Währung oder anderem Spieler wird als Datenkonflikt abgelehnt.
Eine Stornierung verweist auf eine konkrete ursprüngliche Operation und erhält ebenfalls eine eigene eindeutige Kennung.
Runden-Ledger und Abstimmung
Sitzungs-, Runden-, Provider-Operations- und Plattform-Operationskennungen speichern.
Operationstyp, Betrag, Währung, Guthaben vor und nach der Operation sowie Verarbeitungszeit protokollieren.
Gebuchte Einträge nicht verändern; stattdessen eine separate Korrekturoperation erstellen.
Provider-Berichte, Spielrunden, Guthabenbewegungen, GGR und erkannte Abweichungen abstimmen.
Tests
Was in der Testumgebung geprüft werden muss
Die Prüfungen sollten Spielstart, Spielerbeschränkungen, unzureichendes Guthaben, wiederholte Operationen, Antwortverzögerungen, Stornierungen und die Abstimmung einer geschlossenen Runde abdecken.
Start und Spielsitzung
Echtgeld- und Demo-Modus, ungültige Währung, verbotenes Land, abgelaufener Zugriff und nicht verfügbares Spiel.
Guthaben- und Einsatzablehnung
Unzureichende Mittel, gesperrter Spieler, Währungsabweichung und überschrittenes Limit.
Verzögerung und unbekanntes Ergebnis
Der Provider erhält keine Antwort, nachdem die Belastung tatsächlich erfolgt ist, und sendet die Operation mit derselben Kennung erneut.
Wiederholte Einsätze und Gewinne
Dieselbe Kennung trifft vor oder nach Abschluss der Verarbeitung erneut ein, auch mit widersprüchlichen Parametern.
Stornierung von Operationen
Stornierung eines Einsatzes, Stornierung eines Gewinns, wiederholte Stornierung und Verweis auf eine unbekannte ursprüngliche Operation.
Rundenabstimmung
Beträge von Einsatz, Gewinn und Stornierung, finaler Status, Guthabenbewegung und Provider-Bericht müssen übereinstimmen.
Checkliste vor dem Start
Der Start erfolgt, nachdem Spielsitzungen, Guthabenoperationen, Duplikatschutz, Stornierungen und Reporting geprüft wurden.
Test- und Produktivumgebung verwenden unterschiedliche Zugangsdaten, API-Endpunkte und Starteinstellungen.
Der Schlüssel der Spielsitzung ist zeitlich begrenzt und an Spieler, Spiel, Währung und Marke gebunden.
Jede Guthabenoperation ist durch eine eindeutige Provider-Kennung geschützt.
Wiederholte Einsätze, Gewinne und Stornierungen ändern das Guthaben kein zweites Mal.
Gebuchte Einträge werden nicht gelöscht, sondern durch separate Korrekturoperationen berichtigt.
Event-Logs, Warnungen, Provider-Berichte und der Prozess zur Rundenabstimmung sind eingerichtet.
Gaming-API-Ablauf konfigurieren?
Senden Sie uns Provider-Dokumentation, Liste der Guthabenoperationen, Modell der Spielrunden, Währungen und Reporting-Anforderungen. APIACE hilft, Spielstart, Einsätze, Gewinne, Stornierungen und finanzielle Abstimmung zu strukturieren.