住宿 API 上線要求
立即開始使用 Rapid Lodging API
Rapid Lodging API 的上線要求包含適用於任何實作的情形 (不論目標對象為何)，以及針對企業對企業 (business-to-business, B2B) 或企業對消費者 (business-to-consumer, B2C) 使用情境的特定要求。請仔細閱讀這些要求，因為這些要求可能與您之前整合的任何其他價格類型/預訂流程不同。
註： 以下列出的每項要求均附有參考代碼，以協助我們的客服團隊為您提供服務。
需求
以下要求適用於任何 Lodging API 的實作。
GR1：本公司名稱及標誌之使用
除經我們事先明確書面批准之例外情況外，僅得於 traveler-facing 或 agent-facing 網站上使用我們的名稱及標誌。
使用者介面範例
GR2：將顯示指向本公司條款與細則網址的連結
請在貴網站的《使用條款》內文中提供我們《使用條款》的連結，或直接從您的預訂頁面連結至該《使用條款》。這些條款詳細說明了管理預訂的規定。請將以下連結放置於 easy-to-find 下的位置，並將連結文字設定為「供應商條款與細則」。
我們支援的所有語言版本的條款與細則，皆可於我們的支援網站上查閱。
>> 查看本地化的條款與細則中搜尋。
使用者介面範例—B2B
使用者介面範例—B2C
GR4：當 Expedia Group 擔任「登記 Merchant (MOR)」時，有關信用卡法規的正確使用與展示
凡您取得、使用、傳輸、儲存或處理旅客的持卡人資料時，必須遵守由支付卡產業 (PCI) 安全標準委員會頒布的《支付卡產業 (PCI) 資料安全標準》。
GR5：當使用旅宿進行收款，或當 Expedia Group 為主要收款人 (MOR) 時，請提供符合 PCI 規範的證明 (僅適用於相關合作夥伴)
無論是 Expedia Group 還是旅宿，根據 PCI 安全標準委員會的規定，都必須提供《合規證明書》（AOC）作為 PCI 合規性的證明。
SP1：當合作夥伴允許將兒童納入預訂時，應正確顯示相關訊息並輸入兒童年齡
若您的系統整合方案允許攜帶兒童旅客，則必須提供在辦理登機手續時指定每位兒童旅客年齡的功能。此資訊是透過occupancy 物件提供的 (請參閱下方的範例)。
當旅客指定兒童旅客時，API 回應中可能會包含年齡限制，以及／或額外住宿費或嬰兒床費用，這些費用可能會影響預訂的費用或資格。
各飯店將自行設定兒童的年齡規定。通常 17 歲以下視為兒童。有些飯店不接待未滿 18 歲的房客。
API 請求範例
https://api.ean.com/v3/properties/availability?checkin=2027-09-11
&checkout=2027-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 名成人及 2 名分別為 9 歲和 4 歲的兒童。
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 在 Shopping API 的庫存狀態回應中，庫存狀態由refundable=false 標示。當可用性回應中回傳「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 物件的內容，此內容應依照 Content 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 物件的內容，此內容係依據 Content API 旅宿定義所回傳的。必須在 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 為預訂者 (MOR)，請說明所提供的信用卡將立即被扣款，金額為預訂總額。
如果是 Property Collect，必須聲明旅客提供的信用卡將由住宿方在入住或退房時收款。如果旅宿提供的是「non-refundable post-pay」費率，則應說明旅客在完成預訂後不久，可能會被旅宿收取費用。
BP9：符合 SCA 法規
監管機構與信用卡組織正推出新規定，以強化線上支付的安全性，並保護消費者免受詐騙侵害。其中許多法規均規定，線上支付必須採用「強客戶認證」(SCA) 。
BP10：當 Expedia Group 設定為 MOR 時，check-out 頁面所顯示的付款處理地點
若 Expedia Group 為「主要營運國」(MOR) ，則必須在 check-out 頁面的顯眼位置顯示將處理該筆付款的國家。必須在國家名稱之前插入短語「」以及「This payment will be processed in」。
使用購物 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 合作夥伴解決方案網站上取得。
使用者介面範例
額外包裹費率要求
除了上述列出的通用要求外，若您在實作中加入「套裝費率」元素，還必須符合以下要求。
AP4：以專屬標籤或識別碼顯示包裹運費
您必須在客房層級上，明確標示「Expedia Group」套裝費率為套裝費率 (而非單項項目)。
使用者介面範例
BP5：價格標示必須包含總價，以及稅金與費用的明細
套裝費率的總價要求與上述常見要求有所不同。
A) 總價
套裝價格必須與運輸費用的價格合併計算，才能顯示單一的總套裝價格。這通常是透過顯示旅宿加上運費的「per-person」費用來實現的。
預訂總價必須顯示於付款頁面，供旅客查看。總價應與 API 回應相符，不允許四捨五入或貨幣轉換。
使用者介面範例
BP11：要求代理商遵守包裹費率規定
請在您的付款頁面納入核取方塊，供服務專員確認此費用是與經核准的交通工具共同銷售。
使用者介面範例
旅宿的其他收集要求
除了上述列出的常見要求外，若您要在實作中加入旅宿 collect，還必須符合以下要求。
B2C 實施細節
我們已製作一份檢查清單，旨在協助您的開發工作，或就相關需求提供回饋意見。若您在網站審查中提供了螢幕截圖，也請將這些截圖及相應的日誌一併加入檢查清單中，以協助我們完成審查。
GR10：提供適當管道以瀏覽「member-only」優惠活動
Member-only 這些優惠僅限於 closed-user 環境中銷售 (例如：透過登入網站、行動版 App 或代理商工具)。
使用者介面範例
額外包裹費率規定
除了上述列出的通用要求外，若您在實作中納入「套裝費率」元素，還必須符合以下要求。
BP5：套裝價格標示必須包含總價，以及各項稅金與費用的明細
套裝費率的總價格要求與上述常見要求有所不同。
A) 總價
套裝價格必須與運輸費合併計算，才能顯示單一的套裝總價。這通常是透過顯示旅宿加上運費的「per-person」費用來實現的。
預訂總價必須顯示於付款頁面，供旅客查看。總價應與 API 回應相符，不允許四捨五入或貨幣轉換。
使用者介面範例
關於額外裸露封裝費率的規定
除了上述列出的通用要求外，若您在實作中納入「公開套件費率」元素，還必須符合以下要求。
旅宿的其他收集要求
除了上述列出的通用要求外，若您在實作中納入「公開套件費率」元素，還必須符合以下要求。