Обработка на грешки в API на резервации: три провала, които струват пари

Заявката към поддръжката пристига в четвъртък вечер. Клиент е платил, страницата се е въртяла и после е показала обща грешка. Картата е таксувана. В логовете ви има POST към доставчика, който така и не е получил отговор. Държала ли е авиокомпанията място? Никой не може да каже, а клиентът чака. Добрата обработка на грешки в API на резервации е най-вече работа да не попадате никога в такова положение, или поне да знаете точно какво да правите, когато попаднете.
Повечето ръководства за интеграция третират грешките като каталог от статус кодове. При резервациите кодовете са лесната част. Пари струват няколко ситуации, в които заявката изглежда провалена, а светът все пак се е променил, или изглежда успешна, а светът не се е променил. Три от тях са по-важни от останалите.
Провал първи: цената се е преместила между търсенето и резервацията
Резултатите от търсенето са оферта, не договор. Тарифите се кешират, наличността се споделя между всички канали, през които доставчикът продава, а сумата, която сте показали в 14:02, може да е остаряла след няколко минути. Доставчикът ви казва на стъпката за създаване на резервация, понякога с ясен отговор „тарифата се е променила“, понякога като тихо връща друга обща сума в иначе успешен отговор.
Вторият вид е опасният. Ако кодът ви прочете потвърждението, запише резервацията и таксува клиента със сумата, която е видял, разликата излиза от маржа ви или по-късно от ADM. Затова правилото е просто: сравнявайте общата сума, потвърдена от доставчика, с тази, приета от клиента, всеки път, в кода, преди да приберете плащането.
Какво правите при разлика, зависи от размера ѝ и от това кой я понася. Няколко стотинки закръгление между валути са толеранс, който задавате веднъж. Всичко по-голямо се връща на клиента като нова цена с изричен бутон за приемане. Никога не я поемайте автоматично и никога не я таксувайте автоматично.
Провал втори: резервирано, но не издадено
Наличието на PNR не означава наличие на билет. Много потоци първо създават резервацията и издават електронния билет в отделна стъпка, с краен срок между двете. Ако плащането успее, а издаването се провали, държите парите на клиента и резервация, която изтича по собствен часовник.
Провалът рядко е шумен. Извикването за издаване връща грешка или таймаут, а резервацията остава в състояние, което базата ви води като „платена“, докато доставчикът още казва „задържана“. Междувременно крайният срок за издаване тече и за разлика от опашката ви в поддръжката, авиокомпанията не чака.
Третирайте го като отделно състояние, не като вариант на успеха или провала. Резервацията има нужда най-малко от тези: създадена, задържана, плащането е прието, издава се, издадена, провалена и подлежаща на връщане. „Плащането е прието, издава се“ е състоянието, което иска таймер: когато резервация е стояла там твърде дълго, задача трябва да прочете резервацията отново от доставчика и да реши, а не да чака човек да забележи. Решението е евтино, когато знаете срока на доставчика, защото той показва колко дълго можете безопасно да опитвате, преди да трябва да върнете парите.
Провал трети: таймаутът с неизвестен изход
Това е заявката от четвъртък вечер. Вашата заявка е тръгнала, отговор не се е върнал, връзката е умряла или шлюзът се е отказал. Доставчикът може да я е обработил напълно, частично или изобщо.
Изкушението е да опитате пак. Не повтаряйте сляпо извикване за създаване на резервация, защото второто опитване може да роди втора резервация, а дубликатът е реален разход: две задържани места, може би два издадени билета, спор за връщане на сумата по единия.
Безопасният ред е: спрете, прочетете, решете. Спрете потока към клиента с честно състояние „потвърждаваме вашата резервация“. Прочетете страната на доставчика, като потърсите резервацията по референцията, която сте генерирали преди извикването (затова първо създавате собствена клиентска референция и я изпращате, ако доставчикът приема такава). Чак тогава решавате: намерена означава да продължите от истинското състояние; ненамерена след собствения прозорец за обработка на доставчика означава, че е безопасно да опитате веднъж.
Ако доставчикът не позволява търсене по вашата референция, търсете по име на пътник, маршрут и дата в тесен прозорец и третирайте съвпадението като намерено. Грозно, но далеч по-евтино от дубликат.
Таблица за решения, с която може да не сте съгласни
| Какво виждате | Какво знаете | Какво да направите | Какво да не правите |
|---|---|---|---|
| Доставчикът връща „тарифата се е променила“ | Нищо не е резервирано | Покажете новата сума, поискайте приемане, пуснете създаването отново | Да пуснете отново със старата цена и да се надявате |
| Успех, но сумата се различава от приетата от клиента | Има резервация по новата цена | Задръжте плащането, питайте клиента, анулирайте резервацията при отказ | Да приберете старата сума и да поемете разликата |
| Плащането е прието, извикването за издаване дава грешка | Има PNR, състоянието на билета е неизвестно | Прочетете резервацията отново, опитайте издаване в срока, върнете парите след него | Да маркирате резервацията като провалена и да забравите PNR |
| Таймаут при създаване | Изходът е неизвестен | Потърсете по вашата референция, после продължете или опитайте веднъж | Незабавен сляп повторен опит |
| Таймаут при отмяна | Може още да отговаряте за сегмента | Прочетете статуса отново, преди да кажете каквото и да е на клиента | Да покажете „отменена“, защото е станал кликът |
Един ред, който може да оспорите: някои екипи връщат парите при първата грешка при издаване, за да успокоят клиента. Защитимо е за евтини билети и лош навик за скъпи, защото може да загубите тарифа, която е можела да се спаси минута по-късно.
Колко струва да го направите грешно
Всеки провал има своя сметка. Пропуснатата промяна на цената е загубен марж при всяка засегната резервация, често незабелязан до равнението. Резервирано, но неиздадено е клиент, който се появява на летището с изтекла резервация и таксувана карта, тоест и chargeback, и проблем с репутацията наведнъж. Сляпото повторение при таймаут е двойна резервация, а авиокомпаниите одитират дубликатите; модел от тях е точно онова, което свършва в ADM.
Нищо от това не е екзотично. Това е непривлекателната инсталация, която отделя демото от нещо, което можете да оставите да работи през уикенда.
Изградете задачата за равнение, преди да ви потрябва
И трите провала завършват еднакво: вашата база и тази на доставчика не са съгласни. Затова напишете задачата, която ги сравнява, преди първия инцидент, не след него. Нощно пускане е минимумът; на няколко минути за всичко в преходно състояние е по-добре. Тя изброява резервациите, заседнали в задържана, издава се или неизвестна, пита доставчика какво мисли и или поправя записа, или отваря заявка с приложени доказателства.
Пазете всяка заявка и всеки отговор на резервационните извиквания, включително таймаутите, заедно с изпратената референция. Когато клиент оспори такса, този лог е аргументът ви. Той държи честен и разговора за латентността: вижте какво можете и какво не можете да поправите в латентността на API за това защо таймаутите са факт от живота, а не бъг за изкореняване.
Ако още решавате как да свържете самата връзка с доставчика, ръководството интеграция на API за резервация на полети описва реда на извикванията, който тази статия предполага. А ако искате да обсъдим как тези състояния се пренасят върху нашите API за полети и хотели, достъпът започва като разговор: вижте страницата за travel API.