Spracovanie chýb API rezervačného systému: tri zlyhania, ktoré stoja peniaze

Tiket od podpory príde vo štvrtok večer. Zákazník zaplatil, stránka sa točila a potom ukázala všeobecnú chybu. Karta bola zaťažená. Vaše logy ukazujú POST na dodávateľa, ktorý nikdy nedostal odpoveď. Držala letecká spoločnosť miesto? Nikto vám to nevie povedať a zákazník čaká. Dobré spracovanie chýb API rezervačného systému je väčšinou práca na tom, aby ste sa do takej situácie nikdy nedostali, alebo aspoň presne vedeli, čo robiť, keď sa tam ocitnete.
Väčšina integračných príručiek berie chyby ako katalóg stavových kódov. V rezervácii sú kódy tá ľahká časť. Peniaze stoja malé množstvo situácií, v ktorých požiadavka vyzerá, že zlyhala, no svet sa napriek tomu zmenil, alebo vyzerá, že prebehla, a svet sa nezmenil. Tri z nich sú dôležitejšie než zvyšok.
Prvé zlyhanie: cena sa pohla medzi vyhľadaním a rezerváciou
Výsledky vyhľadávania sú ponuka, nie zmluva. Tarify sa cachujú, inventár zdieľajú všetky kanály, cez ktoré dodávateľ predáva, a číslo, ktoré ste ukázali o 14:02, môže byť o pár minút zastarané. Dodávateľ vám to oznámi v kroku vytvorenia rezervácie, niekedy čistou odpoveďou „tarifa sa zmenila“, niekedy tak, že v inak úspešnej odpovedi potichu vráti inú celkovú sumu.
Druhá varianta je nebezpečná. Ak váš kód prečíta potvrdenie, uloží rezerváciu a účtuje zákazníkovi sumu, ktorú videl, rozdiel ide z vašej marže, alebo neskôr z ADM. Pravidlo je preto jednoduché: porovnajte celkovú sumu potvrdenú dodávateľom so sumou, ktorú zákazník prijal, vždy, v kóde, pred zaúčtovaním platby.
Čo robiť pri rozdiele, závisí od veľkosti medzery a od toho, kto ju nesie. Pár centov zaokrúhlenia medzi menami je tolerancia, ktorú nastavíte raz. Čokoľvek väčšie ide späť zákazníkovi ako nová cena s výslovným tlačidlom na súhlas. Nikdy ju automaticky nepohlcujte a nikdy ju automaticky nezaťažujte.
Druhé zlyhanie: rezervované, ale nevystavené
Existencia PNR nie je to isté ako existencia letenky. Mnohé toky najprv vytvoria rezerváciu a e-letenku vystavia ako samostatný krok s časovým limitom medzi nimi. Ak platba prejde a vystavenie zlyhá, držíte peniaze zákazníka a rezerváciu, ktorá vyprší vo vlastnom čase.
Zlyhanie je zriedka hlučné. Volanie na vystavenie vráti chybu alebo timeout a rezervácia zostane v stave, ktorý vaša databáza označuje ako „zaplatená“, zatiaľ čo dodávateľ stále hovorí „držaná“. Medzitým beží limit na vystavenie letenky a na rozdiel od vašej fronty podpory letecká spoločnosť nečaká.
Ošetrite to ako samostatný stav, nie ako variant úspechu či zlyhania. Rezervácia potrebuje aspoň tieto stavy: vytvorená, držaná, platba zaúčtovaná, vystavuje sa, vystavená, zlyhala-s-nárokom-na-vrátenie. Stav „platba zaúčtovaná, vystavuje sa“ potrebuje časovač: keď tam rezervácia sedí príliš dlho, úloha má znovu načítať rezerváciu od dodávateľa a rozhodnúť, nie čakať, kým si niekto všimne. Rozhodnutie je lacné, ak poznáte dodávateľov časový limit, lebo vám povie, ako dlho môžete bezpečne opakovať, kým musíte vrátiť peniaze.
Tretie zlyhanie: timeout s neznámym výsledkom
Toto je štvrtkový tiket. Vaša požiadavka odišla, odpoveď neprišla, spojenie spadlo alebo brána to vzdala. Dodávateľ ju mohol spracovať úplne, čiastočne alebo vôbec.
Pokušenie je zopakovať. Nikdy neopakujte volanie na vytvorenie rezervácie naslepo, pretože druhý pokus môže vytvoriť druhú rezerváciu a duplikát je skutočný náklad: dve držané miesta, možno dve vystavené letenky a spor o vrátenie peňazí pri jednej z nich.
Bezpečné poradie je: zastaviť, prečítať, rozhodnúť. Zastavte tok pre zákazníka poctivým stavom „potvrdzujeme vašu rezerváciu“. Prečítajte stranu dodávateľa vyhľadaním rezervácie podľa referencie, ktorú ste vygenerovali pred volaním (preto si najprv vytvárate vlastnú klientsku referenciu a posielate ju, ak ju dodávateľ prijíma). Až potom rozhodnite: nájdená znamená pokračovať zo skutočného stavu; nenájdená po dodávateľovom vlastnom spracovateľskom okne znamená, že je bezpečné zopakovať raz.
Ak vám dodávateľ nedá možnosť vyhľadať podľa vašej referencie, hľadajte podľa mena cestujúceho, trasy a dátumu v úzkom okne a zhodu berte ako nájdenú. Škaredé, ale oveľa lacnejšie než duplikát.
Rozhodovacia tabuľka, s ktorou môžete nesúhlasiť
| Čo vidíte | Čo viete | Čo robiť | Čo nerobiť |
|---|---|---|---|
| Dodávateľ vráti „tarifa sa zmenila“ | Nič nebolo rezervované | Ukázať novú sumu, vypýtať súhlas, znova spustiť vytvorenie | Spustiť znova so starou cenou a dúfať |
| Úspech, ale suma sa líši od prijatej | Rezervácia existuje za novú cenu | Zadržať platbu, opýtať sa zákazníka, anulovať rezerváciu pri odmietnutí | Zaúčtovať starú sumu a rozdiel zniesť |
| Platba zaúčtovaná, vystavenie končí chybou | PNR existuje, stav letenky neznámy | Znova načítať rezerváciu, zopakovať vystavenie v rámci limitu, po ňom vrátiť peniaze | Označiť rezerváciu ako zlyhanú a zabudnúť na PNR |
| Timeout pri vytvorení | Výsledok neznámy | Vyhľadať podľa vašej referencie, potom pokračovať alebo raz zopakovať | Okamžité slepé opakovanie |
| Timeout pri zrušení | Za segment môžete stále ručiť | Znova načítať stav, až potom niečo povedať zákazníkovi | Ukázať „zrušené“, lebo sa kliklo |
Jeden riadok sa dá spochybniť: niektoré tímy vrátia peniaze pri prvej chybe vystavenia, aby zákazníka upokojili. Pri lacných letenkách je to obhájiteľné, pri drahých zlozvyk, lebo môžete prísť o tarifu, ktorú ste o minútu neskôr mohli zachrániť.
Koľko vás stojí, keď to pokazíte
Každé zlyhanie má inú účtenku. Prehliadnutá zmena ceny je strata marže pri každej rezervácii, ktorej sa týka, často nepovšimnutá až do odsúhlasenia. Rezervované-nevystavené je zákazník, ktorý príde na letisko s rezerváciou, ktorá vypršala, a so stiahnutými peniazmi z karty, čo je chargeback aj problém s reputáciou naraz. Slepé opakovanie pri timeoute je duplicitná rezervácia a letecké spoločnosti duplikáty kontrolujú; vzorec takých prípadov je presne to, čo skončí v ADM.
Nič z toho nie je exotické. Je to nezáživná inštalatérska práca, ktorá oddeľuje ukážku od niečoho, čo môžete nechať bežať cez víkend.
Zosúlaďovaciu úlohu postavte skôr, než ju potrebujete
Všetky tri zlyhania skončia rovnako: vaša databáza a dodávateľova sa nezhodujú. Napíšte teda úlohu, ktorá ich porovnáva, pred prvým incidentom, nie po ňom. Nočný beh je minimum; pre všetko v prechodnom stave je lepšie každých pár minút. Vypíše rezervácie uviaznuté v stave držaná, vystavuje sa alebo neznáma, opýta sa dodávateľa, čo si myslí, a buď opraví záznam, alebo vytvorí tiket s priloženým dôkazom.
Uchovávajte každú požiadavku a odpoveď pri rezervačných volaniach, vrátane timeoutov, s referenciou, ktorú ste poslali. Keď zákazník spochybní platbu, tento log je váš argument. Zároveň udržiava poctivú debatu o latencii: pozrite si čo môžete a nemôžete zmeniť na latencii API, prečo sú timeouty fakt života, nie chyba na odstránenie.
Ak ešte rozhodujete, ako zapojiť samotné spojenie s dodávateľom, postup v integrácii API na rezerváciu letov pokrýva poradie volaní, ktoré tento článok predpokladá. A ak chcete prebrať, ako sa tieto stavy premietnu do našich API pre lety a hotely, prístup sa začína rozhovorom: pozrite si stránku travel API.