B2C 純訂房啟動條件
如果您擁有 business-to-consumer (B2C) 整合模型，旅行者可直接與您的整合進行交互，則適用這些啟動要求。
簡介
這些要求分為兩部分：
- **B2C SA 要求：**下列要求僅針對此預訂流程。請仔細閱讀這些要求，因為這些要求可能與您之前整合的任何其他價格類型/預訂流程不同。
- **常見要求：**這些要求在所有預訂流程中都很常見。請確保在所有流程中滿足所有這些要求。
清單
我們創建了一個清單來幫助支援您的開發或提供有關要求的回饋。如果您要為您的網站審核提供螢幕截圖，請在清單中新增螢幕截圖和相對應的日誌，因為這將有助於我們完成您的審核。
B2C 純訂房需求
常見要求
以下啟動要求適用於所有預訂流程。每種價格類型的特定附加要求，包括價格顯示的詳細說明，均在單獨的價格要求列表中提供。
GR1：禁止使用 Expedia Group 名稱和識別。
我們的名稱和標誌只能在 traveler-facing 或 agent-facing 網站上使用，但需事先獲得我們明確的書面批准。
範例：
GR2：顯示我們的條款和條件 URL 的連結。
在您網站自己的條款和條件文字中提供指向我們條款和條件的鏈接，或直接從您的預訂頁面鏈接到條款。這些條款詳細說明了管理預訂的規定。使用連結措辭「供應商條款和條件」將以下連結放在容易尋找的位置。
您可以找到英文版和其他版本已在 Expedia Partner Solutions 上列出。
範例：
GR4：我們是記錄商家 (MoR)：正確使用和展示有關信用卡的規定。
當您取得、使用、傳輸、儲存或處理旅客持卡人資料時，您應遵守 PCI 安全標準委員會發布的支付卡產業資料安全標準 (PCI DSS)。這些法規的完整參考資料可在官方PCI 安全標準網站。
GR5：我們是 MoR 或 Property Collect：在適用的情況下提供 PCI 合規性證據。
如果我們或該財產是 MoR，則必須提供合規證明 (AOC) 作為 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購物響應為每種床型提供鏈接，以允許旅行者進行選擇。
必須顯示訊息告知旅客，相同客房的多種床型選擇只限透過要求取得，且如果供應情況不允許，則飯店無須提供。
客房名稱在購物回應的房間陣列中傳回為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 與客房大樓的不同位置，或透過電子郵件提醒飯店發出特殊空間。
確保在同一區域內向旅客顯示 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 與客房大樓的不同指示
確保在同一區域內向旅客顯示 instructions 和 special_instructions。
BP3：清楚顯示取消規定和不得退款標籤。
在允許旅客在最終預訂頁面上確認購買之前，您必須提供所選客房或房間的取消政策或 non-refundable 標籤。快速購物可用性 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：我們是 MoR 或 Property Collect：說明何時向最終旅客收取付款。
如果我們是 MoR，請說明將立即從所提供的信用卡中扣除全額預訂費用。
如果是 Property Collect，必須聲明旅客提供的信用卡將由住宿方在入住或退房時收款。如果飯店提供 non-refundable post-pay 價格，請註明旅客在完成預訂後不久可能會被飯店收取費用。
BP9：遵守歐洲經濟區法規：支付服務指令 2 (PSD2)。
如果您打算與歐洲經濟區 (EEA) 的旅客進行交易，則必須遵守 PSD2。
我們是 MoR，也就是 Property Collect。
如果我們是 MoR，或歐洲旅客使用 Property Collect，則預訂路徑必須包括採用 Rapid 的 API 進行 two-factor 驗證。
附屬 MoR - 一般。
當與旅客的交易屬於法規範圍時，您必須遵守 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：我們是 MoR：付款處理地點顯示在結帳頁面上
在我們作為 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"
}
]
}使用者介面範例：
