フライト API 連携
旅行会社と OTA のためのPKFARE API 連携
PKFARE のフライトコンテンツを自社の予約サイトとエージェントポータルで販売できます。PKFARE が運賃を提供して注文を作成し、PHPTRAVELS が検索、チェックアウト、マークアップ、決済、PNR 記録、アフターサービスを一つの管理画面で担います。
- 片道、往復、周遊
- すべての運賃に払い戻し条件と手荷物
- 決済後に注文と PNR
- docs.phptravels.com の設定ガイド
仕組み
自社の予約エンジンで PKFARE のフライトを販売
PKFARE API 連携は、顧客やエージェントが使う予約サイトと、フライト結果を提供する PKFARE アカウントをつなぎます。PHPTRAVELS はフライトカテゴリに PKFARE モジュールを備えています。partner ID と API key を入力すると、各リクエストがそれらで署名され、検索ではマークアップと通貨を適用した PKFARE の運賃が返ります。決済が確認されると予約が PKFARE に送信され、注文番号と PNR が予約に保存されます。アクセス権と商取引条件は PKFARE が決めるため、公開を計画する前にアカウントを確認してください。
- PKFARE とアクセス範囲を取り決め、partner ID と API key を受け取る
- PHPTRAVELS 管理画面のモジュールを開き、PKFARE 設定に両方を入力する
- マークアップと通貨を設定し、大人・小児・幼児の料金を確認する
- 少数の実予約で検索、決済、PNR、キャンセルをテストする
- PKFARE の運賃を B2C サイト、エージェント、またはその両方に公開する
- 環境
- 本番環境
- Partner ID
- youragency_partner
- エンドポイント
- api.pkfare.com · 検索と予約
- API key
- ••••••••••••••••
- マークアップ
- B2C 7% · エージェント 4%
検索と運賃
規則・手荷物・旅客ごとの料金を備えた PKFARE 運賃
PKFARE の各結果には、旅行者が支払い前に比較する情報が表示されます。フライト時刻、経由、客室クラス、受託手荷物と機内持ち込み、払い戻し条件、そして販売価格です。
- Direct08:05 HKG → 11:55 SIN直行 · エコノミー · 受託 30 kg · 機内 7 kg$412合計
- 1 stop13:20 HKG → 21:45 SINKUL 経由 1 回 · エコノミー · 受託 20 kg$338合計
- 19:40 HKG → 23:30 SIN直行 · ビジネス · 受託 40 kg$1,184合計
片道と往復の検索
出発地、目的地、日付、旅客、客室クラス、通貨を PKFARE の検索 API に送り、該当する運賃を結果に表示します。
周遊を 1 回のリクエストで
PKFARE は複数の区間を一度に受け付けるため、周遊旅程は 1 回の呼び出しで検索され、一つの旅程として運賃が算出されます。
4 つの客室クラス
エコノミー、プレミアムエコノミー、ビジネス、ファーストを PKFARE が求める値に対応付けます。
結果に手荷物を表示
PKFARE の受託手荷物と機内持ち込みの許容量を各運賃に表示し、同じ条件で比較できます。
支払い前に払い戻し可否を表示
PKFARE の運賃規則に基づき各結果を払い戻し可または手数料ありと表示し、チェックアウト前に確認できます。
旅客ごとのマークアップと通貨
大人・小児・幼児の運賃と税金にそれぞれマークアップを適用し、顧客の通貨に個別に換算します。
予約の流れ
PKFARE の検索から PNR 付きの注文まで
PKFARE の運賃がサイト内をたどる流れ。顧客の支払い後に起きることも含みます。
検索
旅程、旅客、客室クラスを PKFARE に送り、運賃を受け取ります。
価格設定
旅客区分ごとにマークアップと通貨を適用します。
チェックアウト
旅行者の氏名、パスポート情報、連絡先を入力します。
決済
顧客は決済ゲートウェイで支払い、エージェントはウォレットから支払います。
予約
決済後に予約を PKFARE に送信し、注文番号と PNR を保存します。
キャンセル
管理画面から注文番号で PKFARE にキャンセルを送信します。PKFARE の規則に従います。
役割分担
PKFARE API 連携で誰が何を担うか
PKFARE との接続を機能させるには、予約プラットフォーム、承認済みの PKFARE アカウント、旅行会社のアフターサービス体制が必要です。
PHPTRAVELS：予約プラットフォーム
ウェブサイト、エージェントポータル、PKFARE モジュール設定、マークアップ、チェックアウト、決済、予約管理。
PKFARE：フライトコンテンツ
運賃、空席、運賃規則、注文、PNR。アクセス、路線、発券条件は PKFARE と航空会社が定めます。
旅行会社：商取引の運用
販売価格、顧客からの入金、サポート。変更や払い戻しは PKFARE と航空会社の規則に従います。
接続できるフライトサプライヤー：
Seeru
Amadeus
Duffel
Google Flights
Kayak
Kiwi
Mystifly
PKfare
Sabre
TBO Holidays
Travelport
バックオフィス
PKFARE の航空券販売を管理画面で運用
PKFARE の認証情報、価格設定、予約記録を、他の旅行事業と同じダッシュボードで管理できます。
モジュール設定
Partner ID と API key は自社インストールのモジュールに保存され、顧客に表示されることはありません。
マークアップと仕入れ原価
各予約に販売価格と PKFARE の運賃・税金を並べて保存し、予約ごとの利益を確認できます。
注文と PNR の記録
注文番号、PNR、旅客、支払い状況、PKFARE の完全なレスポンスを予約とともに保存します。
重複注文を防止
確定済みの PNR がある予約は、決済が再試行されても PKFARE に再送信されません。
B2B エージェント販売
エージェントはエージェントポータルで独自のマークアップとウォレット残高を使い PKFARE の運賃を予約します。
予約管理
スタッフは予約番号で検索し、旅客、旅程、支払い、メモを別のポータルではなく一か所で確認できます。
比較
PKFARE のフライトを販売する方法
最適な方法は、顧客体験とバックオフィスをどこまで自社で持つかによって決まります。一般的な選択肢の比較は通常次のとおりです。
| 項目 | サプライヤーポータルまたは独自開発 | PHPTRAVELS |
|---|---|---|
| 検索 | サプライヤーポータルまたは独自開発スタッフがサプライヤーポータルで運賃を調べ、見積もりに転記 | PHPTRAVELS自社ブランドの検索とエージェントポータルに PKFARE の運賃 |
| 価格設定 | サプライヤーポータルまたは独自開発マークアップを手作業で加算、またはゼロから開発 | PHPTRAVELS旅客区分ごとにマークアップと通貨ルールを適用 |
| 予約 | サプライヤーポータルまたは独自開発旅客情報をサプライヤーポータルに再入力 | PHPTRAVELS決済後に注文と PNR を自動作成 |
| 記録 | サプライヤーポータルまたは独自開発サプライヤー側の記録と社内メモが別々 | PHPTRAVELS管理者・顧客・エージェントで共有する一つの予約記録 |
| 公開までの期間 | サプライヤーポータルまたは独自開発独自開発ではサイト、管理画面、会計フローも構築が必要 | PHPTRAVELS完全な予約プラットフォームに組み込まれた既存の PKFARE モジュール |
活用例
PKFARE を PHPTRAVELS に接続する事業者
B2C 航空券予約サイト
一般向けフライト検索、オンラインカード決済、顧客アカウント、予約履歴を一つのブランドサイトで。
B2B エージェント販売
旅行会社やコンソリデーター向けに、サブエージェントのログイン、個別マークアップ、ウォレットまたは与信での支払い。
航空券とホテル・ツアー
OTA やツアーオペレーターが PKFARE のフライトをホテル、ツアー、送迎と一つの旅程にまとめます。
PHPTRAVELS を選ぶ理由
PKFARE アカウントもプラットフォームもコードも自社のもの
ソースコード付き
商用ライセンスのもとでセルフホストでき、開発者が PKFARE の処理を拡張できます。
自社の PKFARE 認証情報
partner ID と API key は自社で保持し、自社のインストールに保存されます。
ドキュメント化された設定
docs.phptravels.com のフライトセクションに PKFARE モジュールのガイドがあります。
B2C と B2B
公開サイトとエージェントポータルを一つのインストールで、24 言語に対応。
フライトカテゴリの PKFARE モジュールを通じて PKFARE のフライトコンテンツを PHPTRAVELS の予約プラットフォームにつなぎ、顧客やエージェントが自社サイトで検索、運賃規則の確認、決済、PNR の受け取りを行えるようにします。
アクセス権は PKFARE が付与します。承認後に partner ID と API key を受け取り、PKFARE モジュールの設定に入力します。利用条件と商取引条件は PKFARE に直接ご確認ください。
サプライヤーのログインは素早い照会には便利ですが、ブランド化された予約エンジン、自社のチェックアウト、エージェント向けマークアップ、請求書、顧客アカウントは得られません。多くの旅行会社はサポート用にログインを残し、販売は連携を通じて行っています。
注文番号と PNR が予約に保存されるため、スタッフは管理画面で旅客、旅程、支払い状況、メモを確認できます。キャンセルは注文番号で PKFARE に送信され、キャンセル・変更・払い戻しの可否は PKFARE と航空会社の規則に従います。
はい。片道、往復、周遊の検索に対応し、周遊の各区間は 1 回のリクエストで PKFARE に送信されます。
プランと有効にする商品によって異なります。プランは Startup の $2499（買い切りライセンス）から始まります。料金ページをご覧いただくか、営業に見積もりをご依頼ください。PKFARE の商取引条件は PKFARE と取り決めます。