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

Тикет за подршку стиже у четвртак увече. Купац је платио, страница се вртела, а затим показала општу грешку. Картица је задужена. Ваши логови показују POST ка добављачу који никада није добио одговор. Да ли је авио-компанија држала место? Нико не може да каже, а купац чека. Добра обрада грешака API-ја за резервације је углавном посао да никада не доспете у тај положај, или бар да тачно знате шта да радите када доспете.
Већина водича за интеграцију третира грешке као каталог статусних кодова. Код резервација су кодови лакши део. Новац коштају мали скуп ситуација у којима захтев изгледа као да није успео, а свет се ипак променио, или изгледа као да је успео, а свет се није променио. Три од њих су важније од осталих.
Пропуст први: цена се померила између претраге и резервације
Резултати претраге су понуда, не уговор. Тарифе се кеширају, залихе се деле преко свих канала кроз које добављач продаје, а износ који сте показали у 14:02 може бити застарео након неколико минута. Добављач вам то каже на кораку креирања резервације, понекад јасним одговором „тарифа се променила“, понекад тако што тихо врати другачији укупан износ у иначе успешном одговору.
Друга врста је опасна. Ако ваш код прочита потврду, сачува резервацију и наплати купцу износ који је видео, разлика иде из ваше марже или касније из ADM-а. Правило је зато просто: упоредите укупан износ који добављач потврди са оним који је купац прихватио, сваки пут, у коду, пре него што наплатите.
Шта радите кад се разликују зависи од величине разлике и од тога ко је сноси. Неколико пара заокруживања између валута је толеранција коју подесите једном. Све веће враћа се купцу као нова цена са изричитим дугметом за прихватање. Никада је не апсорбујте аутоматски и никада је не наплаћујте аутоматски.
Пропуст други: резервисано, али не издато
Постојање PNR-а није исто што и постојање карте. Многи токови прво креирају резервацију, а електронску карту издају у засебном кораку, са временским ограничењем између. Ако плаћање прође а издавање не успе, држите новац купца и резервацију која истиче по сопственом сату.
Пропуст ретко прави буку. Позив за издавање враћа грешку или timeout, а резервација остаје у стању које ваша база зове „плаћено“, док добављач и даље каже „на чекању“. У међувремену рок за издавање тече и, за разлику од вашег реда у подршци, авио-компанија не чека.
Третирајте то као посебно стање, а не као варијанту успеха или неуспеха. Резервацији треба бар ово: креирана, на чекању, плаћање наплаћено, издаје се, издата, неуспела и може да се врати новац. „Плаћање наплаћено, издаје се“ је стање коме треба тајмер: када резервација предуго остане ту, задатак треба поново да прочита резервацију од добављача и одлучи, а не да чека да човек примети. Одлука је јефтина када знате рок добављача, јер он говори колико дуго можете безбедно да понављате пре него што морате да вратите новац.
Пропуст трећи: timeout са непознатим исходом
Ово је тикет из четвртка увече. Ваш захтев је отишао, одговор се није вратио, веза је умрла или је гејтвеј одустао. Добављач га је могао обрадити у потпуности, делимично или нимало.
Искушење је да покушате поново. Немојте слепо понављати позив за креирање резервације, јер други покушај може да направи другу резервацију, а дупликат је стваран трошак: два држана места, можда две издате карте, спор око повраћаја за једну.
Безбедан редослед је: станите, прочитајте, одлучите. Зауставите кориснички ток искреним стањем „потврђујемо вашу резервацију“. Прочитајте страну добављача тако што ћете потражити резервацију по референци коју сте генерисали пре позива (зато прво креирате сопствену клијентску референцу и шаљете је ако је добављач прима). Тек онда одлучите: пронађена значи наставак из стварног стања; непронађена након сопственог прозора обраде добављача значи да је безбедно покушати једном.
Ако добављач не дозвољава претрагу по вашој референци, тражите по имену путника, рути и датуму у уском прозору и поклапање третирајте као пронађено. Ружно, али много јефтиније од дупликата.
Табела одлука са којом можете да се не сложите
| Шта видите | Шта знате | Шта да урадите | Шта да не радите |
|---|---|---|---|
| Добављач враћа „тарифа се променила“ | Ништа није резервисано | Покажите нови износ, затражите прихватање, поново покрените креирање | Поново покренути са старом ценом и надати се |
| Успех, али износ се разликује од оног који је купац прихватио | Резервација постоји по новој цени | Задржите плаћање, питајте купца, поништите резервацију ако одбије | Наплатити стари износ и прогутати разлику |
| Плаћање наплаћено, позив за издавање даје грешку | PNR постоји, статус карте непознат | Поново прочитајте резервацију, покушајте издавање у року, после рока вратите новац | Означити резервацију као неуспелу и заборавити PNR |
| Timeout при креирању | Исход непознат | Потражите по вашој референци, па наставите или покушајте једном | Одмах слепо понављање |
| Timeout при отказивању | Можда још одговарате за сегмент | Поново прочитајте статус пре него што купцу кажете било шта | Приказати „отказано“ јер се десио клик |
Један ред који можда оспоравате: неки тимови враћају новац при првој грешци издавања да би купац остао миран. Одбрањиво је за мале карте, а лоша навика за скупе, јер можете изгубити тарифу која се могла спасити минут касније.
Колико кошта ако погрешите
Сваки пропуст има свој рачун. Пропуштена промена цене је маржа изгубљена на свакој захваћеној резервацији, често непримећена до усклађивања. Резервисано-а-не-издато је купац који стиже на аеродром са истеклом резервацијом и наплатом на картици, дакле и chargeback и проблем са репутацијом одједном. Слепо понављање после timeout-а је двострука резервација, а авио-компаније ревидирају дупликате; њихов образац је управо оно што завршава у ADM-у.
Ништа од овога није егзотично. То је неупадљива инсталација која раздваја демо од нечега што можете оставити да ради преко викенда.
Направите задатак усклађивања пре него што вам затреба
Сва три пропуста завршавају исто: ваша база и база добављача се не слажу. Зато напишите задатак који их упоређује пре првог инцидента, не после. Ноћно покретање је минимум; на неколико минута за све у прелазном стању је боље. Он наводи резервације заглављене у стању на чекању, издаје се или непознато, пита добављача шта мисли и или поправља запис или отвара тикет са приложеним доказима.
Чувајте сваки захтев и одговор за позиве резервација, укључујући timeout-е, заједно са референцом коју сте послали. Када купац оспори наплату, тај лог је ваш аргумент. Он држи и разговор о латенцији поштеним: погледајте шта можете а шта не можете да поправите код латенције API-ја за разлог зашто су timeout-и чињеница живота, а не баг за искорењивање.
Ако још одлучујете како да повежете саму везу са добављачем, водич интеграција API-ја за резервацију летова покрива редослед позива који овај чланак претпоставља. А ако желите да разговарамо о томе како се ова стања пресликавају на наше API-је за летове и хотеле, приступ почиње као разговор: погледајте страницу о travel API-јима.