理由を問わずキャンセル可能
旅行者の方々に、non-refundableでの予約をキャンセルし、ホテル代金の全額を返金してもらえるよう、柔軟な対応をいたします
Trip Protection APIは、すでにRapid Lodging APIと連携済みの事業者向けの、新しいオプション機能です。これにより、対象となる宿泊予約に「理由を問わずキャンセル可能（CFAR）」のアップグレードを適用することができ、旅行者はnon-refundableでの予約を柔軟にキャンセルし、ホテル代金の全額返金を受けることができます。
CFARとは何ですか？
CFARの導入により、旅行者はチェックイン前にnon-refundableでの宿泊予約をキャンセルし、ホテルから全額返金を受けることができます。CFARは旅行サービスであり、従来の旅行保険とは異なります。利用に際して特別な理由や請求手続きは不要で、旅行者はどのような理由であっても、追加の手続きなしにキャンセルすることができます。
CFARは、次のようなお手伝いをいたします：
- lower-priced non-refundableの在庫におけるコンバージョン率を向上させる
- non-refundableの料金で予約する際、旅行者に安心感を与えてください
- キャンセルに伴う手間を軽減する
- 手作業による請求処理を導入することなく、柔軟性を提供します
CFAR表示の例
ご注意：このサンプルは、あくまで参考として提供されているものです。
認証
Trip Protection APIを統合する前に、Rapid Lodging API（空室状況／検索、価格照会、および予約のエンドポイント）がすでに稼働している必要があります。認証の仕組みは、Rapid Lodging APIと同様に、署名認証によるものとなります。
この資格範囲を資格証明書に追加していただくには、アカウントマネージャー までご連絡ください。
仕組み
CFARの統合による業務への影響は最小限に抑えられます。空室状況の確認・検索、予約、およびキャンセル（ステップ1、4、6）に関する既存のRapid Lodgingリクエストのペイロードについては、変更の必要はありません。この新しい動作は加算的なものであるため、CFARの提案に応じない場合でも、積分値に変化は見られません。
CFAR（迅速宿泊手配付き）
CFAR機能をご利用の際、旅行者が行う主な操作は2つあります。1つ目は商品の検索や予約、2つ目は既存の予約の管理です。
ステップ1：宿泊料金を検索する
変更の必要はありません。
こちらは、Rapid Lodgingの空室状況確認・予約に関する標準的な電話です。リクエストやレスポンスの処理について、変更は必要ありません。
ステップ2：Price Check APIを呼び出します
こちらは、Rapid Lodgingの標準的な料金確認のお電話です。ご依頼内容に変更は必要ありません。
CFARの対象となる運賃が、予約時に利用可能な場合、「Price Check」の応答には、add_trip_protection オブジェクト内のbook リンクのほかに、links リンクが含まれます。このリンクを使用して、旅行者にCFARのオプションをご案内してください。
価格照会の応答リンクのサンプル（CFAR-eligible rate）
"links": {
"book": {
"method": "POST",
"href": "/v3/itineraries?token=MY5S3j36cOcL",
"expires": "2025-10-13T16:10:00.000+01:00"
},
"add_trip_protection": {
"method": "GET",
"href": "/v1/trip-protection/quote?token=MY5S3j36cOcLfLBZjPYQ1abhfc8CqmjmFVzkk7euvWaunE57LLeDgaxm516m",
"expires": "2025-10-13T16:10:00.000+01:00"
}
}注：「add_trip_protection」へのリンクは、その料金プランが利用可能であり、かつCFARの対象となる場合にのみ表示されます。
ステップ3：旅行保険の見積もりを取得する
エンドポイント： GET /v1/trip-protection/quote?token={token}
これは、選択したレートに関するCFARの完全な相場情報を取得するための、任意の手順です。ステップ2で返されたhref のリンクにあるadd_trip_protection を、リクエストURLとしてご使用ください。
その回答には、以下の内容が含まれています：
- 製品の詳細： 製品名、種類、ベンダー、および登録販売業者
- 保険契約の詳細： 保障期間、保障率および保障限度額、販売用コピー（見出し、概要、特長）、免責事項、および保険約款へのリンク
- 価格： CFAR価格（
trip_protection_price）および宿泊費と保護費の合計額（totals）は、それぞれ請求通貨と請求元通貨の両方で表示されており（税・手数料込みおよび税・手数料抜き）、 - 解約時の違約金： 解約時に保護商品自体に適用される違約金
- 予約リンク： ステップ4では、CFARを通じて予約を行うために「
links.book_with_trip_protection」というパラメータが使用されます。
必要なヘッダー
| ヘッダー | 必須 | 備考 |
|---|---|---|
Accept | 必須 | 「application/json」でなければなりません。 |
Accept-Encoding | 必須 | gzip形式でなければなりません |
Customer-Ip | 必須 | End-traveler's IPv4アドレス（ご自身のサーバーのアドレスではありません） |
User-Agent | 必須 | お客様のuser-agent、または {app-name}/{app-version} |
Customer-Session-Id | 必須ではない | ユーザーセッションごとに一意です。同じセッション内の呼び出し間では、re-useが適用されます。 |
Test | 必須ではない | サンドボックステストについては：standard、service_unavailable、unknown_internal_error |
例： 見積もりへの返信
{
"policy": {
"start_date": "2026-08-28T10:40:49Z",
"end_date": "2026-08-30T08:00:00+01:00",
"coverage": {
"limit": {
"value": "709.72",
"currency": "USD",
"percent": "100%"
}
}
},
"content": {
"product_name": "CFAR upgrade",
"headline": "Make your stay refundable",
"overview": "Get a refund on your accommodation with the Cancel For Any Reason (CFAR) upgrade.",
"benefits": [
{
"title": "Get a 100% refund of your accommodation cost",
"description": null
},
{
"title": "Cancel before 8:00am property time on the day of check-in",
"description": null
},
{
"title": "No questions asked, no paperwork",
"description": null
}
],
"disclaimer_html": "<p>By purchasing, I agree to all Cancel For Any Reason <a href=\"https://policy.example.com/pds/example\">Terms and Conditions</a>.</p>",
"links": {
"terms_and_conditions": {
"method": "GET",
"href": "https://policy.example.com/pds/example?policy_type=cfar_v1",
"expires": null
}
}
},
"pricing": {
"trip_protection": {
"inclusive": {
"billable_currency": {
"value": "149.04",
"currency": "USD"
},
"request_currency": {
"value": "149.04",
"currency": "USD"
}
},
"exclusive": {
"billable_currency": {
"value": "149.04",
"currency": "USD"
},
"request_currency": {
"value": "149.04",
"currency": "USD"
}
}
},
"totals": {
"inclusive": {
"billable_currency": {
"value": "858.76",
"currency": "USD"
},
"request_currency": {
"value": "858.76",
"currency": "USD"
}
},
"exclusive": {
"billable_currency": {
"value": "858.76",
"currency": "USD"
},
"request_currency": {
"value": "858.76",
"currency": "USD"
}
}
}
},
"refundable": false,
"expires_at": "2026-08-29T22:59:59Z",
"cancel_penalties": [
{
"start": "2026-08-28T10:40:49Z",
"end": "2026-08-30T07:00:00Z",
"currency": "USD",
"amount": "709.72",
"percent": "100%"
}
],
"links": {
"book_with_trip_protection": {
"method": "POST",
"href": "/v3/itineraries?token=QldfCGlcUA4",
"expires": null
}
}
}ステップ4：予約APIを呼び出す
旅行者が対象となる予約についてCFARの見積もりを承諾した場合、その予約は、トークンに見積もりの情報が埋め込まれたbook_with_trip_protection リンクを通じて行われます。書籍リクエストのスキーマに変更は必要ありません。
新しいリンクは、標準的なRapid Lodging Bookingの呼び出し（POST /v3/itineraries）の一部として渡されます。ご利用いただく予約リンクは、旅行者がCFARに加入しているかどうかによって異なります。
| 旅行者の選択 | ご利用いただく予約リンク |
|---|---|
| CFARと | links.book_with_trip_protection ステップ3の引用への回答より |
| CFARなしの場合 | links.book 「ステップ2：価格確認」の回答より |
予約リクエストやレスポンスには、新しいフィールドは追加されません。CFARは、予約リンクでどのトークンが使用されたかによってのみ有効 化されます。
注： 見積もりレスポンスに含まれる「links.book_with_trip_protection」トークンは有効期限が切れます（expires フィールドをご参照ください）。トークンの有効期限が切れる前に、予約を送信してください。
ステップ5：予約情報を確認する
ご依頼内容に変更はありません。
こちらは、Rapid LodgingのGET /v3/itineraries/{itinerary_id} への標準的な電話です。
CFARが購入された際、旅程の応答には、購入された商品のポリシーおよび価格の詳細を含む追加のtrip_protection オブジェクトが含まれます。CFARをご購入されていない場合、旅程表の返信内容に変更はございません。
また、CFARが有効になっている場合、旅程内のcancel_penalties オブジェクトにある「refundable」および「rate」の各フィールドには、基本運賃のキャンセル規定ではなく、CFARの規定が反映されます。
例：「trip_protection」オブジェクトを含む旅程のレスポンス
{
"trip_protection": {
"product_name": "Cancel For Any Reason (100% Refund)",
"product_type": "hotel_cancel_for_any_reason",
"vendor": "[vendor]",
"merchant_of_record": "expedia",
"eligibility_status": "eligible",
"policy": {
"start_date": "2025-10-13T15:59:00.000Z",
"end_date": "2025-10-18T08:00:00.000-08:00",
"coverage": {
"percentage": "100%",
"limit": {
"inclusive": {
"billable_currency": {
"value": "702.00",
"currency": "USD"
}
},
"exclusive": {
"billable_currency": {
"value": "702.00",
"currency": "USD"
}
}
}
},
"links": {
"policy_wording": {
"method": "GET",
"href": "https://policy.example.com/pds/example?policy_type=cfar_v1",
"expires": null
}
}
},
"pricing": {
"inclusive": {
"billable_currency": {
"value": "702.00",
"currency": "USD"
}
},
"exclusive": {
"billable_currency": {
"value": "702.00",
"currency": "USD"
}
}
}
},
}注：「trip_protection」の料金は、Retrieveレスポンスに表示される請求対象通貨のみを反映しています。ご依頼時の通貨を含む詳細な内訳につきましては、当初のお見積回答をご参照ください。
手順6：予約をキャンセルする
ご依頼内容に変更はありません。
こちらは、Rapid Lodgingの標準的なキャンセル連絡です。予約のためにCFARを購入した場合、キャンセルすると、適格条件に従い、旅行者に代わって自動的に払い戻し 請求が行われます。対象期間外（例えば、check-in), 当日の午前8時までに）キャンセル手続きを行おうとした場合、返金は行われません。お客様の実装に関して、追加の対応は必要ありません。
返金の処理はすべて、Expedia Group. 旅行者には、通常の保険金請求手続きを通じて、該当する払い戻しが行われます。
API の詳細
このページで「TripProtection-related」エンドポイントの定義を確認した後、「API Explorer」またはその他のテスト用ソフトウェアを使用して、サンプルやスキーマ定義と実際の出力結果との違いを比較・確認してください。
注： このスキーマファイルは、評価目的でのみ提供されています。一般提供が開始されるまでに、互換性を損なう変更を含め、変更や改良が行われる可能性があります。