Hopp til innholdet
Blogg

Feilhåndtering i bookingmotorens API: tre feil som koster penger

Tekravel Redaksjon
Skrevet med hjelp av AI

Supportsaken kommer en torsdagskveld. En kunde har betalt, siden snurret og viste så en generell feil. Kortet er belastet. Loggene dine viser et POST til leverandøren som aldri fikk svar. Holdt flyselskapet en plass? Ingen kan si det, og kunden venter. God feilhåndtering i bookingmotorens API handler mest om aldri å havne i den situasjonen, eller i det minste om å vite nøyaktig hva man gjør når man gjør det.

De fleste integrasjonsguider behandler feil som en katalog over statuskoder. I booking er kodene den enkle delen. Det som koster penger, er en liten håndfull situasjoner der kallet ser ut til å ha feilet, men verden likevel har endret seg, eller ser ut til å ha lyktes uten at verden har endret seg. Tre av dem betyr mer enn resten.

Feil én: prisen flyttet seg mellom søk og booking

Søkeresultater er et tilbud, ikke en kontrakt. Priser mellomlagres, beholdningen deles på tvers av alle kanalene leverandøren selger gjennom, og tallet du viste kl. 14.02, kan være utdatert noen minutter senere. Leverandøren sier fra i steget som oppretter bookingen, noen ganger med et tydelig svar om at prisen er endret, andre ganger ved stille å returnere en annen totalpris i et ellers vellykket svar.

Den andre varianten er den farlige. Hvis koden din leser bekreftelsen, lagrer bookingen og trekker kunden for beløpet vedkommende så, tas differansen fra marginen din eller senere fra en ADM. Regelen er derfor enkel: sammenlign totalen leverandøren bekrefter med totalen kunden godtok, hver gang, i kode, før du hever betalingen.

Hva du gjør når de avviker, avhenger av størrelsen på gapet og av hvem som bærer det. Noen øre i avrunding mellom valutaer er en toleranse du setter én gang. Alt større går tilbake til kunden som en ny pris med en tydelig godta-knapp. Absorbér den aldri automatisk, og trekk den aldri automatisk.

Feil to: booket, men ikke utstedt

At en PNR finnes, er ikke det samme som at en billett finnes. Mange flyter oppretter reservasjonen først og utsteder e-billetten i et eget steg, med en tidsfrist imellom. Lykkes betalingen og feiler utstedelsen, sitter du med en kundes penger og en reservasjon som utløper på sin egen klokke.

Feilen er sjelden høylytt. Utstedelseskallet returnerer en feil eller en timeout, og bookingen blir stående i en tilstand databasen din kaller «betalt», mens leverandøren fortsatt sier «holdt». I mellomtiden løper fristen for utstedelse, og i motsetning til supportkøen din venter ikke flyselskapet.

Håndter det som sin egen tilstand, ikke som en variant av suksess eller fiasko. En booking trenger minst disse: opprettet, holdt, betaling hevet, utsteder, utstedt, feilet-og-kan-refunderes. «Betaling hevet, utsteder» er tilstanden som trenger en timer: når en booking har stått der for lenge, skal en jobb lese reservasjonen på nytt fra leverandøren og avgjøre, ikke vente på at et menneske legger merke til det. Avgjørelsen er billig når du kjenner leverandørens tidsfrist, for den forteller hvor lenge du trygt kan prøve igjen før du må refundere.

Feil tre: timeouten med ukjent utfall

Dette er torsdagskveldens sak. Forespørselen din gikk av gårde, ingen respons kom tilbake, forbindelsen døde eller gatewayen ga opp. Leverandøren kan ha behandlet den helt, delvis eller ikke i det hele tatt.

Fristelsen er å prøve på nytt. Ikke gjenta et opprett-booking-kall blindt, for andre forsøk kan gi en andre reservasjon, og en duplikat er en reell kostnad: to seter holdt, kanskje to utstedte billetter, en refusjonsstrid om den ene.

Den trygge rekkefølgen er: stopp, les, avgjør. Stopp kundeflyten med en ærlig tilstand, «vi bekrefter bookingen din». Les leverandørens side ved å slå opp bookingen med referansen du genererte før kallet (derfor oppretter du din egen klientreferanse først og sender den med, hvis leverandøren godtar en). Først deretter avgjør du: funnet betyr at du fortsetter fra den faktiske tilstanden; ikke funnet etter leverandørens eget behandlingsvindu betyr at det er trygt å prøve én gang til.

Hvis leverandøren ikke lar deg slå opp på referansen din, søk på passasjernavn, rute og dato innenfor et smalt vindu og behandle en treff som funnet. Stygt, men langt billigere enn en duplikat.

En beslutningstabell du gjerne kan være uenig i

Hva du serHva du vetHva du skal gjøreHva du ikke skal gjøre
Leverandøren svarer at prisen er endretIngenting ble booketVis ny total, be om godkjenning, kjør opprettelsen på nyttKjøre på nytt med gammel pris og håpe
Suksess, men totalen avviker fra den kunden godtokDet finnes en booking til ny prisHold betalingen, spør kunden, kanseller bookingen hvis kunden avslårHeve det gamle beløpet og ete differansen
Betaling hevet, utstedelseskallet gir feilDet finnes en PNR, billettstatus ukjentLes reservasjonen på nytt, prøv utstedelse igjen innen fristen, refunder etter denMerke bookingen som feilet og glemme PNR-en
Timeout ved opprettelseUtfallet er ukjentSlå opp på din referanse, deretter fortsett eller prøv én gang tilUmiddelbart blindt nytt forsøk
Timeout ved kanselleringDu kan fortsatt hefte for segmentetLes status på nytt før du sier noe til kundenVise «kansellert» fordi klikket skjedde

En rad du kanskje vil bestride: noen team refunderer ved den første utstedelsesfeilen for å holde kunden rolig. Det kan forsvares for små billetter og er en dårlig vane for dyre, fordi du kan miste en pris som kunne vært reddet et minutt senere.

Hva det koster å gjøre det feil

Hver feil har sin egen regning. En oversett prisendring er margin som forsvinner på hver booking den berører, ofte uoppdaget til avstemmingen. Booket-men-ikke-utstedt er en kunde som dukker opp på flyplassen med en utløpt reservasjon og en trekk på kortet, altså både en chargeback og et omdømmeproblem. Et blindt nytt forsøk etter timeout er en dobbeltreservasjon, og flyselskaper reviderer duplikater; et mønster av dem er akkurat det som ender i en ADM.

Ingenting av dette er eksotisk. Det er det upåaktede rørleggerarbeidet som skiller en demo fra noe du kan la gå over en helg.

Bygg avstemmingsjobben før du trenger den

Alle tre feilene ender likt: databasen din og leverandørens er uenige. Skriv derfor jobben som sammenligner dem før den første hendelsen, ikke etter. En nattlig kjøring er minimum; hvert par minutter for alt i en overgangstilstand er bedre. Den lister bookinger som sitter fast i holdt, utsteder eller ukjent, spør leverandøren hva den mener, og enten retter posten eller oppretter en sak med bevisene vedlagt.

Lagre hver forespørsel og hvert svar for bookingkall, timeouts inkludert, sammen med referansen du sendte. Når en kunde bestrider en belastning, er den loggen argumentet ditt. Den holder også latensdiskusjonen ærlig: se hva du kan og ikke kan fikse ved API-latens for hvorfor timeouts er en livsbetingelse og ikke en feil som kan utryddes.

Hvis du fortsatt avgjør hvordan selve leverandørforbindelsen skal kobles opp, dekker gjennomgangen API-integrasjon for flybestilling rekkefølgen på kallene som denne artikkelen forutsetter. Og vil du snakke om hvordan tilstandene svarer til fly- og hotell-API-ene våre, begynner tilgang som en samtale: se siden om travel-API-er.

Tekravel Redaksjon

Desk for reiseteknologi

Tekravels desk for reiseteknologi skriver for bransjen: byråeiere, konsolidatorer og utviklerne som integrerer dem. Hver artikkel kontrolleres mot plattformen den beskriver før den publiseres.