B2B 純訂房啟動條件
如果您使用 business-to-business (B2B) 整合模型，其中旅行者與您的某家旅行社互動，則適用這些啟動要求。
簡介
B2B 啟動要求分為兩部分：
**B2B SA 要求：**這些是特定於此預訂流程的。請仔細閱讀這些要求，因為這些要求可能與您之前整合的任何其他價格類型/預訂流程不同。
**常見要求：**這些要求在所有預訂流程中都很常見。請確保在所有流程中滿足所有這些要求。
清單
您可以找到一份清單來幫助支援您的開發或提供有關要求的回饋。如果您要為您的網站審核提供螢幕截圖，請在清單中新增螢幕截圖和相對應的日誌，因為這將有助於我們完成您的審核。
B2B SA 特定要求
常見啟動要求
以下啟動要求適用於所有預訂流程的所有合作夥伴。每種價格類型的特定附加要求，包括價格顯示的詳細說明，均在單獨的價格要求列表中提供。
GR1：使用我們的名稱和標誌
我們的名稱和標誌只能在 traveler-facing 或 agent-facing 網站上使用，但需事先獲得我們明確的書面批准。
範例：
GR2：顯示我們的條款和條件的連結 URL
在您網站自己的條款和條件文字中提供指向我們條款和條件的鏈接，或直接從您的預訂頁面鏈接到條款。這些條款詳細說明了管理預訂的規定。將以下連結放置在 easy-to-find 位置，使用連結措辭「供應商條款和條件」。您可以找到英文版和其他版本在 Expedia 合作夥伴解決方案上。
範例：
GR4：我們的 Merchant 記錄 (MoR)：正確使用和展示有關信用卡的規定
當您取得、使用、傳輸、儲存或處理旅行者持卡人資料時，您必須遵守 PCI 安全標準委員會發布的支付卡產業資料安全標準。這些法規的完整參考資料可在官方PCI 安全標準委員會網站。
GR5：MoR 或財產收集在哪裡：為適用合作夥伴提供的 PCI 合規證據
無論我們是 Mor 還是該物業是 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=falseShopping 可用性回應中的 指示。當可用性回應中傳回 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物件的內容，如 Content 屬性定義中傳回的屬性。此資訊必須顯示在您的可用性頁面上，以確保旅客了解辦理登機手續時的任何潛在費用或特殊存取說明。
特殊的 check-in 欄位可能包含對 check-in 至關重要的訊息，而這些訊息未包含在 checkin物件的說明欄位中，例如要求通知飯店預計到達時間、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.
<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：顯示 check-in 和特殊 check-in 指令
必須為每個客房顯示 checkin、checkout、fees 和 policies物件的內容，如 Content 屬性定義中傳回的屬性。必須顯示此資訊以確保旅客在完成預訂之前了解 check-in 的任何潛在費用或特殊訪問說明。
特殊的 check-in 欄位可能包含對 check-in 至關重要的訊息，而這些訊息未包含在 checkin物件的說明欄位中，例如要求通知飯店預計到達時間、check-in 與客房大樓不同的位置，或透過房間提醒飯店發送特殊 #sdnftrz。
確保在同一區域內向旅客顯示 instructions 和 special_instructions。
BP3：取消政策和 non-refundable 標籤清楚顯示
在允許旅客在最終預訂頁面上確認購買之前，您必須為所選的客房或房間提供取消政策或 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% non-refundable。
API 回應範例：取消政策和 non-refundable 標誌
"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：在價格明細中單獨顯示飯店應付的費用
當收費傳回到費用陣列時，將每個值分別顯示為住宿應支付的費用 (入住或退房)。向旅行者出示當地貨幣並索取貨幣。這些費用由飯店直接收取 (而不是由我們或地方政府收取)，不屬於稅金項目中包含的標準稅金恢復費用、稅金或費用。
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：遵守強客戶身份驗證 (SCA) 法規
監管機構和卡片網路正在引入新的要求，以加強線上支付的安全性並保護消費者免受詐騙。許多法規都要求在線上支付時使用強客戶身份驗證 (SCA)。
BP10：我們是 MoR–check-out 頁面上顯示的付款處理地點
我們是 MoR，處理付款的國家必須在 check-out 頁面的顯著位置顯示。這句話_「此付款將在」處理_必須插入國家名稱之前。
使用購物 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"使用者介面範例：
