详细了解 Rapid Lodging API 上的取消政策如何运作。 对于所有在预订时不可全额退款的房价类型，API 响应中将会显示 refundable=false。
每种房价的具体取消政策取决于 Rapid 选购房态 API 中 cancel_penalties 和 nonrefundable_date_ranges 对象的组合。
nonrefundable_date_ranges 对象定义了任何在预订时完全不可退款的住宿日期。因此，此对象的优先级始终高于 cancel_penalties 对象中列出的任何其他取消政策。使用 nonrefundable_date_ranges 对象设置在预订时不可退款的住宿日期是可选的。请注意， nonrefundable_date_range 包含在内，即，住宿还将收取“结束”日期当天的房价以及任何税费和其他费用。cancel_penalties 对象列出了所有其他取消手续费详情，并且提供多种选项用于构建这些政策。详情包括：指定手续费适用期限的开始日期和结束日期，以及手续费类型和金额。手续费类型包括：固定金额手续费、按住宿晚数计算的手续费以及按总费用百分比计算的手续费。需要注意的是，如果 nonrefundable_date_ranges 对象中定义了房价的不可退款日期，那么除了 cancel_penalties 对象中列出的任何其他取消手续费之外，还将针对这些住宿晚数收取手续费。
您可在检索预订服务（作为管理预订 API 的一部分）内的 cancel_refund 对象中找到预订退款金额。有关每次住宿费用退款状态的详情，请参见下文。
**注意：**开始和结束期限cancel_penalties以当地住宿所在时区的时间为准。
下列构建取消政策文本指导原则旨在帮助住宿接待方将取消政策准确地解释传达给最终旅客，或者当 API 以未列出的格式返回政策时，向客户显示不可退款消息。
为了遵守加利福尼亚州最近的政策变化，我们修改了 Rapid API，以确保对于位于加利福尼亚州的任何酒店，取消期必须在预订创建时间戳后 24 小时内开始，除非在 check-in 时间后 72 小时内进行。Expedia 系统设置为自动进行此更改。
以下是一些示例：
对于位于加利福尼亚州的酒店，其房价可全额退款且没有取消政策，取消政策不会发生任何变化。 对于位于加利福尼亚州的酒店，其 non-refundable 价格从预订时起设有取消罚金，取消政策将修改为在预订创建日期后 24 小时准时生效。 如果酒店位于加利福尼亚州以外，即使在加利福尼亚州进行预订，取消政策也不会发生任何变化。 更新后的取消罚款窗口将在旅行者购物时自动显示在 API 调用中。您可能会注意到，对于 non-refundable 预订，可退款标记仍为 false，因此，您需要根据取消期限来处理。对于酒店，取消期限为预订时间戳后的 24 小时；对于 Vrbo 住宿，取消期限为预订后次日结束前。
API 将在 GET/itineraries 检索调用中显示更新的取消罚款窗口。取消政策也将显示在所有预订确认电子邮件中。
购物 API 可用性响应中的 refundable 布尔值不会因此更改而修改。如果速率预期为 non-refundable，它仍将显示refundable=false，以维持 Rapid API 的过滤功能。虽然您仍然可以使用当前使用的相同逻辑来过滤此参数，但在显示界面元素时您需要考虑加利福尼亚州的取消政策变化。
检索行程响应中的 refundable 参数应反映预订当前是否在修改后的取消罚款窗口内，以便您可以在检索库存时确定预订是否可以全额退款。
取消政策由通过以下模板表示的四个主要时间范围组成。选择所有四个时间范围，以正确显示取消政策。
1. 取消政策例外时间范围。 自预订之时起取消时不予退款的日期可在 nonrefundable_date_ranges 对象中定义。不在此时间范围内的住宿日期受 cancel_penalties 对象中给出的政策的约束，因此，如果只是预订的部分住宿在例外时间范围内，则有可能获得部分退款。
2. 免费取消时间范围。 在 [手续费最早适用期限的开始日期时间] 之前可免费取消。注意：如果预订的住宿日期在不可退款日期范围（如 nonrefundable_date_ranges 对象中所定义）内，则不予退款，但如果在 cancel_penalties 对象中指定的手续费最早适用期限的开始日期时间之前取消，则任何不在此期限内的住宿日期都将予以退款。
3. 取消手续费适用时间范围（可存在多个手续费适用时间范围）- 如果 API 响应中包含 cancel_penalties。 注意：如果预订的住宿日期在不可退款日期范围（如 nonrefundable_date_ranges 对象中所定义）内，则仍需收取全额费用，但任何不在此期限内的住宿日期都将根据 cancel_penalties 对象中给出的政策予以退款。
固定金额手续费
在 [手续费适用期限的开始日期时间] 之后取消，需支付 [金额] [货币] 的费用。
或
每晚手续费
在 [手续费适用期限的开始日期时间] 之后取消，需支付 [晚数] 晚的手续费以及税费。
或
百分比手续费
在 [手续费适用期限的开始日期时间] 之后取消，需支付总价 [百分比]% 的手续费。 可以同时按照金额和晚数或金额和百分比收取手续费，但不能在同一时间范围内同时按照晚数和百分比收取手续费。
4. 延迟入住和预订后未入住的时间范围。 如果您无法为该预订办理入住，或者在办理入住后取消或变更了预订，住宿接待方可能会酌情向您收取不超过 100% 预订价值的手续费。
手续费最晚适用期限的结束日期为最晚取消日期和时间。
5. 每次住宿费用退款。 如果一天或多天的住宿也不可退款，则在住宿对象中返回的每次住宿费用将被视为不可退款。只有在整次住宿可全额退款的情况下，才可退还每次住宿费用。
示例 1 - 固定金额手续费
API 响应：
"refundable": true,
"cancel_penalties": [
{
"start": "2022-08-26T23:59:00.000+07:00",
"end": "2022-09-29T23:59:00.000+07:00",
"amount": "200",
"currency": "USD"
}
], 详细预订信息：
客户预订日期为 2022 年 7 月 5 日 入住日期为 2022 年 9 月 29 日 退房日期为 2022 年 10 月 6 日 取消政策说明：
在 2022 年 8 月 26 日 11:59 PM (GMT +7:00) 之前可免费取消。 在 2022 年 8 月 26 日 11:59 PM (GMT +7:00) 之后取消，需支付 200 USD 的费用。 取消手续费适用期限的结束时间是 9 月 29 日 11:59 PM (GMT +7:00)，届时预订将完全不可退款。 如果您无法为该预订办理入住，或者在办理入住后取消或变更了预订，住宿接待方可能会酌情向您收取不超过 100% 预订价值的手续费。 **注意：**如果申请多间客房，则退回的取消手续费金额按每间客房的入住人数类型计算，并应乘以相应客房数。
示例 2 - 固定金额手续费 + 不可退款日期
API 响应：
"refundable": false,
"cancel_penalties": [
{
"start": "2022-08-26T23:59:00.000+07:00",
"end": "2022-09-29T23:59:00.000+07:00",
"amount": "200",
"currency": "USD"
}
],
"nonrefundable_date_ranges": [
{
"start": "2022-09-30",
"end": "2022-10-01"
}
{ "start": "2022-10-05",
"end": "2022-10-06"
}
], 详细预订信息：
客户预订日期为 2022 年 7 月 5 日 入住日期为 2022 年 9 月 29 日 退房日期为 2022 年 10 月 7 日 取消政策说明：
在 2022 年 8 月 26 日 11:59 PM (GMT +7:00) 之前取消：在不可退款日期范围（2022 年 9 月 30 日 - 2022 年 10 月 1 日和 2022 年 10 月 5 日 - 2022 年 10 月 6 日）内的任何预订的晚数自预订之时起便完全不可退款。 对于任何不在不可退款日期范围内的晚数，可免费取消。 在 2022 年 8 月 26 日 11:59 PM (GMT +7:00) 至 2022 年 9 月 29 日 11:59 PM (GMT +7:00) 期间取消：在不可退款日期范围（2022 年 9 月 30 日 - 2022 年 10 月 1 日和 2022 年 10 月 5 日 - 2022 年 10 月 6 日）内的任何预订的晚数自预订之时起便完全不可退款。 除不可退还的住宿天数外，还将收取 200 美元的手续费。 取消手续费适用期限的结束时间是 9 月 29 日 11:59 PM (GMT +7:00)，届时预订将完全不可退款。 如果您无法为该预订办理入住，或者在办理入住后取消或变更了预订，住宿接待方可能会酌情向您收取不超过 100% 预订价值的手续费。 注意：
nonrefundable_date_ranges 对象可以这种方式与任何 cancel_penalties 对象时间范围组合使用。如果申请多间客房，则退回的取消手续费金额按每间客房的入 住人数类型计算，并应乘以相应客房数。 示例 3 - 每晚手续费
API 响应：
"refundable": true,
"cancel_penalties": [
{
"start": "2022-08-26T23:59:00.000+07:00",
"end": "2022-09-29T23:59:00.000+07:00",
"nights": "1",
"currency": "USD"
}
], 详细预订信息：
客户预订日期为 2022 年 7 月 5 日 入住日期为 2022 年 9 月 29 日 退房日期为 2022 年 10 月 6 日 取消政策说明：
在 2022 年 8 月 26 日 11:59 PM (GMT +7:00) 之前可免费取消。 在 2022 年 8 月 26 日 11:59 PM (GMT +7:00) 之后取消，需支付 1 晚手续费。 取消手续费适用期限的结束时间是 9 月 29 日 11:59 PM (GMT +7:00)，届时预订将完全不可退款。 如果您无法为该预订办理入住，或者在办理入住后取消或变更了预订，住宿接待方可能会酌情向您收取不超过 100% 预订价值的手续费。 **注意：**如果预订多晚住宿，手续费将为预订第一晚的费用。
示例 4 - 百分比手续费
API 响应：
"refundable": true,
"cancel_penalties": [
{
"start": "2022-08-26T23:59:00.000+07:00",
"end": "2022-09-29T23:59:00.000+07:00",
"percent": "90%",
"currency": "USD"
}
], 详细预订信息：
客户预订日期为 2022 年 7 月 5 日 入住日期为 2022 年 9 月 29 日 退房日期为 2022 年 10 月 6 日 取消政策说明：
在 2022 年 8 月 26 日 11:59 PM (GMT +7:00) 之前可免费取消。 在 2022 年 8 月 26 日 11:59 PM (GMT +7:00) 之后取消，需支付住宿款和其他 费用 90% 的手续费。 取消手续费适用期限的结束时间是 2022 年 9 月 29 日 11:59 PM (GMT +7:00)，届时预订将完全不可退款。 如果您无法为该预订办理入住，或者在办理入住后取消或变更了预订，住宿接待方可能会酌情向您收取不超过 100% 预订价值的手续费。 示例 5 - 免费取消/无取消手续费
API 响应：
"refundable": true,
"cancel_penalties": [
{
"start": "2022-08-26T23:59:00.000+07:00",
"end": "2022-09-29T23:59:00.000+07:00",
"nights": "0",
"currency": "USD"
}
], 详细预订信息：
客户预订日期为 2022 年 7 月 5 日 入住日期为 2022 年 9 月 29 日 退房日期为 2022 年 10 月 6 日 取消政策说明：
在 2022 年 8 月 26 日 11:59 PM (GMT +7:00) 之前可免费取消。 在 2022 年 8 月 26 日 11:59 PM (GMT +7:00) 至入住当天（2022 年 9 月 29 日）期间可免费取消，不会产生任何手续费。 如果您无法为该预订办理入住，或者在办理入住后取消或变更了预订，住宿接待方可能会酌情向您收取不超过 100% 预订价值的手续费。 示例 6 - 不可退款
如果预订完全不可退款，cancel_penalties 期限的开始日期/时间将在预订日期/时间之前。
API 响应：
"cancel_penalties": [
{
"start": "2022-11-29T10:47:19.727+00:00",
"end": "2023-01-05T23:59:00.000+00:00",
"percent": "100%",
"currency": "USD"
}
], 详细预订信息：
客户预订日期为 2022 年 11 月 30 日 入住日期为 2023 年 1 月 5 日 退房日期为 2023 年 1 月 7 日 取消政策文本：
如果取消订单，您将无法获得退款或用于将来预订住宿的代金券。 示例 7 - 分级取消
分级取消政策允许住宿接待方向客户收取取消手续费，具体费用因发出的取消通知数量而异。通常，客户取消预订的日期越临近住宿日期，取消手续费就越高。
API 响应：
"refundable": true,
"cancel_penalties": [
{
"start": "2022-08-31T23:59:00.000+07:00",
"end": "2022-12-09T23:59:00.000+07:00",
"percent": "70%",
"currency": "USD"
},
{
"start": "2022-12-09T23:59:00.000+07:00",
"end": "2022-12-12T23:59:00.000+07:00",
"percent": "90%",
"currency": "USD"
}
], 详细预订信息：
客户预订日期为 2022 年 7 月 5 日 入住日期为 2022 年 12 月 12 日 退房日期为 2022 年 12 月 22 日 取消政策说明：
在 2022 年 8 月 31 日 11:59 PM (GMT +7:00) 之前可免费取消。 在 2022 年 8 月 31 日 11:59 PM (GMT +7:00) 至 2022 年 12 月 9 日 11:59 PM (GMT +7:00) 期间取消，需支付 住宿款和其他费用 70% 的手续费。 在 2022 年 12 月 9 日 11:59 PM (GMT +7:00) 至 2022 年 12 月 12 日 11:59 PM (GMT +7:00) 期间取消，需支付住宿款和其他费用 90% 的手续费。 取消手续费适用期限的结束时间是 2022 年 12 月 12 日 11:59 PM (GMT +7:00)，届时预订将完全不可退款。 如果您无法为该预订办理入住，或者在办理入住后取消或变更了预订，住宿接待方可能会酌情向您收取不超过 100% 预订价值的手续费。 示例 8 - 部分可退款
API 响应：
"refundable": false
"cancel_penalties": [
{
"start": "2022-11-27T22:21:15.996+01:00",
"end": "2023-01-10T18:00:00.000+01:00",
"percent": "90%",
"currency": "USD"
}
], 详细预订信息：
客户预订日期为 2022 年 11 月 28 日 入住日期为 2023 年 1 月 10 日 退房日期为 2023 年 1 月 14 日 取消政策说明：
自预订之时起，所有取消都将产生 90% 的取消手续费。 取消手续费适用期限的结束时间是 2023 年 1 月 10 日 00:00 (GMT +1:00)，届时预订将完全不可退款。 如果您无法为该预订办理入住，或者在办理入住后取消或变更了预订，住宿接待方可能会酌情向您收取不超过 100% 预订价值的手续费。 示例 9 - 不可退款的每次住宿费用
API 响应：
"refundable" : false,
"cancel_penalties" : [
{
"start" : "2022-11-16T18:00:00.000+04:00",
"end" : "2022-11-19T18:00:00.000+04:00",
"nights" : "1",
"currency" : "EUR"
}
], 取消政策说明：
只有在整个订单可退款的情况下，才可退还每次住宿费用。 取消此预订会产生 1 晚的取消罚金，因此整个订单不可 退款，在这种情况下不会退还任何每次住宿费用。 