B2B 純訂房啟動條件
下列啟動條件適用於所有使用企業對企業 (B2B) 整合模型的 EPS 合作夥伴，也就是旅客會與您的旅行社專員互動的整合模型。
簡介
這些需求分為兩個部分，以最佳支援您的整合體驗：
- **B2B 純訂房需求：**下列要求僅針對此預訂流程。請仔細閱讀這些要求，因為這些要求可能與您之前整合的任何其他價格類型/預訂流程不同。
- **常見要求：**這些要求在所有預訂流程中都很常見。請確保在所有流程中滿足所有這些要求。
清單
您可以找到一份清單來幫助支援您的開發或提供有關此連結要求的意見反應。如果您要為您的網站審核提供螢幕截圖，請在清單中新增螢幕截圖和相對應的日誌，因為這將有助於我們完成您的審核。
B2B 純訂房需求
GR3：下游合作夥伴必須同意 EPS 存取 EPS 庫存的使用條款。
為使用者/旅客訂房的旅行社專員，必須同意 EPS 的下游合作夥伴協議。應提供下游合作夥伴協議的連結，以供旅行社專員在預訂前審閱和接受。其他版本可在此處取得。
常見要求
以下啟動條件適用於所有預訂流程中的所有 EPS 合作夥伴。每種價格類型的特定附加要求，包括價格顯示的詳細說明，均在單獨的價格要求列表中提供。
GR1：不使用 Expedia Group 或 EPS 名稱和標誌。
Expedia Group/EPS 的任何名稱或標誌皆不得在任何面向旅客的合作夥伴網站上基於任何用途使用。任何例外情況 (例如旅客評論) 必須事先得到 EPS 的批准，並以書面形式明確同意。
範例：
GR2：要呈現的 EPS 條款和條件連結。
在您的網站中的條款和條件內容中提供 EPS 的條款和條件連結，或直接從您的預訂頁面連結到條款。這些條款詳細說明了管理預訂的規定。使用連結措辭「供應商條款和條件」將以下連結放在容易尋找的位置。
範例：
GR4：EPS MOR - 適當的使用並顯示信用卡規定。
您取得、使用、傳輸、儲存或處理旅客信用卡持卡人的資料時，您將遵守 PCI 安全標準委員會所發布的支付卡產業資料安全性標準 (PCI DSS)。相關規定的完整參考資料位於 PCI 安全標準官方網站上。
GR5：EPS MOR 或入住時付款 - 為適用合作夥伴提供 PCI 合規辨識項。
若 EPS 或該住宿是紀錄商戶，則必須提供合規證明 (AOC) 做為 PCI 合規的證據。EPS 合作夥伴必須使用 PCI 安全標準委員會的自我評估問卷檔案「SAQ D - Merchants」來產生適用的 AOC。
您可以檢查 SAQ 的相關指示和規定，並查看 PCI 安全標準官方文件庫中的「SAQ D - Merchants」檔案，或直接將 SAQ D - Merchants 檔案下載為 GR 或 Word 文件。
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 且未回傳取消規定時，客房應標記為不得退款。
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, and 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是免費取消期限，如果是未來的時間軸，最晚cancel_penalties.[].end之後的房價 100% 不得退款。
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：在價格明細中單獨顯示住宿應支付的費用。
當收費傳回到費用陣列時，將每個值分別顯示為住宿應支付的費用 (入住或退房)。這些費用由住宿直接收取 (非 EPS 或當地政府)，且不屬於「稅金和其他費用」行中包含的標準應繳稅款、稅金或費用。
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：如果適用，必須重申兒童年齡。
若整合允許兒童房客入住，且旅客為所選擇的客房指定兒童房客，您必須在訂房頁面上清楚確認兒童房客的人數與其年齡。此資料可透過 occupancy 元素取得。
BP8：EPS MOR 或入住時付款：說明何時從旅客處收取款項。
如果是 EPS MOR，必須聲明旅客提供的信用卡將立即支付訂房的完整金額。
如果是入住時付款，必須聲明旅客提供的信用卡將由住宿方在入住或退房時收款。若住宿提供不得退款的後付房價，則應該標示住宿將在旅客完成訂房後立即收取費用。
BP9：遵守歐洲經濟區法規：支付服務指令 2 (PSD2)。
任何打算與歐洲經濟區 (EEA) 的旅客進行交易的合作夥伴都需要遵守 PSD2。請點這裡了解更多。
EPS MOR 或入住時付款。
如果 EPS 是紀錄商戶或入住時付款是用於歐洲旅客，則預訂路徑必須包括採用 Rapid 的 API 進行雙重身分驗證。
聯盟夥伴 MOR - 一般
當與旅客的交易在法規範圍內時，合作夥伴必須遵守 PSD2 法規的嚴格顧客驗證機制 (SCA) 要求。該指示的完整文件內容可在歐盟委員會獲得。更多可採用的合規標準資訊，請參閱 EMVCo 的《3D 安全協議和核心功能規範》。
聯盟夥伴 MOR - 公司卡或虛擬卡。
使用於 EEA 國家/地區發行的合作夥伴卡支付 EPS 的合作夥伴必須遵守 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：EPS MOR 或入住時付款 Premium – 結帳頁面上顯示的付款處理位置。
若交易時 EPS 或住宿為紀錄商戶，必須將進行付款手續的國家標示於付款頁面顯眼處。「將進行付款手續」的文字必須插入在國家/地區名稱前方。
使用購物 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"使用者介面範例：
