B2B 純訂房啟動條件
這些啟動要求適用於所有具有 business-to-business (B2B) 整合模型的合作夥伴，其中最終客戶與您的某個旅行社互動。
簡介
B2B 啟動要求分為兩部分：
B2B SA 要求 - 這些是特定於此預訂流程的。請仔細閱讀這些要求，因為這些要求可能與您之前整合的任何其他價格類型/預訂流程不同。
共同要求 - 這些要求在所有預訂流程中都是共同的。請確保在所有流程中滿足所有這些要求。
清單
您可以在此處找到一份清單來幫助支援您的開發或提供有關要求的回饋。如果您要為您的網站審核提供螢幕截圖，請在清單中新增螢幕截圖和相對應的日誌，因為這將有助於我們完成您的審核。
B2B SA 特定要求
常見啟動要求
以下啟動要求適用於所有預訂流程中的所有 Expedia Group 合作夥伴。每種價格類型的特定附加要求，包括價格顯示的詳細說明，均在單獨的價格要求列表中提供。
GR1：使用 Expedia Group 名稱和徽標
Expedia Group 名稱和標誌僅可在客戶或 agent-facing 網站上使用，但需事先獲得 Expedia Group 的明確書面批准。
範例：
GR2：顯示指向 Expedia Group 條款和條件 URL 的鏈接
在您網站自己的條款和條件文本中提供 Expedia Group 條款和條件的鏈接，或直接從您的預訂頁面鏈接到條款。這些條款詳細說明了管理預訂的規定。使用連結措辭「供應商條款和條件」將以下連結放在容易尋找的位置。英文版本這裡列出了其他版本這裡。
範例：
GR4：Expedia Group MoR：正確使用並顯示有關信用卡的規定
當您取得、使用、傳輸、儲存或處理最終客戶的持卡人資料時，您應遵守由PCI 安全標準委員會。這些法規的完整參考資料可在官方PCI 安全標準委員會網站。
GR5：Expedia Group MoR 或財產收集：為適用合作夥伴提供的 PCI 合規性證據
當 Expedia Group 或財產是 MoR 時，必須提供合規證明 (AOC) 作為 PCI 合規性的證據。
您可以在官方PCI 安全標準委員會網站。
SP1：如果聯盟會員允許兒童參與預訂，則應實施適當的訊息傳遞和兒童年齡輸入
如果您的整合允許兒童旅行者，則您必須在辦理登機手續時提供指定每個兒童旅行者年齡的功能。此資訊透過以下方式提供occupancy物件 (請參閱下面的範例)。
當旅客指定有兒童入住時，API 回應必須內含年齡限制及/或加訂床位或嬰兒床申請等可能影響訂房費用和效力的金額。
各飯店將自行設定兒童的年齡規定。通常 17 歲以下視為兒童。有些飯店不接待未滿 18 歲的房客。
API 要求範例：
https://api.ean.com/2.4/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 標誌清晰可見
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：顯示 check-in 和特殊 check-in 指令
的內容checkin，checkout，fees，和policies必須為每個客房顯示對象，如屬性中返回的那樣內容定義。此資訊必須顯示在您的可用性頁面上，以確保客戶了解辦理入住時的任何潛在費用或特殊存取說明。
特殊入住欄位可能包含對於入住至關重要的訊息，而這些訊息未包含在 checkin 物件的說明欄位中，例如，要求通知飯店預計到達時間、在與客房大樓不同的位置辦理入住手續，或透過電子郵件提醒飯店發送特殊入住說明。
確保在同一區域內向旅客顯示 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：顯示辦理登機手續和特殊辦理登機手續的說明
必須為每個房間顯示 checkin、checkout、fees 和 policies 物件的內容，如屬性 content 定義中傳回的那樣。請務必顯示此資訊列，以確保旅客知悉入住時可能需支付的所有費用，或特別的入住指示。
特殊入住欄位可能包含對於入住至關重要的訊息，而這些訊息未包含在 checkin 物件的說明欄位中，例如，要求通知飯店預計到達時間、在與客房大樓不同的位置辦理入住手續，或透過電子郵件提醒飯店發送特殊入住說明。
確保在同一區域內向旅客顯示 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": "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：在價格明細中單獨顯示飯店應付的費用
當收費傳回到費用陣列時，將每個值分別顯示為住宿應支付的費用 (入住或退房)。向旅行者出示當地貨幣並索取貨幣。這些費用由飯店直接收取（而非 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"
}
},使用者介面範例：
標準雙人房範例](resources/reference/assets/Price_display_must_include_the_total_price_and_breakdown_of_the_taxes_and_fees.png'Standard double room example'
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": "/2.4/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"使用者介面範例：
