理由を問わずキャンセル可能

旅行者の方々に、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の統合による業務への影響は最小限に抑えられます。空室状況の確認・検索、予約、およびキャンセルに関する既存のRapid Lodgingリクエストのペイロードについては、変更の必要はありません（ステップ1、4、および6）。この新しい動作は加算的なものであるため、CFARの提案に応じない場合でも、積分値に変化は見られません。

CFAR（迅速宿泊手配付き）

CFAR機能をご利用の際、旅行者が行う主な操作は2つあります。1つ目は、商品の検索や予約であり、2つ目は、既存の予約の管理です。

ステップ1：宿泊料金を検索する

変更の必要はありません。

こちらは、通常の「Rapid Lodging」の空室状況確認・予約に関するお電話です。リクエストやレスポンスの処理について、変更は必要ありません。

ステップ2：Price Check APIを呼び出す

こちらは、Rapid Lodgingの標準的な料金確認のお電話です。ご依頼内容に変更は必要ありません。

CFARの対象となる運賃が、予約時に利用可能な場合、価格照会の応答には、add_trip_protection オブジェクト内のbook リンクのほかに、links リンクが含まれます。このリンクを使用して、旅行者にCFARの選択肢をご案内ください。

価格照会の応答リンクのサンプル（CFAR-eligibleのレート）

"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": "2026-09-28T13:23:37Z",
    "end": "2026-10-08T08: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 data-block-key=\"vkgdz\">By purchasing, I agree to all Cancel For Any Reason <a href=\"https://example.com" rel=\"noopener noreferrer\" target=\"_blank\">Terms and Conditions</a>.</p>",
    "links": {
      "terms_and_conditions": {
        "method": "GET",
        "href": "https://example.com
      }
    }
  },
  "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": "2026-10-07T22:59:59Z",
  "cancel_penalties": [
    {
      "start": "2026-09-28T13:23:37Z",
      "end": "2026-10-08T07:00:00Z",
      "currency": "USD",
      "amount": "709.72",
      "percent": "100%"
    }
  ],
  "links": {
    "book_with_trip_protection": {
      "method": "POST",
      "href": "/v3/itineraries?token=QldfCGlcUA4FVFBbDQ4JUwpDRwdWXBBLDwheZkFdBwVQU19RA1tUUBlXDQcGSwcHCwEYBl0NVUwFDgdVCwJSAlZSVAsQXlVHVApVC0BrDlBnQ1BWWxYBD3w9YHNxcSceQgVCVmgIV14KDFZTAg4EWApARgxFUmJmJ7IHpnIxJTSCpoNH5DNVUnOHclNCdQcFh9LWFfWwpzN1BkIDpMASo1ZkZWPg0nUUZTMicjCCA0Ml0vN0APLiZ0ZXByCXtwdmISVyVHB3IWJlAAVglDTA8EVV8KDgMDWg9UBQ=="
    }
  }
}

ステップ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」トークンは、約2時間後に有効期限が切れます（expires_at フィールドをご参照ください）。トークンの有効期限が切れた場合は、リクエストを再送信してください。

ステップ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": "2025-10-13T15:59:00.000Z",
      "end": "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",
        }
      }
    },
    "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」やその他のテスト用ソフトウェアを使用して、サンプルやスキーマ定義と実際の出力との違いを把握してください。

注意

このスキーマファイルは、評価目的でのみ提供されています。一般提供が開始されるまでに、互換性を損なう変更を含め、変更や改良が行われる可能性があります。