B2C 純訂房啟動條件
這些發布要求適用於所有採用企業對消費者 (B2C) 整合模式的 Expedia Group 合作夥伴，在這種模式下，最終客戶可以直接與您的整合互動。
簡介
這些要求分為兩部分：
- **B2C SA 要求：**下列要求僅針對此預訂流程。請仔細閱讀這些要求，因為這些要求可能與您之前整合的任何其他價格類型/預訂流程不同。
- **常見要求：**這些要求在所有預訂流程中都很常見。請確保在所有流程中滿足所有這些要求。
清單
您可以在此處找到一份清單來幫助支援您的開發或提供有關要求的回饋。如果您要為您的網站審核提供螢幕截圖，請在清單中新增螢幕截圖和相對應的日誌，因為這將有助於我們完成您的審核。
B2C 純訂房需求
常見要求
以下啟動要求適用於所有預訂流程的所有 Expedia Group 合作夥伴。每種價格類型的特定附加要求，包括價格顯示的詳細說明，均在單獨的價格要求列表中提供。
GR1：不得使用 Expedia Group 或 Expedia Group 名稱和標誌。
只有在獲得 Expedia Group 事先明確書面批准的情況下，才可以在面向客戶或代理商的網站上使用 Expedia Group 的名稱和標誌。
範例：
GR2：要顯示的 Expedia Group 條款和條件 URL 的連結。
在您網站的條款和條件文字中提供 Expedia Group 條款和條件的鏈接，或直接從您的預訂頁面鏈接到該條款。這些條款詳細說明了管理預訂的規定。使用連結措辭「供應商條款和條件」將以下連結放在容易尋找的位置。
英文版請見這裡。
其他版本請見這裡。
範例：
GR4：Expedia Group MoR - 正確使用和顯示有關信用卡的規定。
當您取得、使用、傳輸、儲存或處理最終客戶的持卡人資料時，您應遵守 PCI 安全標準委員會所頒發的 PCI DSS。這些法規的完整參考資料可在官方PCI 安全標準網站。
GR5：Expedia Group MoR 或 Property Collect - 為適用的合作夥伴提供的 PCI 合規性證據。
如果 Expedia 集團或飯店是 MoR，則必須提供合規證明 (AOC) 作為 PCI 合規性的證據。您可以在官方PCI 安全標準網站。
SP1：若合作夥伴允許訂房內包含兒童旅客，須採取適當訊息通知且須輸入兒童年齡。
如果您的整合允許兒童旅行者，則您必須在辦理登機手續時提供指定每個兒童旅行者年齡的功能。此資料可透過 occupancy 元素取得 (請看以下代碼範例)。
當旅客指定有兒童入住時，API 回應必須內含年齡限制及/或加訂床位或嬰兒床申請等可能影響訂房費用和效力的金額。
各飯店將自行設定兒童的年齡規定。通常 17 歲以下視為兒童，有些飯店不接待未滿 18 歲的房客。
API 要求範例：
https://api.ean.com/v3/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 名成人和 2 名 9 歲和 4 歲的兒童
AP1：床型說明將會顯示在各客房上。
購物回應可能會回傳 bed_groups 單一值或多個選項。顯示設定陣列中包含的值以說明旅客的床型選擇。
當 bed_groups 陣列回傳多個選項時，請顯示購物回應為各個床型提供的 price_check 連結，以便旅客選擇。
必須顯示訊息告知旅客，相同客房的多種床型選擇只限透過要求取得，且如果供應情況不允許，則飯店無須提供。
客房名稱會在購物回應的客房陣列中以 room_name 回傳。
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：不得退款標誌需清晰可見。
不可退款的空房情況以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",使用者介面範例：
AP3：顯示辦理入住與入住特別注意事項。
各客房的 checkin、checkout、fees 和 policies 物件必須與住宿內容定義回傳的結果一致。請務必將此資訊列示於供應情況頁面中，以確保旅客知悉入住時可能需支付的所有費用，或特別的入住指示。
這special_instructions欄位可能包含對辦理登機手續至關重要但未包含在checkin對象的instructions字段，例如要求通知酒店預計抵達時間、在與客房不同的地點辦理入住手續，或透過電子郵件提醒酒店提供特殊入住說明。
確保在同一區域內向旅客顯示 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：顯示辦理入住與入住特別注意事項。
各客房的 checkin、checkout、fees 和 policies 物件必須與住宿內容定義回傳的結果一致。請務必顯示此資訊列，以確保旅客知悉入住時可能需支付的所有費用，或特別的入住指示。
這special_instructions欄位可能包含對辦理登機手續至關重要但未包含在checkin對象的instructions字段，例如要求通知酒店預計抵達時間、在與客房不同的地點辦理入住手續，或透過電子郵件提醒酒店提供特殊入住說明。
確保在同一區域內向旅客顯示 instructions 和 special_instructions。
BP3：清楚顯示取消規定和不得退款標籤。
在您的最終訂房結帳頁面上允許旅客確認購買前，請針對所選客房提供取消規定/不得退款標籤。Rapid 商店供應情況 API 的 cancel_penalties 物件中提供了每個房價的取消規定。
對於可退款房價，回應中包含一系列的取消規定詳細資訊。詳細資訊包括指定取消費用的開始日期和結束日期、取消費用類型和金額，以及任何適用的例外預訂日期。取消費用類型包括固定金額、住宿天數和占總費用的百分比。
| 回應 | 意義 |
|---|---|
refundable=true | 房價可全額退款。 |
refundable=true + cancel_penalties | • 此費用在取消期限內可退還。 • 最早 cancel_penalties.[].start如果是未來的時間線，那麼免費取消的截止日期是？• 最晚預訂日期後，此價格將 100% 不退還 cancel_penalties.[].end |
refundable=false | • 此費用不可退款。 • 不回傳須付取消費用期限。 |
refundable=false + cancel_penalties | • 該費用可以部分退還。 • cancel_penalties應與 nonrefundable_date_ranges 一起顯示，顯示此範圍內的住宿日期在預訂建立後不可退款。 |
更多關於如何建構取消規定的資訊，請參見這裡。
參考：
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% 不得退款。
API 回應範例：
可全額退款：
"property_id": "XXXX",
"rooms": [
{
"id": "XXXX",
"room_name": "Traditional Room",
"rates":
"id": "XXXX",
"status": "available",
"available_rooms": 4999,
"refundable": true,
"cancel_penalties": [
{
"start": "2021-05-27T18:00:00.000-07:00",
"end": "2021-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": "2023-09-03T13:59:00.000+02:00",
"end": "2023-09-04T13:59:00.000+02:00",
"nights": "1",
"currency": "USD"
}
],
"nonrefundable_date_ranges": [
{
"start": "2023-09-08",
"end": "2023-09-13"
}
],使用者介面範例：
BP4：在價格明細中單獨顯示住宿應支付的費用。
當收費回傳到 fees 陣列時，將每個值分別顯示為住宿應支付的費用 (入住或退房)。向旅行者出示當地貨幣並索取貨幣。這些費用由飯店直接收取（而非 Expedia 集團或地方政府），不屬於稅費明細中包含的標準稅收補償費用、稅金或費用。
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 或 Property Collect：說明何時向最終旅客收取款項。
如果是 Expedia Group MoR，請說明所提供的信用卡將立即扣除預訂的全部金額。
如果是 Property Collect，必須聲明旅客提供的信用卡將由住宿方在入住或退房時收款。若住宿提供不得退款的後付房價，則應該標示住宿將在旅客完成訂房後立即收取費用。
BP9：遵守歐洲經濟區法規：支付服務指令 2 (PSD2)。
任何打算與歐洲經濟區 (EEA) 的旅客進行交易的合作夥伴都需要遵守 PSD2。請點這裡了解更多。
Expedia Group MoR 或 Property Collect。
如果 Expedia Group 是 MoR，或歐洲客戶使用 Property Collect，則預訂路徑必須包含採用 Rapid 的 API 進行雙重認證。
附屬 MoR - 一般。
當與旅客的交易在法規範圍內時，合作夥伴必須遵守 PSD2 法規的嚴格顧客驗證機制 (SCA) 要求。該指示的完整文件內容可在歐盟委員會獲得。更多可採用的合規標準資訊，請參閱 EMVCo 的《3D 安全協議和核心功能規範》。
附屬 MoR - 公司卡或虛擬卡。
使用在 EEA 境內某國家發行的合作夥伴卡向 Expedia Group 付款的合作夥伴必須遵守 PSD2 法規的要求。為了減少對 PSD2 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"
}
]
}使用者介面範例：
