建構取消規定

進一步了解 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 小時後正式生效。
若旅宿位於加州以外地區，即使預訂是在加州進行的，取消政策也不會有所變更。

Pre-booking 取消政策

當旅客正在選購時，更新後的取消罰金時限將自動顯示於 API 呼叫中。您可能會注意到，針對 non-refundable 的預訂，可退款標記仍顯示為「false」，因此您需依據取消時限遵守此規定。  對於飯店，該時限為自預訂時間戳記起算的 24 小時；至於 Vrbo 房源，則為預訂次日結束前。

Post-booking 取消政策

該 API 將在 GET/itineraries 擷取呼叫中顯示已更新的取消罰款時限。取消政策亦會顯示於任何預訂確認電子郵件中。

此變更不會影響 Shopping API 可用性回應中的 ``refundable 布林值。如果預設速率設定為 non-refundable,，系統仍會顯示refundable=false，以維持 Rapid API's 的過濾功能。雖然您仍可使用目前相同的邏輯，根據此參數進行篩選，但在顯示介面元素時，您需要將加州取消政策的變更納入考量。

「檢索行程」回應中的 ``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": "2027-08-26T23:59:00.000+07:00",
        "end": "2027-09-29T23:59:00.000+07:00",
        "amount": "200",
        "currency": "USD"
    }
],

預訂詳情：

客戶於 2027 年 7 月 5 日進行預訂
Check-in 日期是 2027 年 9 月 29 日
Check-out 日期是 2027 年 10 月 6 日

取消規定說明：

8 月 26 日 2027 11:59 (GMT +7:00) 前可免費取消。
若於 8 月 26 日 2027 11:59 下午 (GMT +7:00) 之後取消預訂，將收取 200 USD 的費用。
取消期限的結束時間是 9 月 29 日 23:59 (GMT +7:00)，屆時預訂將完全不得退款。
若您在預訂後未依約入住，或者在入住登記後取消或變更此預訂，旅宿可能會酌情向您收取最高達預訂金額 100% 的取消費用。

**備註：**如果預訂多間客房，則退還的取消費用金額應按客房入住人數和類型乘以相應數量計算。

範例 2 - 金額計算罰款 + 不得退款日期

API 回應：

"refundable": false,
"cancel_penalties": [
    {
        "start": "2027-08-26T23:59:00.000+07:00",
        "end": "2027-09-29T23:59:00.000+07:00",
        "amount": "200",
        "currency": "USD"
    }
], 
"nonrefundable_date_ranges": [ 
    {  
        "start": "2027-09-30",
        "end": "2027-10-01"
    }
    {   "start": "2027-10-05",         
        "end": "2027-10-06"     
    }
],

預訂詳情：

客戶於 2027 年 7 月 5 日進行預訂
Check-in 日期是 2027 年 9 月 29 日
Check-out 日期是 2027 年 10 月 7 日

取消規定說明：

若於 8 月 26 日 2027 11:59 下午 (GMT +7:00) 之前取消：
- 凡於「non-refundable」活動期間 (2027 年 9 月 30 日至 2027 年 10 月 1 日，以及 2027 年 10 月 5 日至 2027 年 10 月 6 日) 預訂的住宿晚數，自預訂當日起即完全 non-refundable。
- 在不得退款日期範圍外的晚數都可以免費取消。
於 8 月 26 日 2027 11:59 下午 (GMT +7:00) 至 9 月 29 日 2027 11:59 下午 (GMT +7:00) 期間辦理的取消：
- 凡於「non-refundable」活動期間 (2027 年 9 月 30 日至 2027 年 10 月 1 日，以及 2027 年 10 月 5 日至 2027 年 10 月 6 日) 預訂的住宿晚數，自預訂當日起即完全 non-refundable。
- 除了不得退款的晚數外，還將收取 200 美元的取消費用。
取消期限的結束時間是 9 月 29 日 23:59 (GMT +7:00)，屆時預訂將完全不得退款。
若您在預訂後未依約入住，或者在入住登記後取消或變更此預訂，旅宿可能會酌情向您收取最高達預訂金額 100% 的取消費用。

請注意：

nonrefundable_date_ranges 物件可以透過這種方式與 cancel_penalties 物件的任何時間範圍合併使用。
如果預訂多間客房，則退還的取消費用金額應按客房入住人數和類型乘以相應數量計算。

範例 3 - 晚數計算取消費用

API 回應：

"refundable": true,
"cancel_penalties": [
    {
        "start": "2027-08-26T23:59:00.000+07:00",
        "end": "2027-09-29T23:59:00.000+07:00",
        "nights": "1",
        "currency": "USD"
    }
],

預訂詳情：

客戶於 2027 年 7 月 5 日進行預訂
Check-in 日期是 2027 年 9 月 29 日
Check-out 日期是 2027 年 10 月 6 日

取消規定說明：

8 月 26 日 2027 11:59 下午 (GMT +7:00) 前可免費取消。
若於 8 月 26 日 2027 11:59 下午 (GMT +7:00) 之後取消預訂，將被收取 1 晚的違約金。
取消期限的結束時間是 9 月 29 日 23:59 (GMT +7:00)，屆時預訂將完全不得退款。
若您在預訂後未依約入住，或者在入住登記後取消或變更此預訂，旅宿可能會酌情向您收取最高達預訂金額 100% 的取消費用。

**備註：**如果預訂多晚住宿，將收取預訂第一晚的取消費用。

範例 4 - 百分比計算取消費用

API 回應：

"refundable": true,
"cancel_penalties": [
    {         
        "start": "2027-08-26T23:59:00.000+07:00",        
        "end": "2027-09-29T23:59:00.000+07:00",         
        "percent": "90%",        
        "currency": "USD"
    }
],

預訂詳情：

客戶於 2027 年 7 月 5 日進行預訂
Check-in 日期是 2027 年 9 月 29 日
Check-out 日期是 2027 年 10 月 6 日

取消規定說明：

8 月 26 日 2027 11:59 (GMT +7:00) 前可免費取消。
若於 8 月 26 日 2027 11:59 下午 (GMT +7:00) 之後取消預訂，將被收取住宿費用及相關費用的 90% 作為違約金。
取消時限的截止時間為 9 月 29 日 2027 11:59 下午 (GMT +7:00)，屆時該預訂將完全 non-refundable.
若您在預訂後未依約入住，或者在入住登記後取消或變更此預訂，旅宿可能會酌情向您收取最高達預訂金額 100% 的取消費用。

範例 5 - 免費取消/無取消手續費

API 回應：

"refundable": true,
"cancel_penalties": [
    {
    "start": "2027-08-26T23:59:00.000+07:00",
    "end": "2027-09-29T23:59:00.000+07:00",
    "nights": "0",
    "currency": "USD"
    }
],

預訂詳情：

客戶於 2027 年 7 月 5 日進行預訂
Check-in 日期是 2027 年 9 月 29 日
Check-out 日期是 2027 年 10 月 6 日

取消規定說明：

8 月 26 日 2027 11:59 (GMT +7:00) 前可免費取消。
若於 8 月 26 日晚上 11:59 (GMT +7:00) 至 2027 年 9 月 29 日「check-in,」活動當日期間取消，將不收取任何費用。不會產生取消費用。
若您在預訂後未依約入住，或者在入住登記後取消或變更此預訂，旅宿可能會酌情向您收取最高達預訂金額 100% 的取消費用。

範例 6 - 不得退款

如果預訂完全不得退款，則 cancel_penalties 期限開始日期/時間將在預訂日期/時間之前。

API 回應：

"cancel_penalties": [
        {
                "start": "2027-11-29T10:47:19.727+00:00",
                "end": "2028-01-05T23:59:00.000+00:00",
                "percent": "100%",
                "currency": "USD"
        }
    ],

預訂詳情：

客戶於 2027 年 11 月 30 日進行預訂
Check-in 日期是 2028 年 1 月 5 日
Check-out 日期是 2028 年 1 月 7 日

取消規定內文：

如果您取消預訂，您將不會獲得退款或積分以用於未來的住宿。

範例 7 - 層級取消

層級取消規定允許旅宿業者根據取消通知的提前時間長短，收取不同的取消罰款。通常，取消預訂的日期離入住日期越近，取消罰款金額就越高。

API 回應：

"refundable": true,
"cancel_penalties": [
    { 
        "start": "2027-08-31T23:59:00.000+07:00",
        "end": "2027-12-09T23:59:00.000+07:00",
        "percent": "70%", 
        "currency": "USD" 
    },
    { 
        "start": "2027-12-09T23:59:00.000+07:00",
        "end": "2027-12-12T23:59:00.000+07:00",
        "percent": "90%", 
        "currency": "USD" 
    }
 ],

預訂詳情：

客戶於 2027 年 7 月 5 日進行預訂
Check-in 日期是 2027 年 12 月 12 日
Check-out 日期是 2027 年 12 月 22 日

取消規定說明：

若於 8 月 31 日 2027 11:59 下午 (GMT +7:00) 之前取消，將不收取任何費用。
若於 8 月 31 日 2027 11:59 下午 (GMT +7:00) 至 12 月 9 日 2027 11:59 下午 (GMT +7:00) 期間取消預訂，將被收取住宿費用及相關手續費的 70% 作為取消費用。
若於 12 月 9 日 2027 11:59 下午 (GMT +7:00) 至 12 月 12 日 2027 11:59 下午 (GMT +7:00) 期間取消預訂，將被收取住宿費用及相關手續費的 90% 作為違約金。
取消時限的截止時間為 12 月 12 日 2027 11:59 下午 (GMT +7:00)，屆時該預訂將完全 non-refundable.
若您在預訂後未依約入住，或者在入住登記後取消或變更此預訂，旅宿可能會酌情向您收取最高達預訂金額 100% 的取消費用。

範例 8 - 部分退款

API 回應：

"refundable": false
"cancel_penalties": [
     {
         "start": "2027-11-27T22:21:15.996+01:00",
         "end": "2028-01-10T18:00:00.000+01:00",
         "percent": "90%",
         "currency": "USD"
     }
  ],

預訂詳情：

客戶於 2027 年 11 月 28 日進行預訂
Check-in 日期是 2028 年 1 月 10 日
Check-out 日期是 2028 年 1 月 14 日

取消規定說明：

預訂後所有取消將收取 90% 的取消罰款。
取消時限的截止時間為 1 月 10 日上午 2028 00:00 (GMT +1:00)，屆時該預訂將完全 non-refundable.
若您在預訂後未依約入住，或者在入住登記後取消或變更此預訂，旅宿可能會酌情向您收取最高達預訂金額 100% 的取消費用。

範例 9 - 不得退款的單次住宿金額

API 回應：

"refundable" : false,
"cancel_penalties" : [
    {
        "start" : "2027-11-16T18:00:00.000+04:00",
        "end" : "2027-11-19T18:00:00.000+04:00",
        "nights" : "1",
        "currency" : "EUR"
    }
],

取消規定說明：

只有在整個預訂均可退款的情況下，才可退還單次住宿金額。
取消此預訂會產生 1 晚的取消罰款，因此整個預訂均不得退款；在這種情況下，整筆單次住宿金額皆不予退款。

建構取消規定

進一步了解 Rapid Lodging API 上的取消政策如何運作。

簡介

加州房產的保單顯示更新

Pre-booking 取消政策

Post-booking 取消政策

規定範本

1. 取消規定的例外期間

2. 免費取消期間

3. 如果 API 回應中有 cancel_penalties，則為適用取消費用期間 (可以有多個取消費用期間)

4. 延遲入住和預訂後未入住的期間

5. 單次住宿金額退款。

範例

範例 1 - 金額計算取消費用

範例 2 - 金額計算罰款 + 不得退款日期

範例 3 - 晚數計算取消費用

範例 4 - 百分比計算取消費用

範例 5 - 免費取消/無取消手續費

範例 6 - 不得退款

範例 7 - 層級取消

範例 8 - 部分退款

範例 9 - 不得退款的單次住宿金額

3. 如果 API 回應中有 `cancel_penalties`，則為適用取消費用期間 (可以有多個取消費用期間)