构建取消政策

详细了解取消政策在 Rapid 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 以未列出的格式返回政策时，向客户显示不可退款消息。

政策模板

取消政策由通过以下模板表示的四个主要时间范围组成。选择所有四个时间范围，以正确显示取消政策。

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": "
        ",
        "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" : true,
      "cancel_refund" : {
        "amount" : "-784.57",
        "currency" : "EUR"
      },
      "cancel_penalties" : [ {
        "currency" : "EUR",
        "nights" : "1",
        "start" : "2022-11-16T18:00:00.000+04:00",
        "end" : "2022-11-19T18:00:00.000+04:00"

取消政策说明：

只有在整个订单可退款的情况下，才可退还每次住宿费用。
取消此预订会产生 1 晚的取消罚金，因此整个订单不可退款，在这种情况下不会退还任何每次住宿费用。

构建取消政策

详细了解取消政策在 Rapid API 上的运作方式。

简介

政策模板

1. 取消政策例外时间范围。

2. 免费取消时间范围。

3. 取消手续费适用时间范围（可存在多个手续费适用时间范围）- 如果 API 响应中包含 `cancel_penalties`。

4. 延迟入住和预订后未入住的时间范围。

5. 每次住宿费用退款。

示例

示例 1 - 固定金额手续费

示例 2 - 固定金额手续费 + 不可退款日期

示例 3 - 每晚手续费

示例 4 - 百分比手续费

示例 5 - 免费取消/无取消手续费

示例 6 - 不可退款

示例 7 - 分级取消

示例 8 - 部分可退款

示例 9 - 不可退款的每次住宿费用

另请参阅

EPS 通知服务测试器

新冠疫情 Rapid 更新

住客点评

签名生成器

构建取消政策

详细了解取消政策在 Rapid API 上的运作方式。

简介

政策模板

1. 取消政策例外时间范围。

2. 免费取消时间范围。

3. 取消手续费适用时间范围（可存在多个手续费适用时间范围）- 如果 API 响应中包含 cancel_penalties。

4. 延迟入住和预订后未入住的时间范围。

5. 每次住宿费用退款。

示例

示例 1 - 固定金额手续费

示例 2 - 固定金额手续费 + 不可退款日期

示例 3 - 每晚手续费

示例 4 - 百分比手续费

示例 5 - 免费取消/无取消手续费

示例 6 - 不可退款

示例 7 - 分级取消

示例 8 - 部分可退款

示例 9 - 不可退款的每次住宿费用

另请参阅

EPS 通知服务测试器

新冠疫情 Rapid 更新

住客点评

签名生成器

3. 取消手续费适用时间范围（可存在多个手续费适用时间范围）- 如果 API 响应中包含 `cancel_penalties`。