Fehlerbehandlung der Buchungsmaschinen-API: drei Fehler, die Geld kosten

Das Support-Ticket kommt an einem Donnerstagabend. Ein Kunde hat bezahlt, die Seite hat sich gedreht, dann erschien ein generischer Fehler. Die Karte wurde belastet. In Ihren Logs steht ein POST an den Lieferanten, auf den nie eine Antwort kam. Hat die Airline einen Sitz gehalten? Niemand kann es sagen, und der Kunde wartet. Gute Fehlerbehandlung der Buchungsmaschinen-API ist zum großen Teil die Arbeit, gar nicht erst in diese Lage zu geraten, oder zumindest genau zu wissen, was zu tun ist, wenn es doch passiert.
Die meisten Integrationsleitfäden behandeln Fehler als Katalog von Statuscodes. Bei Buchungen sind die Codes der einfache Teil. Geld kostet eine kleine Zahl von Situationen, in denen die Anfrage gescheitert aussieht, die Welt sich aber trotzdem verändert hat, oder erfolgreich aussieht, ohne dass sich etwas verändert hat. Drei davon zählen mehr als alle anderen.
Fehler eins: Der Preis hat sich zwischen Suche und Buchung bewegt
Suchergebnisse sind ein Angebot, kein Vertrag. Tarife sind gecacht, das Kontingent wird über alle Kanäle des Lieferanten geteilt, und die vor wenigen Minuten gezeigte Zahl kann schon veraltet sein. Der Lieferant sagt es Ihnen im Schritt „Buchung anlegen", manchmal mit einer klaren Antwort „Tarif geändert", manchmal indem er in einer sonst erfolgreichen Antwort leise eine andere Summe zurückgibt.
Die zweite Variante ist die gefährliche. Liest Ihr Code die Bestätigung, speichert die Buchung und belastet den Kunden mit dem Betrag, den er gesehen hat, geht die Differenz zulasten Ihrer Marge, oder später eines ADM. Die Regel ist einfach: Vergleichen Sie die vom Lieferanten bestätigte Summe mit der vom Kunden akzeptierten, jedes Mal, im Code, bevor Sie die Zahlung einziehen.
Was bei einer Abweichung zu tun ist, hängt von ihrer Größe ab und davon, wer sie trägt. Ein paar Cent Rundung zwischen Währungen sind eine Toleranz, die man einmal festlegt. Alles darüber geht mit neuem Preis und einer ausdrücklichen Zustimmung zurück an den Kunden. Nie automatisch schlucken, nie automatisch einziehen.
Fehler zwei: Gebucht, aber nicht ausgestellt
Ein vorhandenes PNR ist kein vorhandenes Ticket. Viele Abläufe legen zuerst die Reservierung an und stellen das E-Ticket in einem eigenen Schritt aus, mit einer Frist dazwischen. Gelingt die Zahlung und scheitert die Ausstellung, halten Sie das Geld des Kunden und eine Reservierung, die nach ihrer eigenen Uhr verfällt.
Dieser Fehler ist selten laut. Der Ausstellungsaufruf liefert einen Fehler oder ein Timeout, und die Buchung steht in einem Zustand, den Ihre Datenbank „bezahlt" nennt, während der Lieferant noch „gehalten" sagt. Währenddessen läuft die Ticketing-Frist, und anders als Ihre Support-Warteschlange wartet die Airline nicht.
Behandeln Sie das als eigenen Zustand, nicht als Spielart von Erfolg oder Misserfolg. Eine Buchung braucht mindestens diese: angelegt, gehalten, Zahlung eingezogen, wird ausgestellt, ausgestellt, fehlgeschlagen und erstattbar. „Zahlung eingezogen, wird ausgestellt" braucht einen Timer: Steht eine Buchung zu lange dort, muss ein Job die Reservierung beim Lieferanten neu lesen und entscheiden, statt darauf zu warten, dass ein Mensch es bemerkt. Die Entscheidung ist billig, wenn Sie die Frist des Lieferanten kennen, denn sie sagt, wie lange Sie gefahrlos wiederholen dürfen, bevor Sie erstatten müssen.
Fehler drei: Das Timeout mit unbekanntem Ausgang
Das ist das Ticket vom Donnerstagabend. Ihre Anfrage ging raus; keine Antwort kam zurück; die Verbindung brach ab oder das Gateway gab auf. Der Lieferant hat sie vielleicht vollständig, teilweise oder gar nicht verarbeitet.
Die Versuchung ist der Wiederholungsversuch. Wiederholen Sie einen Buchungsaufruf nicht blind, denn der zweite Versuch kann eine zweite Reservierung erzeugen, und eine Dublette kostet echtes Geld: zwei gehaltene Sitze, vielleicht zwei ausgestellte Tickets, ein Erstattungsstreit um eines davon.
Die sichere Reihenfolge: anhalten, lesen, entscheiden. Halten Sie den Kundenablauf mit einem ehrlichen Zustand wie „Wir bestätigen Ihre Buchung" an. Lesen Sie die Lieferantenseite, indem Sie die Buchung über die Referenz suchen, die Sie vor dem Aufruf erzeugt haben (deshalb legen Sie zuerst Ihre eigene Client-Referenz an und senden sie mit, sofern der Lieferant sie annimmt). Erst dann entscheiden Sie: gefunden heißt, vom echten Zustand aus weiterzumachen; nicht gefunden nach dem Verarbeitungsfenster des Lieferanten heißt, dass ein einmaliger Wiederholungsversuch sicher ist.
Bietet der Lieferant keine Suche über Ihre Referenz, suchen Sie nach Passagiername, Strecke und Datum in einem engen Fenster und werten einen Treffer als gefunden. Hässlich, aber weit billiger als eine Dublette.
Eine Entscheidungstabelle, der Sie widersprechen dürfen
| Was Sie sehen | Was Sie wissen | Was zu tun ist | Was nicht |
|---|---|---|---|
| Lieferant meldet „Tarif geändert" | Nichts wurde gebucht | Neue Summe zeigen, Zustimmung einholen, Anlage neu starten | Mit dem alten Preis erneut senden und hoffen |
| Erfolg, aber Summe weicht vom akzeptierten Betrag ab | Eine Buchung zum neuen Preis existiert | Zahlung zurückhalten, Kunden fragen, Buchung bei Ablehnung stornieren | Den alten Betrag einziehen und die Differenz tragen |
| Zahlung eingezogen, Ausstellung schlägt fehl | PNR existiert, Ticketstatus unbekannt | Reservierung neu lesen, Ausstellung innerhalb der Frist wiederholen, danach erstatten | Buchung als fehlgeschlagen markieren und das PNR vergessen |
| Timeout bei der Anlage | Ausgang unbekannt | Über Ihre Referenz suchen, dann fortfahren oder einmal wiederholen | Sofortiger blinder Wiederholungsversuch |
| Timeout bei der Stornierung | Sie haften womöglich weiter für das Segment | Status neu lesen, bevor Sie dem Kunden etwas sagen | „Storniert" anzeigen, weil der Klick stattfand |
Eine Zeile, über die man streiten kann: Manche Teams erstatten schon beim ersten Ausstellungsfehler, um den Kunden zu beruhigen. Bei kleinen Tickets vertretbar, bei teuren eine schlechte Angewohnheit, denn man verliert einen Tarif, den man eine Minute später noch hätte retten können.
Was Sie ein Fehler hier kostet
Jeder Fehler hat eine andere Rechnung. Eine übersehene Preisänderung ist Marge, die bei jeder betroffenen Buchung verloren geht, oft erst beim Abgleich bemerkt. Ein Fall „gebucht, nicht ausgestellt" ist ein Kunde, der mit einer verfallenen Reservierung und einer Abbuchung auf der Karte am Flughafen steht: Rückbuchung und Reputationsproblem in einem. Ein blinder Wiederholungsversuch nach Timeout ist eine doppelte Reservierung, und Airlines prüfen Dubletten; ein Muster davon landet in einem ADM.
Nichts davon ist exotisch. Es ist die unglamouröse Installation, die eine Demo von etwas trennt, das über ein Wochenende unbeaufsichtigt laufen kann.
Bauen Sie den Abgleich, bevor Sie ihn brauchen
Alle drei Fehler enden gleich: Ihre Datenbank und die des Lieferanten sind uneins. Schreiben Sie also den Job, der beide vergleicht, vor dem ersten Vorfall, nicht danach. Ein nächtlicher Lauf ist das Minimum; alle paar Minuten für alles in einem Übergangszustand ist besser. Er listet Buchungen, die in „gehalten", „wird ausgestellt" oder „unbekannt" hängen, fragt den Lieferanten und repariert den Datensatz oder eröffnet ein Ticket samt Belegen.
Bewahren Sie jede Anfrage und Antwort der Buchungsaufrufe auf, Timeouts eingeschlossen, mit der gesendeten Referenz. Bestreitet ein Kunde eine Belastung, ist dieses Log Ihr Argument. Es hält auch die Latenzdebatte ehrlich: Lesen Sie was Sie an der API-Latenz beheben können und was nicht, um zu sehen, warum Timeouts eine Tatsache sind und kein Bug, den man ausrotten könnte.
Wenn Sie noch entscheiden, wie die Lieferantenanbindung selbst aussehen soll, behandelt die Integration einer Flugbuchungs-API die Reihenfolge der Aufrufe, die dieser Beitrag voraussetzt. Und wenn Sie besprechen möchten, wie sich diese Zustände auf unsere Flug- und Hotel-APIs abbilden: Der Zugang beginnt mit einem Gespräch, siehe die Seite zur Reise-API.