本文へスキップ
ブログ

予約エンジンAPIのエラー処理:お金を失う3つの障害

Tekravel 編集部
AI の支援を受けて執筆

木曜の夜にサポートチケットが届きます。顧客は支払いを済ませ、画面は回り続け、その後に汎用的なエラーが表示されました。カードには請求が立っています。ログには、応答が返らなかったサプライヤーへのPOSTが残っています。航空会社は座席を確保したのか。誰にも答えられず、顧客は待っています。優れた予約エンジン API エラー処理とは、ほとんどの場合、そもそもこの立場に立たないための仕事であり、立ってしまったときに何をすべきかを正確に知っておくための仕事です。

多くの連携ガイドはエラーをステータスコードの一覧として扱います。予約の世界では、コードは簡単な部分です。お金がかかるのは、リクエストは失敗したように見えるのに現実は変わっていた、あるいは成功したように見えるのに現実は変わっていない、という少数の状況です。そのうち3つが他より重要です。

障害その1:検索から予約までの間に価格が動いた

検索結果は見積もりであり、契約ではありません。運賃はキャッシュされ、在庫はサプライヤーが販売するすべてのチャネルで共有され、14時02分に表示した数字は数分後には古くなっているかもしれません。サプライヤーは予約作成の段階で知らせてきます。明確な「fare changed」の応答のこともあれば、一見成功に見える応答の中で静かに別の合計金額を返すこともあります。

危険なのは後者です。コードが確認を読み取り、予約を保存し、顧客が見た金額をそのまま請求すると、差額は自社のマージンから、あるいは後日ADMとして出ていきます。ルールは単純です。サプライヤーが確認した合計と顧客が承諾した合計を、毎回、コードの中で、決済をキャプチャする前に比較します。

差が出たときの対応は、差の大きさと誰が負担するかで決まります。通貨間の数セントの端数処理は、一度決めておく許容値です。それより大きければ、明示的な承諾ボタンつきの新価格として顧客に戻します。自動で吸収してはならず、自動で追加請求してもいけません。

障害その2:予約はできたが発券されていない

PNRがあることと、チケットがあることは同じではありません。多くのフローは先に予約を作り、eチケットの発行を別のステップとして行い、その間に時間制限があります。支払いが成功して発券が失敗すると、顧客のお金と、独自の時計で失効していく予約を抱えることになります。

この障害が大きな音を立てることはまれです。発券の呼び出しはエラーかタイムアウトを返し、予約はデータベース上「paid」と記録されたまま、サプライヤー側は「held」のままです。その間にも発券期限は進んでいきますし、自社のサポートキューと違って、航空会社は待ってくれません。

成功や失敗の変種としてではなく、独立した状態として扱ってください。予約には少なくとも次の状態が必要です。created、held、payment captured、issuing、ticketed、failed-and-refundable。「payment captured, issuing」はタイマーが必要な状態で、予約がそこに長く留まったら、人が気づくのを待たず、ジョブがサプライヤーから予約を読み直して判断します。サプライヤーの期限がわかっていれば判断は安く済みます。返金に踏み切るまで安全に何度リトライできるかがわかるからです。

障害その3:結果が不明なタイムアウト

これが木曜夜のチケットです。リクエストは出ていき、応答は戻らず、接続が切れるかゲートウェイが諦めました。サプライヤーは完全に、部分的に、あるいはまったく処理していないかもしれません。

誘惑はリトライです。予約作成の呼び出しを盲目的にリトライしてはいけません。2回目が2つ目の予約を生み、重複は現実のコストになるからです。座席が2つ押さえられ、場合によっては2枚発券され、その片方で返金の争いになります。

安全な順序は、止める、読む、判断する、です。顧客側のフローは「ご予約を確認しています」という正直な状態で止めます。サプライヤー側は、呼び出し前に自分で生成した参照番号で予約を検索して読みます(だからこそ先に自社のクライアント参照を作り、サプライヤーが受け付けるなら一緒に送るのです)。判断はその後です。見つかれば実際の状態から続行し、サプライヤー自身の処理時間枠を過ぎても見つからなければ、一度だけリトライして安全です。

サプライヤーが自社参照での検索手段を提供しない場合は、狭い時間枠で搭乗者名、区間、日付を使って検索し、一致を見つかったものとして扱います。見栄えは悪くても、重複よりはずっと安上がりです。

反論してかまわない判断表

見えるものわかっていることすることしてはいけないこと
サプライヤーが「fare changed」を返す何も予約されていない新しい合計を見せ、承諾を得て、createを再実行古い価格で再実行して通るのを祈る
成功だが合計が顧客の承諾額と違う新価格で予約が存在する決済を保留し、顧客に確認し、断られたら予約をvoid古い金額をキャプチャして差額を被る
決済キャプチャ済みで発券呼び出しがエラーPNRはあるが発券状態は不明予約を読み直し、期限内にissueをリトライし、期限後に返金予約を失敗扱いにしてPNRを忘れる
createでタイムアウト結果は不明自社参照で検索し、続行するか一度だけリトライ即座の盲目的リトライ
cancelでタイムアウト区間の責任がまだ残っている可能性顧客に何か伝える前に状態を読み直すボタンが押されたからといって「cancelled」と表示

異論の出そうな行が一つあります。顧客をなだめるため、最初の発券エラーで返金するチームもあります。安いチケットなら擁護できますが、高額なチケットでは悪い習慣です。1分後には救えた運賃を失うことがあるからです。

間違えるといくらかかるか

障害ごとに請求書は違います。見逃した価格変更は、影響を受けるすべての予約でマージンを失い、突合まで気づかれないことも多くあります。予約済み未発券は、失効した予約とカードへの請求を抱えて空港に着く顧客であり、チャージバックと評判の問題が同時に起きます。タイムアウト時の盲目的リトライは重複予約で、航空会社は重複を監査します。そうしたケースが続けば、ADMにつながる類のものです。

どれも特殊な話ではありません。デモと、週末を通して放置できるものを分ける、地味な配管の仕事です。

必要になる前に突合ジョブを作る

3つの障害はどれも同じ結末に行き着きます。自社のデータベースとサプライヤーのデータベースが食い違うことです。だから最初のインシデントの前に、両者を比較するジョブを書いておきます。夜間実行は最低限で、遷移中の状態にあるものは数分おきのほうが望ましいです。held、issuing、unknownで止まっている予約を列挙し、サプライヤーに問い合わせ、レコードを修復するか、証拠を添えたチケットを起票します。

予約に関する呼び出しは、タイムアウトも含めて、送った参照番号とともにすべてのリクエストとレスポンスを保存してください。顧客が請求に異議を唱えたとき、そのログが自社の主張になります。レイテンシの議論を正直に保つ助けにもなります。タイムアウトが排除すべきバグではなく避けられない現実である理由は、APIレイテンシについて直せることと直せないことをご覧ください。

サプライヤー接続そのものをどう組むか検討中なら、航空券予約APIの連携のウォークスルーが、この記事が前提とする呼び出し順序を扱っています。これらの状態を当社のフライトおよびホテルAPIにどう対応させるか相談したい場合、アクセスは会話から始まります:旅行APIのページをご覧ください。

Tekravel 編集部

旅行テクノロジー担当

Tekravelの旅行テクノロジー担当は、業界の読者に向けて書いています。旅行会社の経営者、ホールセラー、そして両者をつなぐ開発者です。すべての記事は、公開前に記事が扱うプラットフォーム上で確認されます。