Your EPS account
Sign in to view secure API documentation, update your account details, log support requests and much more.
Your email or password is incorrect. Please try again or reset your password.
If the issue persists please contact your EPS representative.
Reset your password
Please enter your email address below. We will send password reset instructions to the email associated with your EPS account.
Thank you
An email has been sent to your account email address with further instructions on how to reset your password.
什麼是暫停與繼續處理?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." }
EPS Home | EPS Portal Login | Expedia Partner Central | Advertise with Expedia | News | Privacy Policy | Cookie Policy
© 2020 Expedia, Inc. All Rights Reserved.