iGaming-API-Integrationen

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.

Drei vernetzte Sportsbook-Systeme für Quotenmärkte, verifizierte Wettannahme und Abrechnungsdaten
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.

KennungBedeutungSchutzmaßnahme
Event-IDSportereignis beim AnbieterProvider-Kontext erhalten
Markt-IDWettart und LinieSpezifikatoren speichern
Selection-IDKonkrete AuswahlNicht nach Text verbinden
QuotenversionStand des PreisesVeraltetes ablehnen
Ticket-IDAngenommene WetteBei Retry stabil halten
Settlement-IDErgebnisnachrichtZum 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.

  1. Anfrage mit Auswahl, Einsatz, Quote und eindeutigem Schlüssel empfangen.
  2. Preis, Status, Kundenschutz, Risikolimit und Kontodeckung neu bewerten.
  3. Vom zuständigen Ticketdienst angenommen, abgelehnt oder ausstehend erhalten.
  4. Ticket und Wallet-Reservierung genau einmal speichern; Wiederholungen identisch beantworten.
Dreistufiges Sportsbook-API-Schema von Quoten über die Bestätigung eines Wettscheins zur Abrechnung
Die 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]

FehlerfallReaktionKontrollpunkt
Doppelte NachrichtÜber Schlüssel überspringenKeine zweite Änderung
Lücke im FeedMarkt sicher anhaltenReplay oder Snapshot
Verbindung verlorenAlte Preise sperrenQuelle wieder aktuell
Spätes ErgebnisAls Ereignis verarbeitenTicketbezug vorhanden
NeustartAb Checkpoint fortsetzenKeine 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]

  1. Annahmequote, Einsatz, Marktparameter und Regelversion unverändert sichern.
  2. Nur Ergebnisse mit gültiger Quelle und passender Ticketreferenz zulassen.
  3. Auszahlung oder Rückzahlung einmalig unter eigener Settlement-ID buchen.
  4. 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.

TicketstatusWallet-AktionNachweis
Nur QuoteKeine BelastungAnfrage und Gültigkeit
AngenommenEinsatz einmal reservierenAnnahme-ID
AbgelehntReservierung freigebenAblehnungsgrund
AbgerechnetGewinn buchen oder schließenErgebnis und Buchung
KorrigiertGegenbuchung oder ErstattungVorige 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.

  1. IDs, Anbieterrechte, Quotengenauigkeit und Gültigkeitsfenster abnehmen.
  2. Idempotente Annahme, Timeouts, Ablehnung und Freigabe von Reservierungen üben.
  3. Settlement, Storno, Gegenbuchung und Kassenabgleich mit Testdaten belegen.
  4. 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.

Quellen und weiterführende Links

Diagrammansicht