Obrada pogrešaka API-ja za rezervacije: tri propusta koja koštaju novac

Tiket za podršku stiže u četvrtak navečer. Kupac je platio, stranica se vrtjela i zatim pokazala opću pogrešku. Kartica je terećena. Vaši logovi pokazuju POST prema dobavljaču koji nikad nije dobio odgovor. Je li zrakoplovna tvrtka držala mjesto? Nitko ne može reći, a kupac čeka. Dobra obrada pogrešaka API-ja za rezervacije uglavnom je posao da nikad ne dospijete u taj položaj, ili barem da točno znate što činiti kad dospijete.
Većina vodiča za integraciju tretira pogreške kao katalog statusnih kodova. Kod rezervacija kodovi su lakši dio. Novac koštaju malobrojne situacije u kojima zahtjev izgleda kao da nije uspio, a svijet se ipak promijenio, ili izgleda kao da je uspio, a svijet se nije promijenio. Tri od njih važnije su od ostalih.
Propust prvi: cijena se pomaknula između pretrage i rezervacije
Rezultati pretrage su ponuda, a ne ugovor. Tarife se keširaju, zalihe se dijele preko svih kanala kroz koje dobavljač prodaje, a iznos koji ste pokazali u 14:02 može zastarjeti nakon nekoliko minuta. Dobavljač vam to kaže na koraku izrade rezervacije, katkad jasnim odgovorom „tarifa se promijenila“, katkad tako da u inače uspješnom odgovoru tiho vrati drugačiji ukupni iznos.
Druga vrsta je opasna. Ako vaš kod pročita potvrdu, spremi rezervaciju i naplati kupcu iznos koji je vidio, razlika ide iz vaše marže ili kasnije iz ADM-a. Pravilo je zato jednostavno: usporedite ukupni iznos koji dobavljač potvrdi s onim koji je kupac prihvatio, svaki put, u kodu, prije nego što naplatite.
Što radite kad se razlikuju ovisi o veličini razlike i o tome tko je snosi. Nekoliko lipa zaokruživanja između valuta tolerancija je koju postavite jednom. Sve veće vraća se kupcu kao nova cijena s izričitim gumbom za prihvaćanje. Nikad je ne apsorbirajte automatski i nikad je ne naplaćujte automatski.
Propust drugi: rezervirano, ali nije izdano
Postojanje PNR-a nije isto što i postojanje karte. Mnogi tokovi prvo kreiraju rezervaciju, a elektroničku kartu izdaju u zasebnom koraku, s vremenskim ograničenjem između. Ako plaćanje prođe a izdavanje ne uspije, držite novac kupca i rezervaciju koja istječe po vlastitom satu.
Propust rijetko pravi buku. Poziv za izdavanje vraća pogrešku ili timeout, a rezervacija ostaje u stanju koje vaša baza zove „plaćeno“, dok dobavljač još kaže „na čekanju“. U međuvremenu rok za izdavanje teče i, za razliku od vašeg reda u podršci, zrakoplovna tvrtka ne čeka.
Tretirajte to kao zasebno stanje, a ne kao varijantu uspjeha ili neuspjeha. Rezervaciji treba barem ovo: kreirana, na čekanju, plaćanje naplaćeno, izdaje se, izdana, neuspjela i može se vratiti novac. „Plaćanje naplaćeno, izdaje se“ stanje je kojem treba tajmer: kad rezervacija predugo ostane ondje, zadatak treba ponovno pročitati rezervaciju od dobavljača i odlučiti, a ne čekati da čovjek primijeti. Odluka je jeftina kad znate rok dobavljača, jer on kaže koliko dugo možete sigurno ponavljati prije nego što morate vratiti novac.
Propust treći: timeout s nepoznatim ishodom
Ovo je tiket iz četvrtka navečer. Vaš je zahtjev otišao, odgovor se nije vratio, veza je umrla ili je gateway odustao. Dobavljač ga je mogao obraditi u cijelosti, djelomično ili nimalo.
Napast je pokušati ponovno. Nemojte slijepo ponavljati poziv za kreiranje rezervacije, jer drugi pokušaj može stvoriti drugu rezervaciju, a duplikat je stvaran trošak: dva držana mjesta, možda dvije izdane karte, spor oko povrata za jednu.
Siguran redoslijed je: stanite, pročitajte, odlučite. Zaustavite korisnički tok iskrenim stanjem „potvrđujemo vašu rezervaciju“. Pročitajte stranu dobavljača tako da potražite rezervaciju po referenci koju ste generirali prije poziva (zato prvo kreirate vlastitu klijentsku referencu i šaljete je ako je dobavljač prima). Tek onda odlučite: pronađena znači nastavak iz stvarnog stanja; nepronađena nakon dobavljačeva vlastitog prozora obrade znači da je sigurno pokušati jednom.
Ako dobavljač ne dopušta pretragu po vašoj referenci, tražite po imenu putnika, ruti i datumu u uskom prozoru i podudaranje tretirajte kao pronađeno. Ružno, ali mnogo jeftinije od duplikata.
Tablica odluka s kojom se možete ne složiti
| Što vidite | Što znate | Što učiniti | Što ne činiti |
|---|---|---|---|
| Dobavljač vraća „tarifa se promijenila“ | Ništa nije rezervirano | Pokažite novi iznos, zatražite prihvaćanje, ponovno pokrenite kreiranje | Ponovno pokrenuti sa starom cijenom i nadati se |
| Uspjeh, ali iznos se razlikuje od onog koji je kupac prihvatio | Rezervacija postoji po novoj cijeni | Zadržite plaćanje, pitajte kupca, poništite rezervaciju ako odbije | Naplatiti stari iznos i progutati razliku |
| Plaćanje naplaćeno, poziv za izdavanje daje pogrešku | PNR postoji, status karte nepoznat | Ponovno pročitajte rezervaciju, pokušajte izdavanje u roku, nakon roka vratite novac | Označiti rezervaciju kao neuspjelu i zaboraviti PNR |
| Timeout pri kreiranju | Ishod nepoznat | Potražite po svojoj referenci, pa nastavite ili pokušajte jednom | Odmah slijepo ponavljanje |
| Timeout pri otkazivanju | Možda još odgovarate za segment | Ponovno pročitajte status prije nego kupcu kažete išta | Prikazati „otkazano“ jer se dogodio klik |
Jedan redak koji možda osporavate: neki timovi vraćaju novac već pri prvoj pogrešci izdavanja da kupac ostane miran. Obranjivo je za male karte, a loša navika za skupe, jer možete izgubiti tarifu koja se mogla spasiti minutu kasnije.
Koliko košta ako pogriješite
Svaki propust ima svoj račun. Propuštena promjena cijene marža je izgubljena na svakoj zahvaćenoj rezervaciji, često neprimijećena do usklađivanja. Rezervirano-a-ne-izdano kupac je koji stiže na aerodrom s isteklom rezervacijom i teretom na kartici, dakle i chargeback i problem s reputacijom odjednom. Slijepo ponavljanje nakon timeouta dvostruka je rezervacija, a zrakoplovne tvrtke revidiraju duplikate; njihov obrazac upravo je ono što završava u ADM-u.
Ništa od toga nije egzotično. To je nenametljiva instalacija koja razdvaja demo od nečega što možete ostaviti da radi preko vikenda.
Napravite zadatak usklađivanja prije nego vam zatreba
Sva tri propusta završavaju isto: vaša baza i baza dobavljača se ne slažu. Zato napišite zadatak koji ih uspoređuje prije prvog incidenta, ne poslije. Noćno pokretanje je minimum; svakih nekoliko minuta za sve u prijelaznom stanju je bolje. Navodi rezervacije zaglavljene u stanju na čekanju, izdaje se ili nepoznato, pita dobavljača što misli i ili ispravlja zapis ili otvara tiket s priloženim dokazima.
Čuvajte svaki zahtjev i odgovor za pozive rezervacija, uključujući timeoute, zajedno s referencom koju ste poslali. Kad kupac ospori naplatu, taj je log vaš argument. Drži i razgovor o latenciji poštenim: pogledajte što možete, a što ne možete popraviti kod latencije API-ja za razlog zašto su timeouti činjenica života, a ne bug za iskorjenjivanje.
Ako još odlučujete kako povezati samu vezu s dobavljačem, vodič integracija API-ja za rezervaciju letova pokriva redoslijed poziva koji ovaj članak pretpostavlja. A ako želite razgovarati o tome kako se ta stanja preslikavaju na naše API-je za letove i hotele, pristup počinje kao razgovor: pogledajte stranicu o travel API-jima.