快速住宿 API：B2B 獨立版上線要求
若您採用 business-to-business (B2B) 整合模式，且旅客需與貴公司的旅行代理商進行互動，則適用此發送要求。
簡介
B2B 上線要求分為兩大類：
獨立需求： 這些需求專屬於此預訂流程。請仔細閱讀這些要求，因為這些要求可能與您之前整合的任何其他價格類型/預訂流程不同。
**常見要求：**這些要求在所有預訂流程中都很常見。請確保在所有流程中滿足所有這些要求。
註： 以下所列的每項要求均包含參考代碼，以協助我們的客服團隊為您提供支援。
清單
您可在找到一份檢查清單，用以協助您的開發工作或針對需求提供反饋。如果您要為您的網站審核提供螢幕截圖，請在清單中新增螢幕截圖和相對應的日誌，因為這將有助於我們完成您的審核。
企業對企業解決方案
常見發射要求
以下上線要求適用於所有合作夥伴的所有預訂流程。每種價格類型的特定附加要求，包括價格顯示的詳細說明，均在單獨的價格要求列表中提供。
GR1：使用我們的名稱與標誌
除經我們事先明確書面批准外，僅可在 traveler-facing 或 agent-facing 網站上使用我們的名稱和標誌。
範例：
GR2：連結至我們的條款與細則網址，該網址將顯示於頁面中
請在貴網站的條款與細則文本中提供連結至我們的條款與細則，或直接從您的預訂頁面連結至該條款。這些條款詳細說明了管理預訂的規定。請將以下連結放置於 easy-to-find 位置，並使用連結文字「供應商條款與細則」。
我們支援的所有語言版本的條款與細則，皆可從此連結取得：Rapid API 條款與細則頁面：
範例：
GR4：當 Expedia Group 擔任記錄 Merchant (MoR) 時，應正確使用並展示信用卡規範
凡涉及取得、使用、傳輸、儲存或處理旅客持卡人資料之處，均須遵守支付卡產業安全標準委員會頒布之支付卡產業 (PCI) 資料安全標準。這些規範的完整參考資料可於官方PCI 安全標準委員會 網站查閱。
GR5：針對旅宿收集作業，或當 Expedia Group 擔任 MoR 時 (僅適用合作夥伴)，須提供 PCI 合規性證明文件。
無論 Expedia Group 是 MoR 還是旅宿是 MoR，均須提供合規證明書 (AOC) 作為符合 PCI 標準之憑證。
有關 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 連結，以便旅客進行選擇。
必須顯示訊息告知旅客，相同客房的多種床型選擇只限透過要求取得，且如果供應情況不允許，則飯店無須提供。
客房名稱會以 . 的形式，在購物回應的 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 標誌清晰可見
Non-refundablerefundable=false 在購物 API 的可用性回應中，可用性由標示。 當可用性回應中返回「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 及特殊說明
對於每個客房 (如在checkin內容 APIcheckout 旅宿定義中返回)，必須顯示fees、policies、 及 物件的內容。此資訊必須顯示於您的空房狀態頁面，以確保旅客知悉入住時可能產生的任何費用或特殊進出指示。
特殊欄位 check-in 可能包含對 check-in 至關重要、但未收錄於checkin 物件指令欄位之資訊，例如：要求通知旅宿預期抵達時間、於賓客大樓以外地點進行 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.
<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」及特殊指示
對於每個客房，其內容必須顯示為checkinContentcheckout 旅宿定義中返回的fees、policies、 及 物件內容。此資訊必須在旅客完成預訂前於 check-in 顯示，以確保旅客知悉任何潛在費用或特殊通行指示。
特殊欄位 check-in 可能包含對 check-in 至關重要、但未收錄於checkin 物件指令欄位之資訊，例如：要求通知旅宿預期抵達時間、於賓客大樓以外地點進行 check-in 作業，或警示需透過電子郵件接收旅宿發送之特殊 check-in 指令。
確保在同一區域內向旅客顯示 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：聲明將於何時向最終旅客收取費用 (適用於旅宿代收款項或當 Expedia Group 為 MoR 時)
若 Expeda Group 為預訂管理機構 (MoR)，則聲明所提供的信用卡將立即被收取預訂全額費用。
如果是 Property Collect，必須聲明旅客提供的信用卡將由住宿方在入住或退房時收款。若旅宿提供的是預先計費 (non-refundable post-pay) 費率，則應改為告知旅客：預訂完成後不久，旅宿可能會向旅客收取費用。
BP9：符合《安全認證規範》(SCA) 規定
監管機構與信用卡網絡正推出新規定，以強化線上支付的安全性，並保護消費者免受詐騙侵害。其中許多法規都包含了針對線上支付必須採用強客戶認證 (SCA) 的要求。
BP10：當 Expedia Group 為 MoR 時，於 check-out 頁面顯示的付款處理地點
其中，Expedia Group 代表付款處理所在的國家/地區 (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"使用者介面範例：
