取消（任何原因）

允许旅客灵活取消 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：调用价格检查 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"
  }
}

注意：只有当利率既可用又符合 CFAR 条件时，才会显示 add_trip_protection 链接。

步骤 3：获取旅行保障报价

终点： GET /v1/trip-protection/quote?token={token}

这是一个可选步骤，用于获取所选费率的完整 CFAR 报价。使用步骤 2 中返回的 href 链接中的 add_trip_protection 作为请求 URL。

响应中包含产品名称，以及：

保单详情：承保日期、承保比例和限额、营销文案（标题、概述、保障范围）、免责声明以及保单条款文件的链接
定价： CFAR 价格（trip_protection_price）和住宿 + 安保总价（totals），均以计费货币和请求货币表示（含税费和不含税费）
取消罚款：如果取消，则适用于保护产品本身的罚款。
**预订链接：**在步骤 4 中使用 links.book_with_trip_protection 参数通过 CFAR 进行预订。

必需的标头

标题	必填	备注
`Accept`	是	必须是 application/json
`Accept-Encoding`	是	必须使用 gzip 压缩
`Customer-Ip`	是	End-traveler 的 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 链接完成，该链接将报价内容嵌入到令牌中。图书请求模式无需任何更改。

新链接将作为标准快速住宿预订调用的一部分传递（POST /v3/itineraries）。要使用的预订链接取决于旅客是否选择加入 CFAR。

旅行者的选择	预订链接
使用 CFAR	`links.book_with_trip_protection` 来自步骤 3 的引用回复
不考虑 CFAR	`links.book` 来自第二步价格核查的回复

预订请求或响应中不会添加任何新字段。CFAR 的激活完全取决于预订链接中使用的令牌。

注意：报价响应中的 links.book_with_trip_protection 令牌会在大约 2 小时后过期（请参阅 expires_at 字段）。如果令牌过期，则应重新发送请求。

第五步：检索预订信息

请求内容没有更改。

这是标准的快速住宿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_protectionRetrieve 响应中的价格仅反映计费货币。有关包括请求货币在内的完整明细，请参阅原始报价回复。

第六步：取消预订

请求内容没有更改。

这是 Rapid Lodging 的标准取消预订电话。如果 CFAR 已用于预订，则取消预订将自动触发代表旅客的退款申请，但须遵守资格条款。如果在资格窗口期之外尝试取消（例如，在 check-in 当天上午 8:00 之前），则不会处理退款。您的实施无需采取任何其他措施。

退款完全由 Expedia Group 处理。旅客将通过标准理赔流程获得相应的退款。

API 详情

浏览此页面上的 Trip Protection-related 端点定义，然后使用 API Explorer 或其他测试软件来了解示例和架构定义与实际输出的比较情况。

注意

此模式文件仅供评估之用。在正式发布之前，可能会进行一些更改和改进，包括一些重大更改。