B2C 純訂房啟動條件
如果您採用 business-to-consumer (B2C) 整合模型，旅行者直接與您的整合進行交互，則適用這些啟動要求。
簡介
這些要求分為兩類：
- **B2C SA 要求：**下列要求僅針對此預訂流程。請仔細閱讀這些要求，因為這些要求可能與您之前整合的任何其他價格類型/預訂流程不同。
- **常見要求：**這些要求在所有預訂流程中都很常見。請確保在所有流程中滿足所有這些要求。
清單
我們建立了一個檢查清單，以幫助您進行開發或提供有關需求的回饋。如果您要為您的網站審核提供螢幕截圖，請在清單中新增螢幕截圖和相對應的日誌，因為這將有助於我們完成您的審核。
B2C 純訂房需求
常見要求
以下上線要求適用於所有預訂流程。每種價格類型的特定附加要求，包括價格顯示的詳細說明，均在單獨的價格要求列表中提供。
GR1：禁止使用 Expedia Group 名稱和標誌。
未經我們事先明確的書面批准，不得在 traveler-facing 或 agent-facing 網站上使用我們的名稱和標誌。
範例：
GR2：顯示我們的條款和條件網址的連結。
在您的網站條款和條件文字中提供指向我們條款和條件的鏈接，或直接從您的預訂頁面提供指向條款的鏈接。這些條款詳細說明了管理預訂的規定。使用連結措辭「供應商條款和條件」將以下連結放在容易尋找的位置。
你可以找到英文版和其他版本已列入 Expedia Partner Solutions。
範例：
GR4：Expedia Group 是記錄商家 (MoR)：正確使用和顯示信用卡法規。
無論何時，只要您取得、使用、傳輸、儲存或處理旅客的持卡人數據，您都應遵守支付卡產業資料安全標準 (PCI DSS)，該標準由支付卡產業安全標準委員會發布。這些規定的完整參考資料可在官方網站上查閱。 PCI 安全標準網站。
GR5：Expedia Group 是 MoR 或 Property Collect：在適用情況下提供 PCI 合規性證明。
如果 Expedia Group 或該屬性為 MoR，則必須提供合規性證明 (AOC) 作為 PCI 合規性的證據。您可以在官方網站上找到有關 PCI 合規性的建議。 PCI 安全標準網站。
SP1：若合作夥伴允許訂房內包含兒童旅客，須採取適當訊息通知且須輸入兒童年齡。
如果您的整合允許兒童旅客，則必須提供在 check-in 時指定每個兒童旅客年齡的功能。此資料可透過 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購物響應中提供了每種床型的鏈接，以便旅行者進行選擇。
必須顯示訊息告知旅客，相同客房的多種床型選擇只限透過要求取得，且如果供應情況不允許，則飯店無須提供。
客房名稱在購物回應的 rooms 陣列中傳回，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：不得退款標誌需清晰可見。
Non-refundable 的可用性由以下方式指示：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必須顯示返回的每個客房中的對象內容屬性定義。此資訊必須顯示在您的可用性頁面上，以確保旅客了解 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：顯示辦理入住與入住特別注意事項。
對於每個客房，必須顯示 checkin、checkout、fees 和 policies物件的內容，這些內容在 Content 屬性定義中傳回。必須顯示此訊息，以確保旅客在最終預訂之前了解 check-in 的任何潛在費用或特殊訪問說明。
special_instructions欄位可能包含對 check-in 至關重要的訊息，而這些訊息並未包含在 checkin物件的 instructions欄位中，例如需要通知飯店預計到達時間、check-in 位於與客房不同的位置，例如需要通知飯店預計到達時間、check-in 位於與客房不同的位置。
確保在同一區域內向旅客顯示 instructions 和 special_instructions。
BP3：清楚顯示取消規定和不得退款標籤。
在允許旅客在最終預訂頁面上確認購買之前，您必須提供所選客房或房間的取消政策或 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% 不得退款。
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 陣列時，將每個值分別顯示為住宿應支付的費用 (入住或退房)。向旅客出示當地貨幣並索取兌換金額。這些費用由物業直接收取 (不是由我們或地方政府收取)，且不屬於稅費項下的標準稅收回收費用、稅金或收費。
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 是 MoR，則表示提供的信用卡將立即收取預訂的全額款項。
如果是 Property Collect，必須聲明旅客提供的信用卡將由住宿方在入住或退房時收款。如果飯店以 non-refundable post-pay 價格收費，則應說明旅客在完成預訂後不久可能會被飯店收取費用。
BP9：遵守歐洲經濟區法規：支付服務指令 2 (PSD2)。
如果您打算與歐洲經濟區 (EEA) 的旅客進行交易，則必須遵守 PSD2 法規。
Expedia Group 是 MoR 或 Property Collect。
如果 Expedia Group 是 MoR，或對歐洲旅客使用 Property Collect，則預訂路徑必須包含採用 Rapid 的 API 進行 two-factor 驗證。
附屬機構 MoR - 通用。
當與旅客進行的交易屬於 PSD2 法規的適用範圍時，您必須遵守 PSD2 法規中的強客戶認證 (SCA) 要求。該指示的完整文件內容可在歐盟委員會獲得。更多可採用的合規標準資訊，請參閱 EMVCo 的《3D 安全協議和核心功能規範》。
附屬 MoR - 公司卡或虛擬卡。
如果您使用在歐洲經濟區 (EEA) 國家/地區發行的銀行卡向我們付款，則您必須遵守 PSD2 法規的要求。為了減少對 PSD2 2FA 的需求，您可以使用符合 B2B 支付標準且免於 2FA (two-factor 驗證) 的卡片。
合規選項包括：
- 一次性虛擬卡。
- 在公司 (非個人) 註冊的多用途公司卡。需要特殊設定檔。
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"
}
]
}使用者介面範例：
