預訂暫停與繼續處理

什麼是暫停與繼續處理？EPS 的「暫停與繼續處理」功能，可讓您支援雙步驟預訂模式。

使用雙步驟預訂模式時，合作夥伴或客戶可先暫停進行單人房預訂而無須立即付費，且若其取消或放棄客房而未完成預訂，也不會產生任何取消罰款。

若客戶/合作夥伴想要在指定時間範圍內確認客房，可以在第二個步驟完成預訂。若客戶/合作夥伴放棄預訂，系統會復原預訂狀態，他們選擇的空房也會釋出。

概覽

需進行哪些變更？

「暫停與繼續處理」在回應中使用現有的 Rapid API，以及新的要求標記與 Token 化連結。不需新的離散 API 方法即可整合。若要整合「暫停與繼續處理」，您必須針對以下項目更新要求和/或回應處理：

1.     預訂建立處理

2.     預訂取回處理

3.     繼續處理 - 「取回」回應中的新 Token 連結處理

4.     取消 - 「建立」回應中的新 Token 連結處理 您現在可能已經十分瞭解完整的「暫停與繼續處理」程序，請仔細檢閱本頁面，再閱讀我們的各項 API 整合文件。本頁面上的特定選項，亦記載於現有預訂與預訂管理 API 各自的專屬文件頁面。

一般要求流程範例

建立暫停預訂

預訂要求現在新增了一個名稱為 hold 的布林值欄位。若傳送 true 值，會使飯店狀態變成暫停。 

暫停的預訂應僅在特定應用程式要求的最短時間內，維持暫停狀態。若預訂未經確認即處於暫停狀態，該狀態將自動復原。   若暫停預訂回應成功，系統會再多傳回一個用於繼續處理 (確認並付款) 暫停預訂的 Token 化連結。由於尚無任何要取消的客房，因此該回應也會忽略平時用於提供取消連結的 rooms 陣列。

暫停預訂的預訂回應範例

{
  "itinerary_id": "2667552437552",
  "links": [
    {
      "rel": "retrieve",
      "method": "GET",
      "href": "/1/itinerary/{itinerary_id}?token=MY5S3j36cOcLfLBZjPYQ1abhfc8CqmjmFVzkk7euvWaunE57LLeDgaxm516m"
    },
    {
      "rel": "resume",
      "method": "PUT",
      "href": "/1/itinerary/{itinerary_id}?token=MY5S3j36cOcLfLBZjPYQ1abhfc8CqmjmFVzkk7euvWaunE57LLeDgaxm516m"
    },
    {
      "rel": "cancel",
      "method": "DELETE",
      "href": "/1/itinerary/{itinerary_id}?token=MY5S3j36cOcLfLBZjPYQ1abhfc8CqmjmFVzkk7euvWaunE57LLeDgaxm516m"
    }
  ]
}

若使用 hold 標記進行預訂，我們將不會收取任何預訂付款費用。若您在暫停期間於暫停預訂回應中加入 PUT 方法連結，系統才會完成預訂並收取付款。

取回暫停預訂

使用暫停預訂回應中提供的 retrieve 連結，便可取回暫停預訂。取回「暫停與繼續處理」預訂的方法，與單步驟預訂的一般取回方法不同，且無需要求的本文。

回應案例：

• 取回狀態仍為暫停的暫停預訂，會傳回具備有限資料的回應，這些資料包括可立即繼續處理及完成或取消預訂的連結。
• 取回已取消 (已依要求復原) 或逾時 (已自動復原) 的暫停預訂，會傳回 “itinerary not found” (找不到行程) 的錯誤訊息。
• 取回先前已繼續處理並確認的暫停預訂，其運作方式與標準行程取回相同，且將會傳回完整的預訂詳細資料。

暫停預訂的取回回應範例

{
    "itinerary_id": "8701934321257",
    "creation_date_time": "2018-03-09T14:42:58.159Z",
    "links": {
        "resume": {
            "method": "PUT",
            "href": "/2/itineraries/8701934321257?token=QldfCGlcUA…{example trimmed for length}="
        },
        "cancel": {
            "method": "DELETE",
            "href": "/2/itineraries/9700934721257?token=QldfCGlcUA…{example trimmed for length}="
        }
    }
}

已取消/逾時的暫停預訂取回回應範例

{
  "type": "resource_not_found",
  "message": "Itinerary was not found with provided request."
}

繼續處理暫停預訂

若要確認狀態已設為暫停的預訂並完成付款，則必須繼續處理預訂。

使用原始暫停預訂回應中提供的 resume 連結，便可繼續處理已執行的暫停預訂，且無需要求的本文。

回應案例：

• 繼續處理狀態仍為暫停的暫停預訂可完成預訂，並傳回表示順利完成的 HTTP 204 - 無內容回應。使用初始暫停預訂回應中的 GET 連結，可取回完整行程。
• 取回已取消 (已依要求復原) 或逾時 (已自動復原) 的暫停預訂，會傳回先前取回章節取所述的同一個 “itinerary not found” (找不到行程) 錯誤訊息。
• 若繼續處理已成功繼續處理的暫停預訂，系統便會傳回表示預訂已確認的錯誤訊息。

已繼續處理的預訂繼續處理回應範例

{
  "type": "resume.already_committed",
  "message": "Booking has already been committed."
}

取消暫停預訂 (復原)

預訂建立和取回回應中提供的 cancel Token 化連結，會在行程層級運作。使用此連結，會將要求的飯店解除暫停狀態，並復原暫停的行程。系統只會在成功繼續處理預訂後，才會於「取回」回應中提供客房層級取消連結。

若執行 cancel 操作，系統也會傳回 HTTP 204 狀態碼，與成功繼續處理回應傳回的相同。兩個狀態都使用 HTTP 204 訊息表示伺服器已成功履行要求，且不需在回應承載本文傳送其他內容。

要求取消暫停的預訂會導致最終情況相同，就如同系統已允許自動復原預訂一樣。

回應案例：

• 取消狀態仍為暫停的暫停預訂，會將可訂空房解除暫停狀態並傳回 HTTP 204 狀態
• 取消已取消 (已依要求復原) 或逾時 (已自動復原) 的暫停預訂，將會傳回本頁面前段所述的 “itinerary not found” (找不到行程) 錯誤訊息 
•   取消已成功繼續處理的暫停預訂，會傳回 itinerary level cancel not supported (不支援在行程層級取消) 錯誤訊息。發出「取回」呼叫並使用回應中提供的客房層級連結，可取消個別客房。

已繼續處理的預訂取消回應範例

{
  "type": "resume.itinerary_level_cancel_not_supported",
  "message": "Itinerary level cancel on confirmed booking is not supported."
}