お客様のご都合によるキャンセル

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と同様、Signature Authentication。

このスコープをクレデンシャルに追加するには、アカウントマネージャーまでご連絡ください。

仕組み

CFARの統合は最小限の混乱で済みます。空室状況/予約、予約、およびキャンセル（ステップ1、4、および6）のために、既存のRapid Lodgingリクエストのペイロードを変更する必要はありません。CFARのオファーに応じなければ、統合に変更はありません。

ラピッド・ロッジ付きCFAR

ステップ1：宿泊料金の検索

変更は必要ありません。

これは標準的なラピッド・ホッジング・アベイラビリティ/ショッピング・コールです。リクエストやレスポンスの処理に変更は必要ありません。

ステップ2：価格チェックAPIの呼び出し

これは標準的なRapid Lodgingの価格チェックコールです。リクエストの変更は必要ありません。

料金がCFARの対象である場合、プライスチェックのレスポンスには、add_trip_protection オブジェクト内の既存のbook リンクの他に、links リンクが含まれます。このリンクを使用して、旅行者にCFARオプションを提供してください。

例価格チェックレスポンスlinks オブジェクト (CFAR-eligible料金)

{
  "links": {
    "book": {
      "method": "POST",
      "href": "/v3/itineraries?token=QldfCGtcTjIbASj7"
    },
    "add_trip_protection": {
      "method": "GET",
      "href": "/v1/trip-protection/quote?token=QldfCGtcTjIbASj7"
    }
  }
}

注：add_trip_protection リンクは、レートがCFARの対象である場合にのみ表示されます。リンクがない場合、そのレートではCFARは利用できません。

ステップ3：トリップ・プロテクションのお見積もり

エンドポイント GET /v1/trip-protection/quote?token={token}

これは、選択されたレートの完全なCFAR見積もりを取得するオプションのステップです。ステップ2で返されたhref リンクのadd_trip_protection をリクエストURLとして使用します。

回答には

製品詳細：製品名、タイプ、ベンダー、および記録販売業者
保険契約の詳細：補償日、補償割合と限度額、マーケティング・コピー（見出し、概要、ベネフィット）、免責条項、保険契約約款へのリンク
価格設定： CFAR価格(trip_protection_price)および宿泊＋プロテクションの合計(totals)を、それぞれ請求可能通貨および請求通貨（税金／手数料を含む／含まない）で表示。
解約違約金：解約した場合にプロテクション商品自体に適用される違約金
予約リンク：links.book パラメータは、ステップ4でCFARで予約するために使用します。

必要なヘッダー

ヘッダー	必須	備考
`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`

例見積回答

{
  "product_name": "Cancel for any reason (100% Refund)",
  "product_type": "hotel_cancel_for_any_reason",
  "vendor": "[vendor name]",
  "merchant_of_record": "expedia",
  "policy": {
    "start_date": "2025-10-13T15:59:00.000+01:00",
    "end_date": "2025-10-18T08:00:00.000-08:00",
    "coverage": {
      "percentage": "100%",
      "limit": {
        "inclusive": {
          "billable_currency": { "value": "[amount]", "currency": "USD" },
          "request_currency": { "value": "[amount]", "currency": "USD" }
        },
        "exclusive": {
          "billable_currency": { "value": "[amount]", "currency": "USD" },
          "request_currency": { "value": "[amount]", "currency": "USD" }
        }
      }
    },
    "description": {
      "headline": "Change of plans? You're covered.",
      "overview": "Add flexibility to your stay with Cancel for any reason coverage. Get a refund if you cancel before 8:00 AM property time on [check-in date].",
      "benefits": "<b>Get a refund of 100%: [refund_amount]</b>
<b>Cancel anytime before 8:00 AM property time on [checkin_date]</b>
<b>No questions asked, no paperwork</b>
"
    },
    "disclaimer": "By purchasing, I agree to all Cancel for any reason [policy_terms_link_text] on my itinerary",
    "links": {
      "policy_wording": {
        "method": "GET",
        "href": "https://staging.vendor.com/pds/1ed50cef-49e1-4ff6-acc9-137ba784e472?policy_type=expedia_travel_insurance_v1"
      }
    }
  },
  "pricing": {
    "trip_protection_price": {
      "inclusive": {
        "billable_currency": { "value": "[amount]", "currency": "USD" },
        "request_currency": { "value": "[amount]", "currency": "USD" }
      },
      "exclusive": {
        "billable_currency": { "value": "[amount]", "currency": "USD" },
        "request_currency": { "value": "[amount]", "currency": "USD" }
      }
    },
    "totals": {
      "inclusive": {
        "billable_currency": { "value": "[amount]", "currency": "USD" },
        "request_currency": { "value": "[amount]", "currency": "USD" }
      },
      "exclusive": {
        "billable_currency": { "value": "[amount]", "currency": "USD" },
        "request_currency": { "value": "[amount]", "currency": "USD" }
      }
    }
  },
  "refundable": false,
  "cancel_penalties": [
    {
      "start": "2026-10-13T15:59:00.000+01:00",
      "end": "2026-10-18T08:00:00.000-08:00",
      "currency": "USD",
      "amount": "[amount]",
      "percent": "100%"
    }
  ],
  "links": {
    "book": {
      "method": "POST",
      "href": "/v3/itineraries?token=MY5S3j36cOcL",
      "expires": "2026-10-13T16:10:00.000+01:00"
    }
  }
}

ステップ4：ブッキングAPIを呼び出す

リクエストのペイロードに変更はありません。

これは標準的な高速宿泊予約コール(POST /v3/itineraries)です。使用する予約リンクは、旅行者がCFARに加入しているかどうかによって異なります。

旅行者の選択	予約リンク
CFARと	`links.book` ステップ3の見積回答より
CFARなし	`links.book` ステップ2の価格チェックの回答から

予約リクエストやレスポンスに新しいフィールドは追加されません。CFARは、予約リンクでどのトークンが使用されているかによってのみ有効化されます。

注：見積もりレスポンスのlinks.book トークンの有効期限（expires フィールドを参照）。トークンの有効期限が切れる前に予約を送信してください。

ステップ5：ブッキングの取得

リクエストに変更はありません。

これは標準的なラピッド・ロッジGET /v3/itineraries/{itinerary_id}。

CFARが購入された場合、Itineraryレスポンスには、購入された商品のポリシーと価格の詳細を含む追加のtrip_protection オブジェクトが含まれます。CFARを購入していない場合は、旅程の回答に変更はありません。

さらに、CFARが有効な場合、旅程のcancel_penalties オブジェクトのrefundable およびrate フィールドには、基本料金のキャンセルポリシーではなく、CFARポリシーが反映されます。

例trip_protection オブジェクトを示す旅程レスポンス

[
  {
    "itinerary_id": "8999989898988",
    "property_id": "8150374",
    "trip_protection": {
      "product_name": "Cancel for any reason (100% Refund)",
      "product_type": "hotel_cancel_for_any_reason",
      "vendor": "[vendor]",
      "merchant_of_record": "expedia",
      "policy": {
        "start_date": "2026-10-13T15:59:00.000+01:00",
        "end_date": "2026-10-18T08:00:00.000-08:00",
        "coverage": {
          "percentage": "100%",
          "limit": {
            "inclusive": {
              "billable_currency": { "value": "[amount]", "currency": "USD" }
            },
            "exclusive": {
              "billable_currency": { "value": "[amount]", "currency": "USD" }
            }
          }
        },
        "links": {
          "policy_wording": {
            "method": "GET",
            "href": "https://staging.vendor.com/pds/1ed50cef-49e1-4ff6-acc9-137ba784e472?policy_type=expedia_travel_insurance_v1"
          }
        }
      },
      "pricing": {
        "inclusive": {
          "billable_currency": { "value": "[amount]", "currency": "USD" }
        },
        "exclusive": {
          "billable_currency": { "value": "[amount]", "currency": "USD" }
        }
      }
    }
  }
]

注: Retrieveレスポンスのtrip_protection 料金は、請求可能な通貨のみを反映します。リクエスト通貨を含む詳細な内訳については、見積回答書をご参照ください。

ステップ6: 予約のキャンセル

リクエストに変更はありません。

これは標準的なラピッドロッジのキャンセルコールです。CFARを購入した場合、予約をキャンセルすると自動的に旅行者に代わって払い戻し請求が行われます。導入のための追加措置は必要ありません。

払い戻しはすべてExpedia Group. 旅行者は、通常のクレーム決済プロセスを通じて該当する払い戻しを受けます。

API の詳細

このページでTripProtection-relatedのエンドポイント定義を確認し、API Explorerまたはその他のテストソフトウェアを使用して、例とスキーマ定義が実際の出力とどのように比較されるかを理解してください。

注：このスキーマ・ファイルは評価目的でのみ提供されています。一般公開される前に、変更と改良が加えられる可能性があります。