航空券API連携
旅行会社のためのKiwi API連携
Tequila APIを通じて、Kiwi.comの航空券コンテンツをPHPTRAVELSの予約サイトに取り込みます。Kiwi.comが旅程を返して予約を受け付け、PHPTRAVELSが検索、決済、マークアップ、代理店管理画面を担います。
- 航空券カテゴリのKiwiモジュール
- 片道・往復・周遊
- Kiwi.comの全運賃にマークアップ
- docs.phptravels.comの設定ガイド
仕組み
自社の予約プラットフォームでKiwi.comの航空券を販売
Kiwi API連携は2つの要素をつなぎます。お客様が使う予約サイトと、その航空券検索結果を供給するKiwi.comのTequilaアカウントです。PHPTRAVELSには航空券カテゴリにKiwiモジュールがあります。管理画面でAffilIDとAPIキーを入力すると、モジュールがTequilaで認証情報を確認し、検索結果にマークアップ込みのKiwi.comの旅程が表示されるようになります。Tequilaへのアクセス権はKiwi.comが付与するため、公開を計画する前にアカウントを確認してください。
- Kiwi.comにTequila APIのアクセスを申請し、AffilIDとAPIキーを受け取る
- PHPTRAVELS管理画面の「モジュール」を開き、Kiwi設定に両方の認証情報を入力する
- 保存して認証チェックを実行する（Tequila APIへの実際の空港検索）
- マークアップを設定し、大人・小児・幼児の運賃を確認する
- 全顧客にKiwi.comの運賃を公開する前に、少数の実予約で動作を確認する
- 環境
- 本番環境のみ
- AffilID
- youragency_affil
- エンドポイント
- Tequila API v2 · api.tequila.kiwi.com
- APIキー
- ••••••••••••••••
- マークアップ
- Kiwi.com運賃に6%
検索と予約
検索結果にKiwi.comの旅程、管理画面に予約
Kiwi.comの各結果には、航空会社、発着時刻、クラス、手荷物の上限に加え、その旅程を予約するために決済画面が使う予約トークンが含まれます。
- Direct07:15 BCN → 08:40 STN直行便 · エコノミー · 機内持ち込み10kg$64合計
- 1 stop10:05 BCN → 14:30 LHR経由1回 · エコノミー · 受託手荷物20kg$118合計
- 18:50 BCN → 20:10 LGW直行便 · エコノミー · 受託手荷物15kg$92合計
片道・往復検索
出発地、目的地、日付、旅客、クラス、通貨がTequilaの検索エンドポイントに送られ、該当するKiwi.comの旅程が検索結果に戻ります。
周遊旅程
周遊リクエストは区間ごとにKiwi.comで個別に検索され、結果が1つの旅程セットにまとめられます。
搭乗クラス
エコノミー、プレミアムエコノミー、ビジネス、ファーストがKiwi.comのクラスコードに対応します。
結果に手荷物上限を表示
Kiwi.comの受託手荷物と機内持ち込みの重量が各運賃に表示され、同じ条件で比較できます。
マークアップと旅客別料金
Kiwi.comの価格にマークアップが加算され、大人・小児・幼児の料金が仕入れ値と並べて保存されます。
トークンで予約
確定時に、モジュールが予約トークンと旅客情報をTequilaの予約エンドポイントに送信します。
予約フロー
Kiwi.comの検索から予約確定まで
Kiwi.comの運賃1件がサイト内をたどる流れ。お客様の支払い後に起きることも含みます。
検索
お客様の旅程、旅客、クラスをKiwi.comに送り、候補が返ります。
価格
マークアップを適用し、お客様が選んだ通貨で運賃を表示します。
決済
旅客ごとに氏名、敬称、国籍、メール、電話番号を入力します。
予約
予約トークンと旅客リストをKiwi.comに送り、予約を作成します。
予約後
取消と返金はAPIではなくKiwi.comサポートに依頼します。
役割分担
Kiwi API連携での役割分担
Kiwi.comとの接続を運用するには、予約プラットフォーム、承認済みのTequilaアカウント、代理店のアフターサービス体制が必要です。
PHPTRAVELS：予約プラットフォーム
サイト、Kiwiモジュール設定、マークアップ、決済、予約管理。B2CとB2Bのその他のツールはご契約パッケージによります。
Kiwi.com：航空券コンテンツ
Tequila API経由の旅程、価格、予約。アクセス権、路線、予約後のルールはKiwi.comと航空会社が定めます。
貴社：商取引の運用
販売価格、顧客の支払い、サポート。旅行者が取消や変更を求めたときに誰がKiwi.comに連絡するかも含みます。
接続できる航空券サプライヤー：
Seeru
Amadeus
Duffel
Google Flights
Kayak
Kiwi
Mystifly
PKfare
Sabre
TBO Holidays
Travelport
バックオフィス
Kiwi.comの航空券販売を管理画面で運用
Kiwi.com予約の認証情報、価格、アフターサービスのルールを、他の旅行事業と同じダッシュボードで管理します。
モジュール設定
AffilIDとAPIキーを「モジュール」に保存。キーの未入力、無効、利用上限超過を即時チェックで知らせます。
マークアップと仕入れ値
各予約にマークアップ後の販売価格とKiwi.comの価格を並べて保存し、予約ごとの利益が見えます。
通貨
検索はお客様の通貨で価格を取得し、同じ通貨を予約データと一緒に保存します。
取消リクエスト
Kiwi.comはAPIでの取消に対応していないため、管理画面が該当予約に印を付け、担当者がKiwi.comサポートに依頼します。
B2CとB2Bチャネル
Kiwi.comの運賃を一般サイト、代理店、または両方に出すかを決め、チャネルごとに価格を確認します。
追加ワークフロー
追加手荷物、座席指定など、モジュール外の手順は連携カスタマイズとして見積もれます。
比較
Kiwi.com APIで自社開発する場合とPHPTRAVELS
Kiwi.comが提供するのは航空券APIで、その周りの予約製品は別に必要です。自社開発で一般的に必要になる作業とPHPTRAVELSを比べました。
| 項目 | Tequilaで自社開発 | PHPTRAVELS |
|---|---|---|
| 顧客向けサイト | Tequilaで自社開発検索、結果、決済をゼロから設計・開発 | PHPTRAVELS自社ブランドの航空券検索、結果、決済が用意済み |
| Kiwi.com接続 | Tequilaで自社開発検索、周遊、予約の呼び出しを社内で実装・テスト | PHPTRAVELS認証チェックとマークアップ付きの既存Kiwiモジュール |
| 管理と利益 | Tequilaで自社開発予約管理画面と価格ルールはこれから開発 | PHPTRAVELS予約、仕入れ値、販売価格を1つのダッシュボードで |
| 代理店チャネル | Tequilaで自社開発B2Bポータルは別プロジェクト | PHPTRAVELSパッケージに応じてB2BとB2Cのツールを搭載 |
| 他のサプライヤー | Tequilaで自社開発新しい航空券ソースや商品ごとに追加開発 | PHPTRAVELS同じインストールで航空券、ホテル、ツアー、レンタカーの他モジュール |
活用例
Kiwi.comをPHPTRAVELSに接続するのは
新規のオンライン旅行会社
Kiwi.comの旅程を最初のコンテンツ源として航空券予約サイトを立ち上げ、後からサプライヤーを追加できます。
格安・レジャー系の旅行会社
各運賃に手荷物上限を明示して、近距離やレジャー路線を自社パッケージと並べて販売できます。
B2B代理店ネットワーク
パッケージの範囲で、提携代理店ごとのアクセス権と価格ルールでKiwi.comの運賃を提供できます。
PHPTRAVELSを選ぶ理由
Kiwi.comアカウントも、プラットフォームも、コードも貴社のもの
ソースコード付属
商用ライセンスでのセルフホスト。開発者がKiwi.comのフローを拡張できます。
貴社のTequila認証情報
AffilIDとAPIキーは貴社が保有し、自社のインストールに保存されます。
設定手順を文書化
docs.phptravels.comの航空券セクションにKiwiモジュールのガイドがあります。
B2CとB2B
一般向けサイトと代理店ポータルを1つのインストールで、24言語に対応。
航空券カテゴリのKiwiモジュールを通じて、Kiwi.com Tequila APIをPHPTRAVELSの予約プラットフォームに接続するものです。Kiwi.comが旅程を提供して予約を受け付け、PHPTRAVELSが顧客向けサイト、マークアップ、代理店管理を提供します。
Tequilaへのアクセス権はKiwi.comが付与します。承認後にAffilIDとAPIキーを受け取り、Kiwiモジュールの設定に入力します。利用資格や商取引の条件はKiwi.comに直接ご確認ください。
このモジュールはKiwi.comの本番APIのみに接続し、サンプルのキーは受け付けません。お客様に公開する前に、少数の実予約で確認するか、Kiwi.comの運賃をスタッフアカウントに限定して検証してください。
はい。片道と往復は1回の検索で、周遊は区間ごとにKiwi.comで個別に検索して結果をまとめます。
いいえ。モジュールが使うKiwi.comのAPIは取消や返金に対応していません。担当者がKiwi.comサポートに依頼し、可否はKiwi.comと航空会社の規定によります。
完全に同等とは考えないでください。追加手荷物、座席指定などのサービスは、ご利用のPHPTRAVELSのバージョンとKiwi.comアカウントで確認が必要で、カスタマイズとして追加できます。