快速住宿 API：B2C 獨立版上線要求
若您採用 business-to-consumer (B2C) 整合模式，且旅客直接與您的整合系統互動，則需遵循這些啟動要求。
簡介
這些要求已分為兩部分：
獨立需求： 這些需求專屬於此預訂流程。請仔細閱讀這些要求，因為這些要求可能與您之前整合的任何其他價格類型/預訂流程不同。
**常見要求：**這些要求在所有預訂流程中都很常見。請確保在所有流程中滿足所有這些要求。
註： 以下所列的每項要求均包含參考代碼，以協助我們的客服團隊為您提供支援。
清單
我們已建立一份檢查清單，以協助您進行開發工作或提供需求反饋。如果您要為您的網站審核提供螢幕截圖，請在清單中新增螢幕截圖和相對應的日誌，因為這將有助於我們完成您的審核。
B2C 實施方案
常見要求
以下啟動要求適用於所有預訂流程。每種價格類型的特定附加要求，包括價格顯示的詳細說明，均在單獨的價格要求列表中提供。
GR1：不得使用 Expedia Group 名稱及標誌
除經我們事先明確書面批准外，僅可在 traveler-facing 或 agent-facing 網站上使用我們的名稱和標誌。
範例：
GR2：顯示連結至我們的條款與條件網址
請在貴網站的條款與細則文本中提供連結至我們的條款與細則，或直接從您的預訂頁面連結至該條款。這些條款詳細說明了管理預訂的規定。請將以下連結放置於 easy-to-find 位置，並使用連結文字「供應商條款與條件」。
我們支援的所有語言版本的條款與細則，皆可從此連結取得：Rapid API 條款與細則頁面：
範例：
GR4：當 Expedia Group 擔任記錄商戶 (MoR) 時，信用卡法規的正確使用與展示
凡涉及取得、使用、傳輸、儲存或處理旅客持卡人資料之情事，均應遵守由支付卡產業安全標準委員會頒布之《支付卡產業資料安全標準》(PCI DSS) 。這些規範的完整參考資料可於官方PCI 安全標準網站 查閱。
GR5：提供旅宿收集的 PCI 合規證明，或當 Expedia Group 作為主責任方時 (如適用)
當 Expedia Group 或旅宿為 MoR 時，必須提供合規證明書 (AOC) 作為符合 PCI 標準的證據。有關 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：顯示每個客房的床型描述
購物 API 回應 可能返回bed_groups 陣列，其中包含單一值或多個選項。顯示配置陣列中的值，以描述旅客的床鋪選擇。
當bed_groups 陣列返回多個選項時，請顯示購物回應中為每種床型提供的price_check 連結，以便旅客進行選擇。
必須顯示訊息告知旅客，相同客房的多種床型選擇只限透過要求取得，且如果供應情況不允許，則飯店無須提供。
客房名稱會以「room_name」的形式，出現在購物回應的 rooms 陣列中。
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 及特別說明
對於每個客房，其內容必須顯示為checkinContentcheckout 旅宿定義中返回的fees、policies、 及 物件內容。此資訊必須顯示於您的空房狀態頁面，以確保旅客知悉 check-in 網站上的任何潛在費用或特殊進出指示。
special_instructions欄位可能包含對 check-in 至關重要、但未收錄於checkin 物件之instructions 欄位中的資訊，例如：需通知旅宿預定抵達時間、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.
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：顯示 check-in 及特殊說明
對於每個客房，其內容必須顯示為checkinContentcheckout 旅宿定義中返回的fees、policies、 及 物件內容。此資訊必須在旅客完成預訂前於 check-in 顯示，以確保旅客知悉任何潛在費用或特殊通行指示。
special_instructions欄位可能包含對 check-in 至關重要、但未收錄於checkin 物件之instructions 欄位中的資訊，例如：需通知旅宿預定抵達時間、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預訂成立後，將立即產生一筆 non-refundable 的費用。更多詳情請參閱cancel_penalties 與nonrefundable_date_ranges。
nonrefundable_date_ranges此範圍的住宿日期為 non-refundable，一旦完成預訂即生效。
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：說明何時從最終旅客處收取費用 (若旅宿為代收方，或當 Expedia Group 為 MoR 時)
若預訂者為「預付責任人」(Expedia Group) ，請聲明所提供的信用卡將立即被收取預訂全額費用。
如果是 Property Collect，必須聲明旅客提供的信用卡將由住宿方在入住或退房時收款。若旅宿提供的是預先計費 (non-refundable post-pay) 費率，則應改為告知旅客：預訂完成後不久，旅宿可能會向旅客收取費用。
BP9：遵守歐洲經濟區法規。
若您計劃與歐洲經濟區 (EEA) 的旅客進行交易，則須符合強客戶驗證 (SCA) 規範。
Expedia Group 是 MoR 或旅宿收集
若 Expedia Group 為 MoR，或旅宿 Collect 系統用於歐洲經濟區 (EEA) 或日本旅客，預訂流程必須採用 Rapid 的 API 進行two-factor 身份驗證。
聯屬 MoR - 概論
當與旅客進行交易時，若該交易屬於相關法規的適用範圍，您必須遵循美國國稅局 () 的《標準化反洗錢政策》（SCA）要求，詳見：。修訂版《支付服務指令》（PSD2）全文可於歐盟委員會網站查閱： 有關可採用的合規標準之進一步資訊，請參閱 EMVCo 的《3D Secure 協議與核心功能規範》：
聯屬 MoR - 企業卡或虛擬卡
若您使用於歐洲經濟區 (EEA) 或日本境內發行的個人信用卡付款，則必須遵循歐盟《支付服務指令 II》（）的加強型驗證 (SCA) 要求：。為減輕對雙重驗證 (two-factor) 的需求，您可採用符合 B2B 支付規範且豁免雙重驗證的卡片。
合規選項包括：
- 一次性虛擬卡。
- 在公司 (非個人) 註冊的多用途公司卡。需要特殊配置檔案設定。
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：當「Expedia Group」為主要付款方式時，於結帳頁面顯示付款處理地點
當 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"
}
]
}使用者介面範例：
