コンテンツにスキップ
リソース

開発者はどのようにしてホテル予約を製品に追加するのか?

Section titled “開発者はどのようにしてホテル予約を製品に追加するのか?”

検索と料金は簡単な部分です。製品が役立つのは、実際に予約を作成し、支払いを受け取り、旅行者とホテルに予約が成立したことを伝えられるときです。

多くのAPIはホテルコンテンツを返しますが、取引を完了できるものはずっと少ないです。

簡単な答え

必要なのは4つです:リアルタイムの料金と空室状況、予約作成、支払い、そして確認とウェブフック。読み取り専用のコンテンツAPIは最初のものまでしか対応しません。WinkではConsumerとBooking Engine APIは無料で使え、予約作成はOAuth2認証のRESTで行い、booking.createを含む70のウェブフックイベントがあり、支払いはホテルのために回収されます(ホテルがマーチャント・オブ・レコードのままなので、あなたがそれになる必要はありません)。MCPサーバーはAIエージェント向けに同じ機能を提供し、ウェブコンポーネントはUIを構築せずに予約経路を提供したい場合に対応します。

機能意味これがないと製品が停滞する理由
リアルタイムの料金と空室状況日付範囲ごとの現在の価格と実際に予約可能な状況キャッシュされた料金は確認時に失敗し信頼を損なう
予約作成ホテルが受け取る実際の予約を作成することこれがないと紹介リンクに過ぎず製品とは言えない
支払い予約の一部として料金を受け取ること他サイトへの引き渡しはコンバージョンが死ぬポイント
確認とウェブフックゲスト、ホテル、システムに予約成立を伝えることそうでなければサポート負荷や照合のギャップが生じる

開発者が見つける多くの「ホテルAPI」は最初の機能、時には2つ目までをカバーしています。取引処理は難しい部分であり、製品かどうかを決める部分です。

この問いは以降のすべてを決定します。チェーンを通じて再販される供給は料金にマークアップが含まれ、空室状況は古く、予約に関するホテルへの問い合わせルートがありません。ホテル直送の供給はホテル自身の料金、リアルタイムの空室状況、そして予約が存在することをホテルが認識しています。

旅行者がホテルの公式サイトと比較するような場合(ほとんどがそうです)、ホテル管理の供給は価格が悪いという気まずい瞬間を避けられます。

マーチャント・オブ・レコードは誰か

Section titled “マーチャント・オブ・レコードは誰か”

ホテル予約を自分で構築する場合、マーチャント・オブ・レコードになることは支払い責任、チャージバック、返金、税務処理、そして多くの場合は各市場での旅行代理店ライセンスの取得を意味します。

Winkではホテルがマーチャント・オブ・レコードのままで支払いはホテルのために回収されるため、統合者がその責任を負う必要はありません。マーチャント・オブ・レコードの契約は、パートナーが実際に支払いを受け取る必要があるAPI統合で利用可能で、その場合は独自のライセンス要件があります。

  1. ウェブコンポーネント。 既存ページに予約可能な検索、部屋リスト、チェックアウトを埋め込む。バックエンド作業不要で、レイアウトの自由度は最小。
  2. REST API。 検索、料金、予約作成、確認を完全に制御。OAuth2認証。予約フローが製品の体験の一部である場合に使用。
  3. MCPサーバー。 AIエージェント向けに同じ機能を提供し、アシスタントがユーザーをウェブサイトに誘導せずに予約を完了できる。

これらは排他的ではなく、製品はマーケティング用にコンポーネントを使い、コアフローにAPIを使うことが一般的です。

  • 1都市・1日付範囲の検索と価格取得。 何か設計する前に実際の料金を流す。
  • 1件のテスト予約を支払い・確認まで含めて作成。
  • UI構築前にbooking.createとキャンセルイベントを購読。
  • アトリビューションモデルを早めに決定。 ソースコンテキストは予約に引き継がれないと後でレポートが推測になる。
  • 失敗ケースの処理。 見積もりと予約の間に空室がなくなる、支払い拒否、部分返金など。

ConsumerとBooking Engine APIは無料です。Partner APIは月10,000泊の無料枠があり、その後は単位ごとに課金されます。確定予約にはホテルの1.5%のプラットフォーム手数料とカード処理費用がかかり、10%のデフォルトコミッションが適用されます。これは製品が予約を促進した場合に適用され、統合者が支払うのではなく稼ぐ仕組みです。

無料枠は統合者単位です。複数アカウントを開設して回避する行為は不正利用とみなされ、即時かつ永久に禁止されます。Partner APIの利用と制限を参照してください。

  • キャッシュされた料金で構築すること。 開発時は問題なく見えても本番で失敗する。
  • 支払いをリダイレクトに任せること。 どの引き渡しも予約を失う。
  • ローンチまでウェブフックを無視すること。 照合が手作業になる。
  • 必要なくマーチャント・オブ・レコードになること。 技術的な問題だけでなく、ライセンスと責任の問題。
  • ソースコンテキストを渡さないこと。 アトリビューションは後から再構築できない。

さらに探る

ホテル予約APIよくある質問

統合内容、費用、支払い責任者について。

ホテル予約APIは何をサポートする必要がありますか?
リアルタイムの料金と空室状況、予約作成、支払い、ウェブフック付きの確認。読み取り専用のコンテンツAPIは最初の機能のみで取引を完了できません。
Wink APIは無料で使えますか?
ConsumerとBooking Engine APIは無料です。Partner APIは月10,000泊の無料枠があり、その後は単位ごとに課金されます。
マーチャント・オブ・レコードになる必要がありますか?
いいえ。ホテルがマーチャント・オブ・レコードのままで支払いはホテルのために回収されます。支払いを実際に受け取る必要があるAPI統合には独自のライセンス要件を伴うマーチャント・オブ・レコード契約があります。
AIエージェントも同じ機能で予約できますか?
はい。MCPサーバーは検索、価格設定、予約をエージェントに提供し、アシスタントがユーザーをウェブサイトに誘導せずに予約を完了できます。
統合者としてどのように収益を得ますか?
製品が予約を促進した場合、ホテルのプラットフォーム手数料とカード処理費用の後に10%のデフォルトコミッションが適用され、クリックごとに6ヶ月間アトリビューションが持続します。
UIを構築する必要がありますか?
必ずしもそうではありません。ウェブコンポーネントは既存ページに予約可能な検索、部屋リスト、チェックアウトを埋め込めます。予約フローを自社体験にしたい場合はREST APIを使います。

実際に予約できる製品を作ろう。

Section titled “実際に予約できる製品を作ろう。”

リアルタイムのホテル供給、RESTによる予約作成、ウェブフック、エージェント向けMCPサーバー、そしてあなたが所有しなくてよい支払い。