住宿 API 上線要求
立即開始使用 Rapid Lodging API
Rapid Lodging API 的上線要求包含適用於所有實作的情形 (不論目標對象為何)，以及針對企業對企業 (business-to-business, B2B) 或企業對消費者 (business-to-consumer, B2C) 使用情境的特定要求。請仔細閱讀這些要求，因為這些要求可能與您之前整合的任何其他價格類型/預訂流程不同。
註： 以下列出的每項要求均附有參考代碼，以協助我們的客服團隊為您提供服務。
需求
以下要求適用於任何住宿 API 的實作。
GR1：關於本公司名稱及標誌的使用
除事先獲得我們明確的書面批准外，不得在 traveler-facing 或 agent-facing 網站以外的任何地方使用我們的名稱及標誌。
使用者介面範例
GR2：顯示我們的條款與細則連結網址
請在貴網站的服務條款中加入我們服務條款的連結，或直接從預訂頁面連結至我們的服務條款。這些條款詳細說明了管理預訂的規定。請將以下連結放置於 easy-to-find 網址下，並將連結文字設定為「供應商條款與細則」。
我們支援的所有語言版本的條款與細則，均可透過此Rapid API 條款與細則頁面取得。
使用者介面範例 - B2B
使用者介面範例 - B2C
GR4：當 Expedia Group 擔任「登記 Merchant」（MOR）時，信用卡規定的正確使用與展示
凡您取得、使用、傳輸、儲存或處理旅客持卡人資料時，必須遵守由支付卡產業 (PCI) 安全標準委員會頒布的《支付卡產業 (PCI) 資料安全標準》。有關這些規定的完整參考資料，可於 PCI 安全標準委員會 () 的官方網站 查閱。
GR5：當使用旅宿進行採集，或當 Expedia Group 為主要負責方 (MOR) 時，請提供 PCI 合規證明 (僅適用於相關合作夥伴)
無論是 Expedia Group 還是旅宿，都必須提供《合規證明書》（AOC）作為 PCI 合規的證明。
您可以在 PCI 安全標準委員會 (PCI Security Standards Council) 的官方網站 上找到有關 PCI 合規性的相關建議。
SP1：當合作夥伴允許將兒童納入預訂時，應正確顯示相關訊息並輸入兒童年齡
若您的系統支援兒童旅客，您必須提供在辦理登機手續時指定每位兒童旅客年齡的功能。此資訊是透過occupancy 物件提供的 (請參閱下方的範例)。
當旅客指定兒童旅客時，API 回應中可能會包含年齡限制，以及／或額外住宿費或嬰兒床費用，這些費用可能會影響預訂的費用或資格。
各飯店將自行設定兒童的年齡規定。通常 17 歲以下視為兒童。有些飯店不接待未滿 18 歲的房客。
API 請求範例
https://api.ean.com/2.4/properties/availability?checkin=2020-09-11
&checkout=2020-09-14
¤cy=USD&language=en-US& occupancy=2-9,4 &property_id=XXXX
&country_code=XX&sales_channel=XXXX
&sales_environment=XXXX&filter=XXXX&rate_plan_count=XXXX
&rate_option=XXXX&billing_terms=XXXX&payment_terms=XXXX
&partner_point_of_sale=XXXX&platform_name=XXXXAPI 回應範例
"occupancies": {
"2-9,4" : {
"nightly": [
[使用者介面範例： 1 客房，包含 2 名成人及 3 名兒童 (年齡分別為 17 歲、2 歲及未滿 1 歲)。
AP1：每個客房皆附有床型說明
購物回應可能會傳回包含單一值或多個選項的 ``bed_groups 陣列。顯示配置陣列中的值，以說明旅客的床位選擇。
當 bed_groups` ` 陣列返回多個選項時，請針對每種床型顯示由 `Shopping` 回應提供的 price_check 連結，以便旅客進行選擇。
必須顯示訊息告知旅客，相同客房的多種床型選擇只限透過要求取得，且如果供應情況不允許，則飯店無須提供。
客房的名稱會以room_name 的形式，出現在「購物」回應的 rooms 陣列中。
API 回應範例
"property_id": "11775754",
"rooms": [
{
"id": "230434524",
"room_name": "Superior double room" ,
"rates": [
{
...
"bed_groups": {
"133243": {
"id": "133243",
"description": "Double bed" ,
"links": {...},
"configuration": [...]
},
"133242": {
"id": "133242",
"description": "2 single beds" ,
"links": {...},
"configuration": [...]
}
},使用者介面範例 - B2B
使用者介面範例 - B2C
AP2：Non-refundable 標誌清晰可見
Non-refundable 在refundable=false購物 API 的庫存狀態回應中，庫存狀況由 標示。當可用性回應中傳回「refundable=false」時，請明確標示適用之房間。此值比任何其他的規定資料優先採用。在任何情況下，飯店都不會對此訂房進行退款。
API 回應範例
"property_id": "XXXX",
"rooms":
"id": "XXXX",
"room_name": "Fairmont King",
"rates":
"id": "XXXX",
"status": "available",
"available_rooms": 4999,
"refundable": false ,
"deposit_required": false,
"merchant_of_record": "expedia",使用者介面範例 - B2B
使用者介面範例 - B2C
AP3：顯示 Check-in 及特別說明
必須針對每個客房，顯示checkin、checkout、fees 及policies 物件的內容，此定義參見內容 API 旅宿。此資訊必須顯示在您的房況頁面中，以確保旅客知悉入住時可能產生的費用或特殊入住指示。
特殊欄位「check-in」可能包含對「check-in」至關重要、但未包含在「checkin」物件的「instructions」欄位中的資訊，例如：需通知旅宿預計抵達時間、在與訪客大樓不同的地點進行「check-in」，或是提醒需透過電子郵件接收來自旅宿的特殊「check-in」指示。
確保在同一區域內向旅客顯示 instructions 和 special_instructions。
API 回應範例
"11775754": {
"property_id": "11775754",
"checkin": {
"begin_time": "16:00 PM",
"end_time": "4:00 AM",
"instructions": "Minimum age to check in is 18 years old.
<br />Extra-person charges may apply and vary depending on property policy.
<br />Government-issued photo identification and a credit card may be required at
check- in for incidental charges.
<br />Special requests are subject to availability upon check-in and
may incur additional charges. Special requests cannot be guaranteed. <ul>. ",
"special_instructions": "Front desk staff will greet guests on arrival. For more details,
please contact the property using the information on the booking confirmation.",
"min_age": 18
"checkout": {
"time": "11:00 AM"
"fees": {
"mandatory": "<p>You'll be asked to pay the following charges at the property:</p>
<ul><li>Deposit: USD 50 per day</li>
<li>Resort fee: USD 28.25 per accommodation,
per night</li></ul> The resort fee includes:<ul
><li>Pool access</li><li>Fitness center access</li><li>Fitness/yoga classes</li>
<li>Airport shuttle</li><li>Phone calls</li><li>In-room safe</li><li>Self parking</li>
<li>Valet parking</li><li>Parking</li></ul> <p>We have included all charges provided to us by the property.
However, charges can vary, for example, based on length of stay or the room you book. </p>",
"optional": "<p>The following fees and deposits are charged by the property at time of service,
check-in, or check-out. </p> <ul> <li>Breakfast fee: between USD 6 and USD 25 per person
(approximately)</li> <li>Late check-out is available for a fee (subject to availability)</li>
<li>Rollaway bed fee: USD 20.0 per night</li>
</ul> <p>The above list may not be comprehensive. Fees and deposits may not include tax
and are subject to change. </p>"
"policies": {
"know_before_you_go": "<ul> <li>Up to 2 children 12 years old and younger stay free when
occupying the parent or guardian's room, using existing bedding. </li>
<li>The property has connecting/adjoining rooms, which are subject to availability
and can be requested by contacting the property using the number on the booking
confirmation. </li> </ul>"使用者介面範例
BP1：個人資料採用 SSL 加密
發送或傳輸個人資料時，您必須使用 SSL 加密來保護客戶端瀏覽器/應用程式與您的網站之間的連接，以及與相關系統的網路通訊。敏感資料包括房客姓名、電話號碼或電子郵件、支付卡詳細資料和訂房/行程收據和確認頁面。當連接不安全時停止或重新導向連接。
BP2：顯示 Check-in 及特別說明
必須針對每個客房 (如checkin內容checkout 旅宿定義中所回傳的)，顯示fees、policies、 及 物件的內容。必須在 check-in 上顯示此資訊，以確保旅客在完成預訂前，已知悉任何潛在費用或特殊進出指引。
特殊欄位「check-in」可能包含對「check-in」至關重要、但未包含在「checkin」物件的「instructions」欄位中的資訊，例如：需通知旅宿預計抵達時間、在與訪客大樓不同的地點進行「check-in」，或是提醒預期會收到旅宿透過電子郵件發送的特殊「check-in」指示。
確保在同一區域內向旅客顯示 instructions 和 special_instructions。
BP3：取消政策及 non-refundable 標籤已清楚顯示
在允許旅客於您的最終預訂頁面確認訂單之前，您必須針對所選的客房或客房提供取消政策，或設定 non-refundable 標籤。各費率的取消政策詳見 Rapid Shopping Availability API 中的cancel_penalties 物件。
對於可退款房價，回應中包含一系列的取消規定詳細資訊。詳細資訊包括指定取消費用的開始日期和結束日期、取消費用類型和金額，以及任何適用的例外預訂日期。取消費用類型包括固定金額、住宿天數和占總費用的百分比。
| 回應 | 意思 |
|---|---|
refundable=true | 房價可全額退款。 |
refundable=true + cancel_penalties | • 在取消期限內，此費用可獲退款。 • 若為未來時間軸，最早的 cancel_penalties.[].start 即為免費取消的截止期限。• 最新消息後，比率為 100%non-refundable cancel_penalties.[].end |
refundable=false | • 此費率為 non-refundable. • 不回傳須付取消費用期限。 |
refundable=false + cancel_penalties | • 該費用可部分退還。 • cancel_penalties應與nonrefundable_date_ranges 搭配顯示，該頁面將在預訂建立後顯示此區間的入住日期為 non-refundable。 |
進一步了解如何制定取消政策。
參考：
refundable=false
- 一旦建立預訂，將立即產生不可退款的金額。
cancel_penalties和nonrefundable_date_ranges將提供更多詳情。
nonrefundable_date_ranges
- 一旦建立預訂，此範圍內的住宿日期不可退款。
cancel_penalties
- 適用於
nonrefundable_date_ranges以外的住宿日期。 - 當
cancel_penalties為空或未回傳，該房價為 100% 不得退款。 - 在
cancel_penalties時間範圍內取消將產生罰款。 - 若為未來時間軸，最早的
cancel_penalties.[].start即為免費取消的截止日期。 - 根據最新消息
cancel_penalties.[].end，該比率為 100%non-refundable。
API 回應範例：取消政策與 non-refundable 標記
"property_id": "11775754",
"rooms": [
{
"id": "230434524",
"room_name": "Traditional Room (Partner:Connect Test)",
"rates":
"id": "276321199",
"status": "available",
"available_rooms": 4999,
"refundable": true,
"cancel_penalties": [
{
"start": "2020-09-10T18:00:00.000-07:00",
"end": "2020-09-11T18:00:00.000-07:00",
"amount": "76.00",
"currency": "USD"使用者介面範例
BP4：價格明細中顯示的旅宿項目需另行收費
當收費傳回到費用陣列時，將每個值分別顯示為住宿應支付的費用 (入住或退房)。請向旅客出示當地貨幣，並向其索取外幣。這些費用是由旅宿直接收取 (並非由我們或地方政府收取)，且不屬於「稅金與費用」項目中所包含的標準稅款、稅金或費用。
API 回應範例：Fees 陣列
"fees" : {
"resort_fee": {
"request_currency": {
"value": "74.97",
"currency": "USD"
},
"billable_currency": {
"value": "74.97",
"currency": "USD"
},
"scope": "per_accommodation",
"frequency": "per_night"
}
},使用者介面範例
BP5：價格標示必須包含總價，以及稅金與費用的明細
A) 總價
預訂總價必須顯示於付款頁面，供旅客查看。總價應與 API 回應相符，不允許四捨五入或貨幣轉換。最終明細必須包含客房費率 (總額或每晚)，任何額外的每晚費用 (下文所述的「property_fee」欄位所列費用除外)，所有住宿費用及稅金，應付總額，並明確列出當下支付的金額以及日後需在旅宿支付的金額。
注意： 針對B2B 或B2C 的套裝費率及公開套裝費率實作，另有價格顯示要求適用。
B) 稅金明細
價格顯示必須將tax_and_service_fee 與property_fee 的總和，以「稅金與手續費」為標題列為一行。根據法律規定，在價格明細中提及任何稅金及費用總額時，必須顯示以下確切文字。這可以以 pop-up, 的純文字、模態視窗或其他形式呈現。住宿附加費不應在結帳頁面上單獨顯示。
_「這些稅金是支付給供應商 (e.g. 合作飯店) 的稅金代收費用；詳情請參閱我們的《使用條款》。」服務費將作為處理您預訂的報酬予以保留，其中可能包含供應商收取的費用。_相關翻譯內容可於 Expedia Partner Solutions 網站 的頁面中查閱。
tax_and_service_fee所返回的金額僅包含稅務管轄區所規定的稅金與費用。
C) 合作夥伴服務和預訂費用
若 Expedia Group 同意豁免條款以允許收取額外的服務費或預訂費，該等費用必須明確區分。若貴機構在預訂中加收服務費，必須向旅客明確說明該費用是由貴機構收取，而非由 Expedia Group 針對另一項服務所收取 (即並非因提供住宿而額外收取的費用)。相關費用不得包含在現有的稅金及費用明細項目中。請勿使用「費用」一詞來描述旅宿所收取的任何費用。您也可以使用「聯盟預訂 費」或「聯盟服務費」。
注意： 針對（B2B） 或（B2C） 適用額外要求。旅宿收集並揭露包裹費率實作方案。
BP7：重申子女年齡 (如適用)
若您的系統支援兒童旅客，且旅客在客房選項中指定了兒童旅客，您必須在預訂頁面中明確確認兒童旅客的人數及其年齡。此資訊是透過child_ages 物件提供的。
使用者介面範例
BP8：說明何時向最終旅客收取費用 (適用於旅宿代收款項，或當 Expedia Group 為 MOR 時)
若 Expeda Group 為預付方， 請說明所提供的信用卡將立即被收取預訂的全額費用。
如果是 Property Collect，必須聲明旅客提供的信用卡將由住宿方在入住或退房時收款。如果旅宿採用的是 non-refundable post-pay 費率，請改為說明旅客在完成預訂後不久，可能會被旅宿收取費用。
BP9：符合 SCA 規範
監管機構與信用卡組織正推出新規定，以強化線上支付的安全性，並保護消費者免受詐騙侵害。其中許多法規均規定，線上支付必須採用「強化客戶驗證」(SCA) 。
BP10：當 Expedia Group 設定為 MOR 時，check-out 頁面顯示的付款處理地點
若 Expedia Group 為「主要營運地」(MOR) ，則必須在 check-out 頁面的顯眼位置顯示將處理付款的國家。請在國家名稱之前插入以下字樣：「此筆付款將於」。
使用購物 API 的付款選項功能以擷取此資訊。
付款選項的 API 請求範例
https://api.ean.com/<payment-options link from previous availability request>
API 回應範例
"credit_card": {
"name": "Credit Card",
"card_options": [
"name": "MasterCard",
"processing_country": "US"
"name": "Visa",
"processing_country": "US"使用者介面範例
B2B 實施細節
您可以在找到一份清單，用以協助您的開發工作，或針對 的需求提供回饋。若您在網站審查中提供了螢幕截圖，請務必將截圖及相關日誌一併加入檢查清單中，以協助我們完成審查。
GR3：下游代理商必須同意我們的《代理商條款與細則》，方可存取我們的庫存
代理商若代表旅客進行預訂，必須同意我們的下游代理商協議。應提供指向下游代理商 協議的連結，供代理商在預訂前查閱並接受。其他版本請參閱，或瀏覽 Expedia Partner Solutions 網站。
使用者介面範例
額外包裹費率要求
除了上述的常見要求外，若您在實作中加入「套裝費率」元素，還必須符合以下要求。
AP4：以專屬標籤或識別碼顯示包裹運費
您必須在客房層級明確標示「Expedia Group」套裝費率為套裝費率 (而非獨立項目)。
使用者介面範例
BP5：價格標示必須包含總價，以及稅金與費用的明細
套裝費率的總價要求與上述常見要求有所不同。
A) 總價
套裝價格必須與運輸費合併計算，以顯示單一的總套裝價格。這通常是透過顯示旅宿加上運費的 per-person 價格來實現的。
預訂總價必須顯示於付款頁面，供旅客查看。總價應與 API 回應相符，不允許四捨五入或貨幣轉換。
使用者介面範例
BP11：要求代理商遵守包裹費率規定
請在您的付款頁面納入核取方塊，供服務專員確認此費用是與經核准的交通工具共同銷售。
使用者介面範例
旅宿的其他收集要求
除了上述的常見要求外，若您要在實作中加入旅宿集合，還必須符合以下要求。
B2C 實施細節
我們已製作了一份《》檢查清單，旨在協助您的開發工作，或讓您針對相關需求提供回饋。若您在網站審查中提供了螢幕截圖，也請將這些截圖及對應的日誌加入檢查清單中，以協助我們完成審查。
GR10：提供適當管道以取得「member-only」優惠方案
Member-only 這些優惠僅限於 closed-user 環境中銷售 (例如：透過網站登入、行動版 App 或代理商工具)。
使用者介面範例
額外包裹費率要求
除了上述列出的常見要求外，若您在實作中加入套裝費率元素，還必須符合以下要求。
BP5：套裝價格顯示必須包含總價，以及稅金與費用的明細
套裝費率的總價要求與上述常見要求有所不同。
A) 總價
套裝價格必須與運輸費合併計算，以顯示單一的總套裝價格。這通常是透過顯示旅宿加上運費的 per-person 價格來實現的。
預訂總價必須顯示於付款頁面，供旅客查看。總價應與 API 回應相符，不允許四捨五入或貨幣轉換。
使用者介面範例
關於額外裸露封裝費率的規定
除了上述列出的常見要求外，若您在實作中包含公開的套件費率元素，還必須符合以下要求。
旅宿的其他收集要求
除了上述列出的常見要求外，若您在實作中包含公開的套件費率元素，還必須符合以下要求。