旅行API
航空券・ホテル・レンタカー・決済の旅行API連携
GDS、ベッドバンク、レンタカー、ツアー、決済のAPIを一つのPHPレイヤーで旅行ポータルに接続。すべてのサプライヤーが同じ検索・料金確認・予約・返金フローに従い、ログとリトライも共通化されます。
- XMLとJSONのサプライヤー
- 検索・料金・予約・返金
- 決済とWebhook
- 一つの旅行APIハブ
API連携サービス
PHPでの旅行API連携、サンドボックスから本番まで
旅行APIは、ホテル、航空券、レンタカー、アクティビティ、パッケージの検索、料金計算、予約、予約後の操作を提供し、通常はキー、OAuth、サプライヤートークンを使うXMLまたはJSON形式です。PHPTRAVELSは各サプライヤーをポータル内の同じ正規化フローに接続し、マークアップ、決済、エージェントルール、リクエストログを備えるため、新しいAPIは個別プロジェクトではなく設定済みの供給元になります。
- サプライヤーのサンドボックス、認証情報、在庫範囲、テストカードを設定
- 共通フロー上で検索、料金確認、予約、発券または確定を構築
- マークアップ、手数料、法人規定、エージェントの与信枠を追加
- リクエストID、予約ログ、エラー一覧、アラートを追加
- 認証試験に合格し、本番の認証情報へ切り替え
- サプライヤー
- Hotelbeds · JSON
- 環境
- サンドボックス
- エンドポイント
- sandbox.supplier-api.com/v1
- APIキー
- ••••••••••••7c21
- マークアップ
- ネット料金に8%
統合された結果
異なるAPIの航空券、ホテル、レンタカーを一つのリストに
各サプライヤーは独自のXMLやJSONを返します。PHPTRAVELSは客室、運賃、規則、料金を正規化し、マークアップを適用して、予約前に各結果へステータスを表示します。
- ラホール発ドバイ行き · 直行便エコノミー · GDS運賃 · 受託手荷物1個$175
- ドバイ・マリーナのホテル · 3泊ダブルルーム · 朝食付き · ベッドバンク料金$486
- コンパクトカー · ドバイ空港3日間 · 走行距離無制限 · レンタカーAPI$132
主要な操作をすべて
検索、料金確認、予約、発券、キャンセル、返金を、すべてのサプライヤーで同じ方法で接続します。
正規化されたコンテンツ
客室タイプ、料金プラン、運賃規則、税金、キャンセル期限をキャッシュ前に一つのモデルへマッピング。
XMLとJSON
サプライヤーが対応していればJSON REST、GDSやベッドバンクが求める場合はサプライヤーのXSD付きXML。
安全な予約リトライ
予約時のべき等キー、バックオフ付きリトライ、サプライヤー障害時のサーキットブレーカー。
決済API
3-DS対応カード、サプライヤー向けバーチャルカード、エージェント向けウォレットを各予約に紐付け。
予約後の対応
変更、キャンセル、返金、再発券、スケジュール変更を管理画面で処理し、確定時にバウチャーを発行。
連携フロー
旅行APIがサンドボックスから実予約に至るまで
各サプライヤーは同じ段階を経るため、顧客がコンテンツを目にする前にフロー、ログ、決済が整います。
接続
サンドボックスへのアクセス、認証、テストデータ、動作する基本検索。
構築
共通の予約フロー上で料金確認、予約、発券または確定。
決済
決済承認、売上確定、返金のWebhookを予約IDに紐付け。
強化
リクエストID、ログ、エラー処理、リトライ、サプライヤー障害のアラート。
認証
合意したテストケースと予約シナリオでサプライヤー認証を実施。
本番稼働
本番の認証情報、監視、運用手順書、チームへの引き継ぎ。
旅行APIハブ
契約するすべてのサプライヤーを一つのハブに
サプライヤーは認証、ログ、リトライ、監視を共有する一つのレイヤーに接続されます。利用可否は契約内容とパートナーの承認によります。
GDSと航空券API
XMLでAmadeus、Sabre、Travelport、さらにDuffel、Kiwi、TBOなどのJSON航空券API。
ホテル、レンタカー、ツアー
Hotelbeds、Agoda、Hotelstonなどのベッドバンク、レンタカーはCarTrawler、アクティビティはViatorとTiqets。
決済ゲートウェイ
Stripe、PayPal、銀行APIで売上確定、返金、予約との照合を行います。
バックオフィス
すべてのAPIを一つの管理画面で運用
各サプライヤーの料金、権限、決済、記録が同じ管理画面にあるため、APIを追加してもバックオフィスは増えません。
サプライヤー認証情報
サプライヤーごとのサンドボックスと本番のキーを自社サーバーに保管し、環境ごとに切り替え。
マークアップと手数料
サプライヤー、商品、目的地、チャネル、エージェントグループ別の定額または率のルール。
エージェントの与信とウォレット
B2Bエージェントは、御社の料金と権限のもとで与信枠やウォレット残高で予約します。
決済の照合
決済IDをPNRと予約IDに紐付け、返金と一部売上確定を自動化。
リクエストログ
すべてのリクエストとレスポンスをIDとともに保存し、サポートやサプライヤーとの紛争対応に活用。
サプライヤー別レポート
サプライヤー別・チャネル別の検索、予約、失敗、キャンセル、利益。
比較
サプライヤーごとの個別開発とPHPTRAVELSのAPIハブ
サプライヤーが一社なら個別のコーディングでも対応できます。複数になると、共通フローが新しい接続のたびに時間を節約します。
| 項目 | APIごとの個別開発 | PHPTRAVELS |
|---|---|---|
| 予約フロー | APIごとの個別開発サプライヤーごとに書き直し | PHPTRAVELS全サプライヤー共通の検索・料金・予約・返金フロー |
| コンテンツのマッピング | APIごとの個別開発客室や運賃の形式がサプライヤーごとに異なる | PHPTRAVELS表示前に一つのモデルへ正規化 |
| リトライとログ | APIごとの個別開発最初の障害後に追加されることが多い | PHPTRAVELS初日からリクエストID、リトライ、べき等な予約 |
| 決済 | APIごとの個別開発ゲートウェイやフローごとに個別連携 | PHPTRAVELS返金Webhook付きで決済を予約に紐付け |
| サプライヤーあたりの期間 | APIごとの個別開発社内の経験により異なる | PHPTRAVELS通常、認証を含めて2〜4週間 |
活用例
旅行会社、OTA、TMC向けの旅行API連携
旅行会社向けAPI
リテールフロー、バウチャー、マークアップ、手数料、基本的なエージェント与信、シンプルな注文管理。
OTA向けAPI
キャッシュを使った大量検索、予約前の再確認、非同期キュー、レート制限への対応。
TMC向けAPI
法人プロフィール、出張規定、承認、与信枠、契約料金、レポート。
PHPTRAVELSを選ぶ理由
自社で所有し、拡張できるAPI連携
ソースコード付き
商用ライセンスでセルフホスト。開発者がすべてのコネクタを読み、拡張できます。
PHPで構築
cURLやGuzzleのクライアントとWebhookハンドラーを使う標準的なPHPで、チームがすでに扱えます。
PCI範囲の縮小
トークン化とホスト型決済フィールドにより、カード情報がサーバーを通りません。
B2C、B2B、法人
一つの連携で公開サイト、エージェントポータル、法人予約者に対応します。
旅行サイトやエージェントポータルをサプライヤーのAPIに接続し、ホテル、航空券、レンタカー、アクティビティを自社プラットフォーム内で検索、料金確認、予約、管理できるようにすることです。多くの旅行APIはサプライヤー認証付きのHTTP上でXMLまたはJSONを使います。
通常、サプライヤー1社あたり2〜4週間で、サンドボックス設定、主要な予約フロー、決済、認証、本番切り替えを含みます。範囲やサプライヤーの認証スケジュールにより変わることがあります。
JSONは開発も解析も速いため、サプライヤーが同じ機能を提供していればJSONを優先します。一部のGDSやベッドバンクはXSD付きのXMLを必要としますが、どちらもポータル内で同じモデルに正規化されます。
複数のサプライヤーを、認証、ログ、リトライ、監視を共有する一つのレイヤーで接続する仕組みです。新しいサプライヤーはゼロから作らず同じフローを再利用します。
カードを3-DSでトークン化し、発券またはバウチャー発行後に売上確定し、各決済IDをPNRや予約IDに紐付けます。これにより返金と照合をWebhookで処理できます。
GDS、ベッドバンク、レンタカー、アクティビティ、決済APIなど幅広く対応します。利用可否は契約内容とパートナーの承認によるため、ご利用のサプライヤーをお知らせいただければ範囲と期間を確認します。