Spring til indhold
Blog

Fejlhåndtering i bookingmotorens API: tre fejl, der koster penge

Tekravel Redaktion
Skrevet med hjælp fra AI

Supporthenvendelsen kommer en torsdag aften. En kunde har betalt, siden snurrede og viste så en generel fejl. Kortet er trukket. Dine logs viser et POST til leverantøren, der aldrig fik svar. Holdt flyselskabet en plads? Ingen kan sige det, og kunden venter. God fejlhåndtering i bookingmotorens API handler mest om aldrig at havne i den situation, eller i det mindste om at vide præcis, hvad man gør, når man gør.

De fleste integrationsguider behandler fejl som et katalog af statuskoder. I booking er koderne den nemme del. Det, der koster penge, er en lille håndfuld situationer, hvor kaldet ser ud til at have fejlet, men verden alligevel har ændret sig, eller ser ud til at have virket uden at verden har ændret sig. Tre af dem betyder mere end resten.

Fejl ét: prisen flyttede sig mellem søgning og booking

Søgeresultater er et tilbud, ikke en kontrakt. Priser caches, lageret deles på tværs af alle kanaler, leverantøren sælger igennem, og tallet, du viste kl. 14.02, kan være forældet få minutter senere. Leverantøren fortæller det ved oprettelsen af bookingen, nogle gange med et tydeligt svar om, at prisen er ændret, andre gange ved stille og roligt at returnere en anden totalpris i et ellers vellykket svar.

Den anden variant er den farlige. Hvis din kode læser bekræftelsen, gemmer bookingen og trækker kunden for det beløb, vedkommende så, kommer forskellen fra din avance eller senere fra en ADM. Reglen er derfor enkel: sammenlign totalen, leverantøren bekræfter, med totalen, kunden accepterede, hver gang, i kode, før du hæver betalingen.

Hvad du gør, når de er forskellige, afhænger af forskellens størrelse og af, hvem der bærer den. Et par øre i afrunding mellem valutaer er en tolerance, du sætter én gang. Alt større går tilbage til kunden som en ny pris med en tydelig accepter-knap. Absorbér den aldrig automatisk, og træk den aldrig automatisk.

Fejl to: booket, men ikke udstedt

At en PNR findes er ikke det samme som, at en billet findes. Mange flows opretter reservationen først og udsteder e-billetten i et særskilt trin med en tidsfrist imellem. Lykkes betalingen og fejler udstedelsen, sidder du med en kundes penge og en reservation, der udløber på sit eget ur.

Fejlen er sjældent højlydt. Udstedelseskaldet returnerer en fejl eller en timeout, og bookingen bliver stående i en tilstand, din database kalder «betalt», mens leverantøren stadig siger «holdt». Imens løber tidsfristen for udstedelse, og i modsætning til din supportkø venter flyselskabet ikke.

Håndtér det som sin egen tilstand, ikke som en variant af succes eller fiasko. En booking skal mindst have disse: oprettet, holdt, betaling hævet, udsteder, udstedt, fejlet-og-kan-refunderes. «Betaling hævet, udsteder» er tilstanden, der har brug for et ur: når en booking har stået der for længe, skal et job læse reservationen igen fra leverantøren og afgøre sagen, ikke vente på, at et menneske opdager den. Beslutningen er billig, når du kender leverantørens tidsfrist, for den fortæller, hvor længe du trygt kan prøve igen, før du må refundere.

Fejl tre: timeouten med ukendt udfald

Det er torsdag aftens henvendelse. Din forespørgsel gik af sted, intet svar kom tilbage, forbindelsen døde, eller gatewayen gav op. Leverantøren kan have behandlet den helt, delvist eller slet ikke.

Fristelsen er at prøve igen. Gentag ikke blindt et opret-booking-kald, for andet forsøg kan give en anden reservation, og en dublet er en reel omkostning: to pladser holdt, måske to udstedte billetter, en refusionsstrid om den ene.

Den sikre rækkefølge er: stop, læs, afgør. Stop kundeflowet med en ærlig tilstand, «vi bekræfter din booking». Læs leverantørens side ved at slå bookingen op med den reference, du genererede før kaldet (derfor opretter du din egen klientreference først og sender den med, hvis leverantøren accepterer en). Først derefter afgør du: fundet betyder, at du fortsætter fra den faktiske tilstand; ikke fundet efter leverantørens eget behandlingsvindue betyder, at det er sikkert at prøve én gang til.

Hvis leverantøren ikke lader dig slå op på din reference, så søg på passagernavn, rute og dato inden for et snævert vindue og behandl et match som fundet. Grimt, men langt billigere end en dublet.

En beslutningstabel, du gerne må være uenig i

Hvad du serHvad du vedHvad du skal gøreHvad du ikke skal gøre
Leverantøren svarer, at prisen er ændretIntet blev booketVis den nye total, bed om accept, kør oprettelsen igenKøre igen med den gamle pris og håbe
Succes, men totalen afviger fra den, kunden accepteredeDer findes en booking til den nye prisHold betalingen, spørg kunden, annullér bookingen hvis kunden afslårHæve det gamle beløb og æde forskellen
Betaling hævet, udstedelseskaldet giver fejlDer findes en PNR, billetstatus ukendtLæs reservationen igen, prøv udstedelse igen inden fristen, refundér efter denMarkere bookingen som fejlet og glemme PNR'en
Timeout ved oprettelseUdfaldet er ukendtSlå op på din reference, derefter fortsæt eller prøv én gang igenØjeblikkeligt blindt forsøg igen
Timeout ved annulleringDu hæfter muligvis stadig for segmentetLæs status igen, før du siger noget til kundenVise «annulleret», fordi der blev klikket

En række, du måske vil bestride: nogle teams refunderer ved den første udstedelsesfejl for at holde kunden rolig. Det kan forsvares for små billetter og er en dårlig vane for dyre, fordi du kan miste en pris, der kunne have været reddet et minut senere.

Hvad det koster at gøre det forkert

Hver fejl har sin egen regning. En overset prisændring er avance, der forsvinder på hver booking, den rører, ofte uset til afstemningen. Booket-men-ikke-udstedt er en kunde, der dukker op i lufthavnen med en udløbet reservation og en trækning på kortet, altså både en chargeback og et omdømmeproblem. Et blindt forsøg igen efter timeout er en dobbeltreservation, og flyselskaber reviderer dubletter; et mønster af dem er netop det, der ender i en ADM.

Intet af det er eksotisk. Det er det upåagtede VVS-arbejde, der adskiller en demo fra noget, du kan lade køre en hel weekend.

Byg afstemningsjobbet, før du får brug for det

Alle tre fejl ender ens: din database og leverantørens er uenige. Skriv derfor jobbet, der sammenligner dem, før den første hændelse, ikke efter. En natlig kørsel er minimum; hvert par minutter for alt i en overgangstilstand er bedre. Det lister bookinger, der sidder fast i holdt, udsteder eller ukendt, spørger leverantøren, hvad den mener, og enten retter posten eller opretter en sag med beviserne vedhæftet.

Gem hver forespørgsel og hvert svar for bookingkald, timeouts medregnet, sammen med den reference, du sendte. Når en kunde bestrider en trækning, er den log dit argument. Den holder også latensdiskussionen ærlig: se hvad du kan og ikke kan rette ved API-latens for hvorfor timeouts er en livsbetingelse og ikke en fejl, der kan udryddes.

Hvis du stadig afgør, hvordan selve leverantørforbindelsen skal kobles op, dækker gennemgangen API-integration til flybooking rækkefølgen af kald, som denne artikel forudsætter. Og vil du tale om, hvordan tilstandene svarer til vores fly- og hotel-API'er, begynder adgang som en samtale: se siden om travel-API'er.

Tekravel Redaktion

Desk for rejseteknologi

Tekravels desk for rejseteknologi skriver til branchen: bureauejere, konsolidatorer og de udviklere, der integrerer dem. Hver artikel kontrolleres mod den platform, den beskriver, inden den udgives.