Hoppa till innehållet
Blogg

Felhantering i bokningsmotorns API: tre fel som kostar pengar

Tekravel Redaktion
Skriven med hjälp av AI

Supportärendet kommer en torsdagskväll. En kund har betalat, sidan snurrade och visade sedan ett allmänt fel. Kortet är belastat. Dina loggar visar ett POST till leverantören som aldrig fick något svar. Höll flygbolaget en plats? Ingen kan säga det, och kunden väntar. Bra felhantering i bokningsmotorns API handlar mest om att aldrig hamna i det läget, eller åtminstone veta exakt vad man ska göra när man gör det.

De flesta integrationsguider behandlar fel som en katalog av statuskoder. I bokning är koderna den enkla delen. Det som kostar pengar är en liten uppsättning situationer där anropet ser ut att ha misslyckats men världen ändå förändrades, eller ser ut att ha lyckats utan att världen förändrades. Tre av dem väger tyngre än resten.

Fel ett: priset flyttade sig mellan sökning och bokning

Sökresultat är en offert, inte ett avtal. Priser cachas, lagret delas över alla kanaler leverantören säljer genom, och siffran du visade 14:02 kan vara inaktuell några minuter senare. Leverantören talar om det vid skapandet av bokningen, ibland med ett tydligt svar om att priset ändrats, ibland genom att tyst returnera en annan totalsumma i ett i övrigt lyckat svar.

Den andra varianten är den farliga. Om din kod läser bekräftelsen, sparar bokningen och debiterar kunden det belopp hen såg, tas mellanskillnaden ur din marginal eller senare ur en ADM. Regeln är därför enkel: jämför totalsumman leverantören bekräftar med den kunden godkände, varje gång, i kod, innan du tar betalt.

Vad du gör när de skiljer sig beror på gapets storlek och på vem som bär det. Några ören avrundning mellan valutor är en tolerans du sätter en gång. Allt större går tillbaka till kunden som ett nytt pris med en tydlig godkänn-knapp. Absorbera det aldrig automatiskt och debitera det aldrig automatiskt.

Fel två: bokad, men inte utfärdad

Att en PNR finns är inte detsamma som att en biljett finns. Många flöden skapar reservationen först och utfärdar e-biljetten i ett separat steg, med en tidsgräns emellan. Om betalningen går igenom och utfärdandet misslyckas håller du en kunds pengar och en reservation som löper ut på sin egen klocka.

Felet är sällan högljutt. Utfärdandeanropet returnerar ett fel eller en timeout, och bokningen blir stående i ett läge som din databas kallar ”betald” medan leverantören fortfarande säger ”hållen”. Under tiden tickar tidsgränsen för utfärdande, och till skillnad från din supportkö väntar inte flygbolaget.

Hantera det som ett eget tillstånd, inte som en variant av framgång eller misslyckande. En bokning behöver åtminstone dessa: skapad, hållen, betalning tagen, utfärdas, utfärdad, misslyckad-och-återbetalningsbar. ”Betalning tagen, utfärdas” är tillståndet som behöver en timer: när en bokning stått där för länge ska ett jobb läsa om reservationen från leverantören och avgöra, inte vänta på att en människa ska märka det. Beslutet är billigt när du känner till leverantörens tidsgräns, eftersom den visar hur länge du säkert kan försöka igen innan du måste återbetala.

Fel tre: timeouten med okänt utfall

Det här är torsdagskvällens ärende. Din begäran gick iväg, inget svar kom tillbaka, anslutningen dog eller gatewayen gav upp. Leverantören kan ha behandlat den helt, delvis eller inte alls.

Frestelsen är att försöka igen. Gör inte en blind omförsök på ett skapa-bokning-anrop, för det andra försöket kan ge en andra reservation, och dubbletter är en verklig kostnad: två platser hållna, kanske två utfärdade biljetter, en återbetalningsstrid om en av dem.

Den säkra ordningen är: stanna, läs, avgör. Stoppa kundflödet med ett ärligt läge, ”vi bekräftar din bokning”. Läs leverantörens sida genom att slå upp bokningen med den referens du genererade före anropet (därför skapar du din egen klientreferens först och skickar med den om leverantören tar emot en). Avgör först därefter: hittad betyder att du fortsätter från det verkliga läget; ej hittad efter leverantörens egna handläggningsfönster betyder att det är säkert att försöka en gång till.

Om leverantören inte låter dig slå upp på din referens, sök på passagerarnamn, rutt och datum inom ett smalt fönster och behandla en träff som hittad. Fult, men mycket billigare än en dubblett.

En beslutstabell du får vara oenig med

Vad du serVad du vetVad du ska göraVad du inte ska göra
Leverantören svarar att priset ändratsInget bokadesVisa nya totalsumman, be om godkännande, kör skapa igenKöra om med det gamla priset och hoppas
Lyckat, men totalsumman skiljer sig från den kunden godkändeEn bokning finns till det nya prisetHåll betalningen, fråga kunden, annullera bokningen om kunden tackar nejTa det gamla beloppet och svälja mellanskillnaden
Betalning tagen, utfärdandeanropet ger felEn PNR finns, biljettstatus okändLäs om reservationen, försök utfärda igen inom tidsgränsen, återbetala efter denMarkera bokningen som misslyckad och glömma PNR:en
Timeout vid skapandeUtfallet okäntSlå upp via din referens, sedan fortsätta eller försöka en gång tillOmedelbart blint omförsök
Timeout vid avbokningDu kan fortfarande vara ansvarig för segmentetLäs om statusen innan du säger något till kundenVisa ”avbokad” för att klicket skedde

En rad du kanske ifrågasätter: vissa team återbetalar vid första utfärdandefelet för att hålla kunden lugn. Det går att försvara för billiga biljetter men är en dålig vana för dyra, eftersom du kan förlora ett pris som gick att rädda en minut senare.

Vad det kostar att göra fel

Varje fel har sin egen räkning. En missad prisändring är marginal som försvinner på varje bokning den rör, ofta oupptäckt tills avstämningen. Bokad-men-inte-utfärdad är en kund som dyker upp på flygplatsen med en reservation som löpt ut och en debitering på kortet, alltså både en chargeback och ett förtroendeproblem. Ett blint omförsök vid timeout är en dubbelbokning, och flygbolag granskar dubbletter; ett mönster av dem är just det som hamnar i en ADM.

Inget av detta är exotiskt. Det är det oglamorösa rörarbetet som skiljer en demo från något du kan låta gå över en helg.

Bygg avstämningsjobbet innan du behöver det

Alla tre felen slutar likadant: din databas och leverantörens är oense. Skriv därför jobbet som jämför dem före den första incidenten, inte efter. En nattlig körning är minimum; var några minuter för allt som står i ett mellanläge är bättre. Det listar bokningar som fastnat i hållen, utfärdas eller okänd, frågar leverantören vad den anser och antingen rättar posten eller skapar ett ärende med bevisen bifogade.

Spara varje begäran och varje svar för bokningsanrop, timeouts inklusive, tillsammans med referensen du skickade. När en kund bestrider en debitering är den loggen ditt argument. Den håller också latensdiskussionen ärlig: se vad du kan och inte kan åtgärda med API-latens för varför timeouts är ett villkor och inte en bugg att utrota.

Om du fortfarande avgör hur själva leverantörsanslutningen ska kopplas har genomgången API-integration för flygbokning ordningen på anropen som den här artikeln utgår från. Och vill du prata om hur tillstånden motsvarar våra flyg- och hotell-API:er börjar åtkomst som ett samtal: se sidan om travel-API:er.

Tekravel Redaktion

Desk för resetechnologi

Tekravels desk för resetechnologi skriver för branschen: byråägare, konsolidatorer och utvecklarna som integrerar dem. Varje artikel kontrolleras mot plattformen den beskriver innan den publiceras.