Sportsbook-API-Integration: Quoten, Wetten und Abrechnung
Wenn eine Sportwette auf einer Website angezeigt wird, ist sie noch lange nicht angenommen. Der Quotenlieferant meldet Märkte und Preise; ein Annahmesystem entscheidet über Wettschein, Einsatz und Limits; Wallet und Abrechnung verwalten die finanziellen Folgen. Eine verlässliche Sportsbook-API-Integration verbindet diese Systeme über eindeutige Kennungen, definierte Zustände, sichere Wiederholungen und einen prüfbaren Buchungsweg. Dieser Leitfaden verfolgt den Weg vom Live-Markt bis zur Zahlung oder Ergebnisberichtigung. Er setzt ausdrücklich nicht voraus, dass ein Lieferant von Quoten auch Wetten annimmt, Guthaben verwaltet oder Rechte für bestimmte Länder einräumt.
Veröffentlicht
Marktinformationen, Annahme und finanzielle Abrechnung benötigen getrennte Prüfungen.
Inhalt
Welche Systeme umfasst eine Sportsbook-API?
Typisch sind drei Aufgabenbereiche: Spielplan und Quotenmärkte, die Prüfung und Annahme von Wettscheinen sowie die spätere Ergebnis- und Zahlungsabrechnung. Ein Anbieter kann mehrere Bereiche liefern; andernfalls müssen mehrere Verträge und Schnittstellen zusammenspielen. Bereits im Architekturplan sollte feststehen, wer für welche Entscheidung verantwortlich ist. [1]
Ein Marktstatus aus einem vertrauenswürdigen Feed berechtigt nicht zu einer Wallet-Buchung. Auch ein Klick auf „Wetten“ ist noch keine Annahme. Erst die verifizierte Entscheidung des zuständigen Ticketdienstes bestimmt, welcher Einsatz und welche Quote verbindlich gespeichert werden.
Wie werden Events, Märkte und Auswahlen eindeutig zugeordnet?
Vergeben Sie interne Kennungen für Sportereignis, Markt, Auswahl und Ticket und behalten Sie die ursprünglichen Provider-IDs samt Namensraum. Ein Ereignis hat viele Märkte, ein Markt unterschiedliche Optionen und Linien. Ein Text wie „Über 2,5“ identifiziert ohne Event, Markt und Parameter keine eindeutige Wette.
Kennung
Bedeutung
Schutzmaßnahme
Event-ID
Sportereignis beim Anbieter
Provider-Kontext erhalten
Markt-ID
Wettart und Linie
Spezifikatoren speichern
Selection-ID
Konkrete Auswahl
Nicht nach Text verbinden
Quotenversion
Stand des Preises
Veraltetes ablehnen
Ticket-ID
Angenommene Wette
Bei Retry stabil halten
Settlement-ID
Ergebnisnachricht
Zum Ticket verknüpfen
Versionieren Sie die Zuordnung und bewahren Sie die Rohdaten auf. Verschobene Termine oder geänderte Marktnamen dürfen einen bestehenden Wettschein nicht unbemerkt auf ein anderes Ereignis zeigen lassen. Quoten- und Settlement-Meldungen sind im Feed unterschiedliche Nachrichtentypen. [1]
Was passiert bei Quotenänderung oder Marktsperre?
Zwischen Anzeige und Absenden kann sich die Quote ändern oder der Markt gesperrt werden. Das System muss Zeitstempel, Reihenfolge und Status nach der vereinbarten Feed-Semantik verarbeiten. Eine alte Zahl im Cache ist keine Freigabe für eine neue Wette. Die Dokumentation zu odds_change verdeutlicht diese Zustandswechsel. [2]
Quellenzeit und zuletzt angewandte Version pro Markt protokollieren.
Aktiv, ausgesetzt, geschlossen und unbekannt sauber unterscheiden.
Maximales Alter einer Quote und ihre serverseitige Prüfung festlegen.
Kunden niemals eine Annahme allein aufgrund des Bildschirmwerts zusagen.
Der Cache beschleunigt die Anzeige, die Annahmestelle muss aber Preis, Risikolimits, Kontoberechtigung und Deckung erneut kontrollieren. Ändert sich der Preis, folgt eine eindeutige Ablehnung oder eine ausdrücklich bestätigte neue Quote.
Wie wird aus einem Wettklick ein akzeptiertes Ticket?
Der Auftrag enthält Kunden- und Marktkontext, Auswahl, Einsatz, angebotene Quote und eine eindeutige Anfrage-ID. Der verantwortliche Dienst prüft Marktstatus, Guthaben, Limits und Vertragsregeln. Ein Quotenfeed kann ohne eigene API zur Wettannahme betrieben werden.
Anfrage mit Auswahl, Einsatz, Quote und eindeutigem Schlüssel empfangen.
Preis, Status, Kundenschutz, Risikolimit und Kontodeckung neu bewerten.
Vom zuständigen Ticketdienst angenommen, abgelehnt oder ausstehend erhalten.
Ticket und Wallet-Reservierung genau einmal speichern; Wiederholungen identisch beantworten.
⊕Diagramm vergrößernDie Quoten dienen der Prüfung; erst eine bestätigte Annahme erzeugt die finanzielle Verpflichtung.
Bleibt die Antwort wegen eines Timeouts aus, kann der Partner die Wette trotzdem angenommen haben. Fragen Sie zuerst den Status über Anfrage- oder Ticket-ID ab. HTTP-POST ist ohne besondere Vorkehrungen nicht automatisch gefahrlos wiederholbar. [6]
Wie funktioniert die Wiederherstellung nach Feed-Ausfällen?
Live-Nachrichten können doppelt, verspätet oder nach einer Verbindungsunterbrechung unvollständig eintreffen. Notwendig sind Quellenkennung, Reihenfolge, dauerhafter Checkpoint und ein dokumentiertes Recovery-Verfahren. Quittieren Sie kritische Ereignisse erst nach ihrer gesicherten Verarbeitung. Provider können die Wiederholung von Settlement- und Stornonachrichten getrennt behandeln. [5]
Fehlerfall
Reaktion
Kontrollpunkt
Doppelte Nachricht
Über Schlüssel überspringen
Keine zweite Änderung
Lücke im Feed
Markt sicher anhalten
Replay oder Snapshot
Verbindung verloren
Alte Preise sperren
Quelle wieder aktuell
Spätes Ergebnis
Als Ereignis verarbeiten
Ticketbezug vorhanden
Neustart
Ab Checkpoint fortsetzen
Keine doppelte Auszahlung
Ein frischer Quotenstand beweist nicht, dass alle bisherigen finanziellen Ergebnisse angekommen sind. Prüfen Sie die Recovery-Regeln und Speicherfristen des konkreten Feeds und gleichen Sie offene Wettscheine separat ab.
Wie werden Gewinne, Stornos und Rollbacks gebucht?
Das Settlement wertet einen angenommenen Wettschein nach den geltenden Wettregeln aus. Sieg, Verlust, Rückzahlung und teilweise Abrechnung müssen entsprechend dem Provider-Vertrag modelliert werden. Bei Kombiwetten kommen eigene Regeln hinzu. Unified Odds Feed unterscheidet bet_settlement von rollback_bet_settlement. [3] [4]
Annahmequote, Einsatz, Marktparameter und Regelversion unverändert sichern.
Nur Ergebnisse mit gültiger Quelle und passender Ticketreferenz zulassen.
Auszahlung oder Rückzahlung einmalig unter eigener Settlement-ID buchen.
Korrekturen als neue Gegenbuchung mit Begründung erfassen, nicht Historie löschen.
Ein Rollback ist kein zusätzlicher Gewinn. Auch Storno und Void sind nicht in jedem Provider-Protokoll gleichbedeutend. Maßgeblich ist die tatsächliche Ereignissemantik. In Großbritannien verlangt RTS 5 dort, wo er gilt, eine regelkonforme Ergebnisermittlung und Information bei relevanten Fehlern. [7]
Wie werden Wallet und Wettbuchungen abgeglichen?
Für Einsatzreservierung, angenommenes Ticket, Auszahlung und spätere Korrektur brauchen Sie getrennte, unveränderliche Referenzen. Eine eingegangene Nachricht ist noch keine erfolgreiche Auszahlung. Geldbewegungen sind jeweils mit einem eindeutigen Buchungsschlüssel abzusichern und gegen Ticket- und Partnerstatus abzugleichen.
Ticketstatus
Wallet-Aktion
Nachweis
Nur Quote
Keine Belastung
Anfrage und Gültigkeit
Angenommen
Einsatz einmal reservieren
Annahme-ID
Abgelehnt
Reservierung freigeben
Ablehnungsgrund
Abgerechnet
Gewinn buchen oder schließen
Ergebnis und Buchung
Korrigiert
Gegenbuchung oder Erstattung
Vorige ID und Grund
Der Abgleich benötigt Währung, exakte Beträge, offene Reservierungen und alle Gegenbuchungen je Ticket. Differenzen gehören in eine Untersuchung, nicht in automatisch erzeugte Ausgleichszahlungen aus ungeprüften Webhooks.
Welche Latenz- und Risikoregeln sind bei Livewetten wichtig?
Während des Spiels können Märkte innerhalb kurzer Zeit gesperrt oder neu bewertet werden. Ein schneller Feed verbessert die Anzeige, ersetzt aber weder Stoppsignale noch Annahmefenster, Exposure-Limits und etwaige Wettverzögerungen. Bei unklarem Marktstatus muss das Fail-safe-Verhalten vorher feststehen.
Feed-Verzögerung, Alter der Kundenquote und Annahmezeit getrennt messen.
Bei gesperrtem Markt oder fehlender Risikoentscheidung kontrolliert ablehnen.
Tatsächlich akzeptierte Quote unabhängig von der letzten Anzeige speichern.
Schnelle Kurswechsel, Spielabbrüche und doppelte Eingaben unter Last testen.
Annahme oder Ablehnung muss für den Kunden eindeutig sein. Weder Annahmezeit noch Abrechnungsdauer oder Limits lassen sich pauschal für alle Märkte versprechen. [2] [7]
Welche Sicherheits- und Compliance-Prüfungen sind nötig?
Schützen Sie Schnittstellen mit eindeutigen Dienstidentitäten, Berechtigungen pro Kunde und Marke, sicherer Schlüsselverwaltung, Transportverschlüsselung und überprüfbarem Audit. Das bloße Lesen eines Quotenfeeds darf keine Berechtigung zum Erzeugen von Tickets oder Geldbuchungen vermitteln.
Bei veralteten Preisen, Feed-Lücken und Annahmeversuchen auf gesperrten Märkten alarmieren.
Offene, angenommene und abgerechnete Tickets gegen Partnerbelege abgleichen.
Timeouts, doppelte POSTs, gefälschte Rückmeldungen und Rollback-Reihenfolge prüfen.
Lizenzierung, Datenschutz, Aufbewahrung und Beschwerden je Zielmarkt dokumentieren.
Überwachen Sie technische Erreichbarkeit und finanzielle Korrektheit auf getrennten Dashboards. Eine hohe Zahl verarbeiteter Ereignisse erklärt noch keine offenen Verbindlichkeiten oder doppelt ausgezahlten Wettscheine.
Welche Tests gehören zur Freigabe einer Sportsbook-API?
Führen Sie den kompletten Lebenszyklus in einer Testumgebung durch: Quote geändert, Markt gesperrt, Ticket abgelehnt, Einsatz akzeptiert, Ergebnis verspätet, Void, Rollback, Feed-Neustart und Wallet-Differenz. Jede Situation muss sich bis zum ursprünglichen Quellereignis zurückverfolgen lassen.
IDs, Anbieterrechte, Quotengenauigkeit und Gültigkeitsfenster abnehmen.
Idempotente Annahme, Timeouts, Ablehnung und Freigabe von Reservierungen üben.
Settlement, Storno, Gegenbuchung und Kassenabgleich mit Testdaten belegen.
Betriebliche, sicherheitstechnische und rechtliche Freigaben vor Livegang sichern.
Die Qualität einer Integration zeigt sich nicht an vielen angezeigten Märkten. Entscheidend ist, dass jede Wette nachvollziehbar angenommen oder abgelehnt wurde und jede Auszahlung oder Berichtigung sauber belegt werden kann.