Обработка ошибок API движка бронирования: три сбоя, которые стоят денег

Тикет в поддержку приходит в четверг вечером. Клиент заплатил, страница покрутилась и показала общую ошибку. Деньги с карты списаны. В ваших логах есть POST к поставщику, на который ответа так и не было. Удержала ли авиакомпания место? Никто не знает, а клиент ждёт. Хорошая обработка ошибок API движка бронирования — это в основном работа над тем, чтобы вообще не оказываться в такой ситуации, или хотя бы точно знать, что делать, когда оказался.
Большинство руководств по интеграции подают ошибки как каталог кодов статуса. В бронировании коды — лёгкая часть. Деньги теряются в нескольких ситуациях, когда запрос выглядит провалившимся, а мир всё равно изменился, или выглядит успешным, а ничего не произошло. Три из них важнее остальных.
Сбой первый: цена сдвинулась между поиском и бронированием
Результат поиска — это котировка, а не договор. Тарифы кешируются, наличие делится между всеми каналами продаж поставщика, и цифра, показанная несколько минут назад, уже может устареть. Поставщик сообщает об этом на шаге создания брони: иногда прямым ответом «тариф изменился», иногда молча возвращая другую сумму внутри внешне успешного ответа.
Опасен второй вариант. Если ваш код читает подтверждение, сохраняет бронь и списывает с клиента ту сумму, которую он видел, разница уходит из вашей маржи или позже из ADM. Правило простое: сравнивайте сумму, подтверждённую поставщиком, с суммой, которую принял клиент, каждый раз, в коде, до списания платежа.
Что делать при расхождении, зависит от его размера и от того, кто его несёт. Копейки округления между валютами — допуск, который задаётся один раз. Всё, что больше, возвращается клиенту с новой ценой и явной кнопкой согласия. Не поглощайте разницу автоматически и не списывайте её автоматически.
Сбой второй: забронировано, но не выписано
Наличие PNR не означает наличия билета. Многие сценарии сначала создают бронь, а электронный билет выписывают отдельным шагом, между которыми действует лимит времени. Если оплата прошла, а выписка упала, у вас остаются деньги клиента и бронь, которая истечёт по собственным часам.
Этот сбой редко бывает громким. Вызов выписки возвращает ошибку или таймаут, и бронь висит в состоянии, которое ваша база называет «оплачено», тогда как поставщик всё ещё говорит «удержано». Тем временем лимит на выписку тикает, и в отличие от вашей очереди поддержки авиакомпания не ждёт.
Относитесь к этому как к отдельному состоянию, а не к разновидности успеха или провала. У брони должны быть как минимум такие состояния: создана, удержана, платёж списан, выписывается, выписана, не удалась и подлежит возврату. Состояние «платёж списан, выписывается» требует таймера: если бронь задержалась там слишком долго, задача должна заново прочитать бронь у поставщика и принять решение, а не ждать, пока кто-то заметит. Решение недорого, когда вы знаете лимит поставщика: он говорит, сколько можно безопасно повторять до возврата денег.
Сбой третий: таймаут с неизвестным исходом
Это тот самый тикет четверга. Запрос ушёл; ответ не вернулся; соединение оборвалось или шлюз сдался. Поставщик мог обработать запрос полностью, частично или совсем нет.
Соблазн — повторить. Не повторяйте вызов создания брони вслепую: вторая попытка может породить вторую бронь, а дубликат стоит реальных денег: два удержанных места, возможно два выписанных билета, спор о возврате по одному из них.
Безопасный порядок: остановиться, прочитать, решить. Остановите клиентский сценарий честным состоянием вроде «подтверждаем ваше бронирование». Прочитайте сторону поставщика, найдя бронь по ссылке, которую вы сгенерировали до вызова (поэтому сначала создают собственный клиентский идентификатор и передают его, если поставщик его принимает). Только потом решайте: найдена — продолжайте с реального состояния; не найдена после окна обработки у поставщика — один повтор безопасен.
Если поставщик не даёт искать по вашей ссылке, ищите по фамилии пассажира, маршруту и дате в узком окне и считайте совпадение найденной бронью. Некрасиво, но гораздо дешевле дубликата.
Таблица решений, с которой можно спорить
| Что вы видите | Что вы знаете | Что делать | Чего не делать |
|---|---|---|---|
| Поставщик отвечает «тариф изменился» | Ничего не забронировано | Показать новую сумму, получить согласие, повторить создание | Слать с прежней ценой в надежде, что пройдёт |
| Успех, но сумма отличается от принятой клиентом | Бронь существует по новой цене | Придержать платёж, спросить клиента, аннулировать бронь при отказе | Списать старую сумму и покрыть разницу |
| Платёж списан, выписка падает | PNR есть, статус билета неизвестен | Перечитать бронь, повторить выписку в пределах лимита, после него вернуть деньги | Пометить бронь неудачной и забыть про PNR |
| Таймаут при создании | Исход неизвестен | Найти по вашей ссылке, затем продолжить или повторить один раз | Немедленный слепой повтор |
| Таймаут при отмене | Вы можете по-прежнему отвечать за сегмент | Перечитать статус, прежде чем что-либо говорить клиенту | Показать «отменено», потому что кнопку нажали |
Строка, которую можно оспорить: некоторые команды возвращают деньги при первой же ошибке выписки, чтобы успокоить клиента. Для дешёвых билетов это оправданно, для дорогих — плохая привычка: можно потерять тариф, который минутой позже удалось бы спасти.
Во сколько обходится ошибка
У каждого сбоя свой счёт. Пропущенное изменение цены — потерянная маржа в каждой затронутой брони, часто заметная лишь при сверке. Случай «забронировано, не выписано» — клиент, который приезжает в аэропорт с истёкшей бронью и списанием на карте: чарджбэк и репутационная проблема сразу. Слепой повтор после таймаута — дубль брони, а авиакомпании проверяют дубли; их систематичность заканчивается ADM.
Ничего экзотического тут нет. Это непрезентабельная сантехника, которая отличает демо от системы, которую можно оставить работать на все выходные.
Постройте задачу сверки раньше, чем она понадобится
Все три сбоя заканчиваются одинаково: ваша база и база поставщика расходятся. Поэтому напишите задачу, которая их сравнивает, до первого инцидента, а не после. Ночной запуск — минимум; для всего, что в переходном состоянии, лучше каждые несколько минут. Она перечисляет брони, застрявшие в «удержана», «выписывается» или «неизвестно», спрашивает поставщика и либо чинит запись, либо заводит тикет с приложенными доказательствами.
Храните каждый запрос и ответ вызовов бронирования, включая таймауты, вместе с отправленной ссылкой. Когда клиент оспаривает списание, этот лог — ваш аргумент. Он же держит честным разговор о задержках: прочитайте что можно и нельзя исправить в задержке API, чтобы понять, почему таймауты — факт жизни, а не баг, который можно истребить.
Если вы ещё решаете, как подключать самого поставщика, порядок вызовов, который подразумевает эта статья, разобран в руководстве интеграция API бронирования авиабилетов. А чтобы обсудить, как эти состояния ложатся на наши API авиабилетов и отелей: доступ начинается с разговора, смотрите страницу travel API.