本文へスキップ
ブログ

ホテル予約APIプロバイダーは、フロントデスクで見極める

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

サービス公開後に最初に届くサポート問い合わせは、検索についてであることはまれです。夜の十一時、スマートフォンに確認番号を表示した宿泊客がフロントに立ち、受付の担当者がその番号を二度入力して、この名前での予約はありませんと告げる。宿泊客は支払い済みです。御社のシステムは予約確定と表示しています。どちらも事実であり、そこが問題なのです。

この問い合わせこそが、ホテル予約APIプロバイダーを選ぶという仕事の本質です。多くのチームは、デモで見える部分で選びます。ある都市で何軒の施設が返るか、在庫照会のエンドポイントがどれだけ整っているか、SDKで最初の結果までどれだけ早く届くか。どれも大事です。ただ、どこもほぼ同じで、フロントで何が起きるかを決めるものはひとつもありません。

カバレッジが最初の問いにならない理由

ホテルがより多く返る検索は、より良いAPIに感じられます。けれども、表示できる施設と、ホテルが受け入れる予約は別々の約束であり、プロバイダー内の別々の部門が果たしています。前者はコンテンツフィードから、後者は契約、ホテル自身のシステムとの接続、そして土曜日にも人が座っているサポートデスクから生まれます。

そもそも何社のプロバイダーをつなぐかを検討中なら、その問いだけを扱った記事が別にあり、そこで述べるマッピングの問題は現実のものです。本稿は、プロバイダーを選ぶ段階にいる前提で、宿泊客が支払いを終えたあとの予約レスポンスにどれだけの価値があるかを問います。

決済後に表面化するホテル予約APIプロバイダーの五つの性質

プロバイダーのドキュメントから、お金が動いたあとにサイトが保存するレスポンスだけを取り出してみてください。検索エンドポイントが同じ二社が、実は別の製品だとわかる行です。

性質良い答えの姿欠けたときの代償
キャンセル条件構造化されていること:期限、違約金、そして期限が従うタイムゾーン誰かが読まねばならない自由記述と、推測で決まる返金
誰が代金を受け取るか料金ごとに明示:御社への事前払いか現地払いか、販売主体(merchant of record)は誰か御社とチェックアウト時の二度、請求される宿泊客
ホテル自身の確認番号レスポンスに含まれる、または文書化された経路であとから届くプロバイダーの参照番号だけで、フロントでは何の意味もない
在庫照会から予約までの価格変動新しい価格を明示するか、はっきり拒否する。黙って差を出さない表示料金と予約料金の差額が御社のマージンから出ていく
到着時に予約記録がない場合名前のついた手順と、営業時間外にも応答する連絡先宿泊客がロビーで待つ間、ホテルに電話をかけ続ける御社スタッフ

順番には異論があってよいでしょう。ただ、カードを受け付けるサイトを出すなら、五行すべてに答えが必要です。

キャンセルはデータであるか、さもなくば負債である

最初の行をよく見てください。最も静かに失敗する項目です。多くのレスポンスはキャンセルポリシーを一文で持っています。ある日付まで無料、以降は一泊分を請求、というように。人間には十分読めます。ところがコードは、文を解析しなければ動けず、解析こそが本番に間違いを持ち込む経路です。

痛い目を見るのはタイムゾーンです。「深夜0時」という期限は、ホテルのある都市では一つの瞬間、御社のサーバーでは別の瞬間、宿泊客のスマートフォンではさらに別の瞬間です。プロバイダーがどれかを示さなければ、いつかサイトは宿泊客に「まだ無料でキャンセルできます」と案内し、返金し、そのうえでホテルが違約金を請求していたことを知ります。エラーは一行も出ていません。お金だけが出ていきました。

返金不可の料金にも同じ厳しさが必要です。料金名だけでなく専用のフィールドで明確に示すプロバイダーは、それを売るサイトのことを考えています。契約前に、両方の種類を実際のレスポンスで見せてもらってください。

宿泊客のカード明細に載るのは誰の名前か

二行目は経理の話に聞こえますが、実はカスタマーサービスの問題です。事前払いの料金なら、宿泊客は御社に支払い、御社またはプロバイダーがホテルに支払い、ホテルはミニバーやフロントで徴収する宿泊税のような付帯費用以外を宿泊客に請求しないはずです。現地払いの料金なら、サイトは客室代金をまったく受け取らず、宿泊客のカードには施設が、多くはチェックインかチェックアウト時に請求します。

どちらの方式も成り立ちます。成り立たないのは、二つを見分けられない決済画面です。プロバイダーが両方の料金を同じ形で返し、支払いモデルが説明文の中に埋もれていれば、サイトはいずれ、ホテルがもう一度請求する客室代金を宿泊客に請求することになります。宿泊客は明細に二行を見て、最初に載っている名前、つまり御社に電話をかけます。

求める答えは、料金ごとに、フィールドで、しかも販売主体(merchant of record)が誰かまで含みます。最後の点が、カードにどの名称が載るか、チャージバックを誰が処理するかを決めます。

署名の前に書面で聞くべきこと

デモは順調な経路しか見せません。書面の回答は、プロバイダーがそれ以外の経路を経験してきたかを示します。次を送り、返答を保管してください。

  • 返金不可料金のレスポンスと、無料キャンセル期限つき料金のレスポンスを一つずつ見せてください。
  • その期限はどのタイムゾーンで表され、レスポンスのどこに書かれていますか。
  • ホテル自身の確認番号はいつ届き、予約呼び出しのあとに来る場合はどう受け取りますか。
  • 現地払い料金で、宿泊客はカード上で正確に何が、誰から、いつ請求されるのを目にしますか。
  • 宿泊客が到着してホテルに記録がないとき、宿泊客や私たちは誰に、何時に電話をかけますか。

最後の質問に手順で答えるプロバイダーは、すでに経験があります。機能名で答えるところはそうではありません。航空側も同じで、APIの裏側に何があるかはAPI自体より大事です。

選び間違いの代償

失敗は一つひとつは小さく、繰り返されます。期限を誤ったタイムゾーンで読んだために、御社のマージンから出ていく返金。現地払い料金が決済画面で事前払いに見えたために二重請求された宿泊客。ホテルが認識できる番号をプロバイダーが返さないため、毎週のはじめにホテルへ電話して手作業で予約を再確認するスタッフ。どれもカバレッジの数字には現れませんが、実トラフィックが入って最初の一か月以内に、すべてサポートの受信箱に現れます。

避けるための作業は午後ひと仕事です。上の表を脇に置いて、予約レスポンスを五件読んでください。

私たちの立ち位置

Tekravelはホテルと航空のAPIを提供しています。利用はセルフサービスのキーではなく相談から始まり、サービスはテナントごとに有効化され、サプライヤーのコンテンツは一対一の契約ではなくサプライヤーグループを通じてテナントに届きます。このページでは施設数を公開していません。数字を鵜呑みにするより、上の五つの質問を私たちにぶつけていただくほうがよいと考えています。その段階にいらっしゃるなら、APIのページから相談が始まります。

Tekravel 編集部

旅行テクノロジー担当

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