Rapid Lodging API：B2C 獨立版上線要求
若您採用的是「business-to-consumer (B2C)」整合模式，且旅客會直接透過您的整合系統進行互動，則這些上線要求即適用。
簡介
這些要求已分為兩個部分：
獨立需求 這些需求專屬於此預訂流程。請仔細閱讀這些要求，因為這些要求可能與您之前整合的任何其他價格類型/預訂流程不同。
常見要求 這些要求在所有預訂流程中都很常見。請確保在所有流程中滿足所有這些要求。
註 以下列出的每項要求均附有參考代碼，以協助我們的客服團隊為您提供服務。
清單
我們已製作了一份《》檢查清單，旨在協助您的開發工作，或讓您針對相關需求提供回饋。若您在網站審查中提供螢幕截圖，請務必將截圖及相關日誌一併加入檢查清單中，以協助我們完成審查。
B2C 系統建置
常見要求
以下上線要求適用於所有預訂流程。每種價格類型的特定附加要求，包括價格顯示的詳細說明，均在單獨的價格要求列表中提供。
GR1：不得使用 Expedia Group 的名稱及標誌
除事先獲得我們明確的書面批准外，不得在 traveler-facing 或 agent-facing 網站以外的任何網站上使用 我們的名稱及標誌。
範例：
GR2：顯示我們的使用條款連結
請在貴網站的服務條款中加入我們服務條款的連結，或直接從預訂頁面連結至我們的服務條款。這些條款詳細說明了管理預訂的規定。請將以下連結放置於 easy-to-find 網址下，並將連結文字設定為「供應商條款與細則」。
我們支援的所有語言版本的條款與細則均可由此處取得 Rapid API 條款與細則頁面。
範例：
GR4：當 Expedia Group 擔任記錄商 (MoR) 時，信用卡法規的正確使用與展示
無論您是在何處取得、使用、傳輸、儲存或處理旅客的持卡人資料，均應遵守由支付卡產業安全標準委員會 (PCI Security Standards Council) 頒布的《支付卡產業資料安全標準》(PCI DSS) 。這些規定的完整參考資料可於官方網站查閱 PCI 安全標準網站。
GR5：請提供旅宿款項的 PCI 合規證明，或當 Expedia Group 為 MoR 時 (如適用)
若 Expedia Group 或旅宿為 MoR，則必須提供《合規證明書》（AOC）作為 PCI 合規的證明。您可以在官方網站上找到有關 PCI 合規性的建議 PCI 安全標準網站。
SP1：若預訂中包含兒童，請實施適當的提示訊息並正確輸入兒童年齡
如果您的整合系統允許攜帶兒童旅客，您必須提供在預訂時指定每位兒童旅客年齡的功能 check-in. 此資料可透過 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：顯示每個客房的床型說明
購物 API 的回應 可能會傳回包含單一值或多個選項的 ``bed_groups 陣列。顯示配置陣列中的值，以說明旅客的床位選擇。
當 bed_groups` ` 陣列返回多個選項時，請顯示購物回應中針對每種床型提供的 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": [...]
}
},使用者介面範例：
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",使用者介面範例：
AP3：顯示 check-in 及特殊說明
必須針對每個客房，顯示checkin、checkout、fees 及policies 物件的內容，這些內容是根據內容 旅宿定義所返回的。此資訊必須顯示於您的「房況」頁面，以確保旅客知悉 check-in 上的任何潛在費用或特殊入住說明。
special_instructions欄位可能包含對 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.
Extra-person charges may apply and vary depending on property policy.
Government-issued photo identification and a credit card may be required at
check-in for incidental charges.
Special requests are subject to availability upon check-in and
may incur additional charges. Special requests cannot be guaranteed.",
"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": "You'll be asked to pay the following charges at the property:
Deposit: USD 50 per day
Resort fee: USD 28.25 per accommodation, per night The resort fee includes: Pool access, Fitness center access, Fitness/yoga classes, Airport shuttle, Phone calls, In-room safe, Self parking, Valet parking, Parking. 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.",
"optional": "The following fees and deposits are charged by the property at time of service,
check-in, or check-out. Breakfast fee: between USD 6 and USD 25 per person
(approximately), Late check-out is available for a fee (subject to availability)Rollaway bed fee: USD 20.0 per night.
The above list may not be comprehensive. Fees and deposits may not include tax and are subject to change."
"policies": {
"know_before_you_go": "Up to 2 children 12 years old and younger stay free when
occupying the parent or guardian's room, using existing bedding.
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."使用者介面範例：
BP1：對個人資料使用 SSL 加密
發送或傳輸個人資料時，您必須使用 SSL 加密來保護客戶端瀏覽器/應用程式與您的網站之間的連接，以及與相關系統的網路通訊。個人資料包括房客姓名、電話號碼或電子郵件、支付卡詳細資料和訂房/行程收據和確認頁面。當連接不安全時停止或重新導向連接。
BP2：顯示 check-in 及特別說明
必須針對每個客房，顯示checkin、checkout、fees 及policies 物件的內容，這些內容是根據內容 旅宿定義所返回的。必須在旅客完成預訂前，於 check-in 網站上顯示此資訊，以確保旅客知悉任何潛在費用或特殊進出指引。
special_instructions欄位可能包含對 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：預訂一經建立，即會立即產生一筆 non-refundable 的費用。請參閱cancel_penalties 及nonrefundable_date_ranges 以獲取更多詳情。
nonrefundable_date_ranges: 一旦預訂成立，此區間的入住日期將為 non-refundable。
cancel_penalties：
- 適用於
nonrefundable_date_ranges以外的住宿日期。 - 當
cancel_penalties為空或未回傳，該房價為 100% 不得退款。 - 在
cancel_penalties時間範圍內取消將產生罰款。 - 最早的
cancel_penalties.[].start是免費取消期限，如果是未來的時間軸，最晚cancel_penalties.[].end之後的房價 100% 不得退款。
API 回應範例：
可全額退款：
"property_id": "XXXX",
"rooms": [
{
"id": "XXXX",
"room_name": "Traditional Room",
"rates":
"id": "XXXX",
"status": "available",
"available_rooms": 4999,
"refundable": true,
"cancel_penalties": [
{
"start": "2027-05-27T18:00:00.000-07:00",
"end": "2027-05-28T18:00:00.000-07:00",
"amount": "76.00",
"currency": "USD"不得退款：
"property_id": "XXXX",
"rooms":
"id": "XXXX",
"room_name": "Traditional Room",
"rates":
"id": "XXXX",
"status": "available",
"available_rooms": 4999,
"refundable": false ,
"deposit_required": false,
"merchant_of_record": "expedia",可部分退款：
"property_id": "XXXX",
"rooms": [
{
"id": "XXXX",
"room_name": "Traditional Room",
"rates":
"id": "XXXXXXXX",
"status": "available",
"available_rooms": 4999,
"refundable": false,
"cancel_penalties": [
{
"start": "2027-09-03T13:59:00.000+02:00",
"end": "2027-09-04T13:59:00.000+02:00",
"nights": "1",
"currency": "USD"
}
],
"nonrefundable_date_ranges": [
{
"start": "2027-09-08",
"end": "2027-09-13"
}
],使用者介面範例：
BP4：請在價格明細中，將旅宿的應付費用單獨列出
當收費回傳到 fees 陣列時，將每個值分別顯示為住宿應支付的費用 (入住或退房)。請向旅客出示當地貨幣，並向其索取外幣。 這些費用是由旅宿直接收取 (而非由我們或地方政府收取)，並不屬於「稅金與費用」項目中所包含的標準稅款、稅金或費用。
API 回應範例：
"fees" : {
"resort_fee": {
"request_currency": {
"value": "74.97",
"currency": "USD"
},
"billable_currency": {
"value": "74.97",
"currency": "USD"
},
"scope": "per_accommodation",
"frequency": "per_night"
}
},使用者介面範例：
BP7：再次確認兒童年齡 (如適用)
若您的系統支援兒童旅客，且旅客在客房選項中指定了兒童旅客，您必須在預訂頁面中明確確認兒童旅客的人數及其年齡。此資料可透過 child_ages 元素取得。
BP8：請說明何時向最終旅客收取費用 (若為旅宿收費，或當 Expedia Group 為 MoR 時)
若 Expedia Group 為預付金來源，請說明所提供的信用卡將立即被收取預訂的全額費用。
如果是 Property Collect，必須聲明旅客提供的信用卡將由住宿方在入住或退房時收款。如果旅宿提供的是「non-refundable post-pay」費率，請改為說明旅客在完成預訂後不久，可能會被旅宿收取費用。
BP9：遵守歐洲經濟區法規。
若您打算與歐洲經濟區 (EEA) 的旅客進行交易，則必須符合「強化客戶驗證」（SCA）的規範。
Expedia Group 是 MoR 還是旅宿集合
若 Expedia Group 為預訂來源 (MoR)，或旅宿 Collect 用於歐洲經濟區 (EEA) 或日本的旅客，預訂路徑必須包含採用 Rapid 的 API 進行two-factor 驗證。
附屬 MoR - 概論
當與旅客進行的交易屬於該法規的適用範圍時，您必須遵守《》SCA 要求 ()。修訂版《支付服務指令》（PSD2）的完整文本可於以下網址查閱： 歐洲委員會。有關可採用的合規標準的進一步資訊，請參閱 EMVCo 的 3D Secure 協定與核心功能規範。
合作夥伴 MoR - 企業卡或虛擬卡
若您使用在歐洲經濟區 (EEA) 或日本境內發行的個人信用卡向我們付款，則必須遵守《支付服務指令》（）的強化身份驗證 (SCA) 要求。為減少對「two-factor」雙因素驗證 (2FA) 的需求，您可以使用符合 B2B 支付規範且豁免 2FA 要求的卡片。
合規選項包括：
- 一次性 虛擬卡。
- 在公司 (非個人) 註冊的多用途公司卡。需要特殊的配置設定。
API 要求範例：
https://api.ean.com<Price Check link from previous availability request>API 回應範例：
{
"status": "available",
"occupancy_pricing": {... },
"links": {
"payment_session": {
"method": "POST",
"href": "/v3/payment-sessions?token=XXXX"
}
}
}BP10：當 Expedia Group 設定為 MoR 時，在結帳頁面顯示付款處理地點
若 Expedia Group 位於某個國家或地區 (MoR)，則結帳頁面上必須在顯眼處顯示將處理付款的國家。「將進行付款手續」的文字必須插入在國家名稱前方。
使用購物 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"
}
]
}使用者介面範例：
