Vrbo 啟動條件
為將 Vrbo 上的住宿透過 Rapid API 整合到合作夥伴的系統,會需要遵循一些啟動條件。
簡介
為將 Vrbo 上的住宿透過 Rapid API 整合到合作夥伴的系統,這些是需要遵循的啟動條件。您可在此處下載清單。
此外,也需要遵循住宿須知程序。相關程序請參見這裡。
Vrbo 和其他品牌的商標可按此處下載。
注意:可按下方箭頭展開頁面,以查看各項啟動條件詳情。
刊登內容頁面
刊登內容頁面 1:Vrbo (或當地同級品牌) 商標或文字名稱會顯示在刊登內容旁
僅適用歐盟/英國銷售點
Vrbo 旅宿只會出現在 Vrbo 檔案中,您需要在內容 API 回應傳送supply_source=VRBO
來識別 Vrbo 旅宿。
API 範例:
物件 | 格式 | 說明 |
---|---|---|
supply_source | 字串 | 住宿的供應來源。 |
刊登內容頁面 2:在搜尋結果中顯示住宿管理類型 (僅限歐盟/英國)
僅適用歐盟/英國銷售點
當住宿的管理類型為私人屋主時,需根據銷售點顯示正確訊息。
- 歐盟/英國銷售點:Private Host
- 法國銷售點:Annonce d'un Particulier
- 其他銷售點:不需特別顯示
API 範例:
"vacation_rental_details": {
"private_host": true,
"property_manager":
"name":
}
物件 | 格式 | 說明 |
---|---|---|
private_host | 布林值 | 顯示住宿是否為私人屋主管理。 |
旅宿詳情頁面/供應情況頁面
供應情況頁面 1:顯示 Vrbo (或當地同級品牌) 商標或文字名稱 (僅限歐盟/英國)
僅適用歐盟/英國銷售點
API 範例:
物件 | 格式 | 說明 |
---|---|---|
supply_source | 字串 | 住宿的供應來源。 |
供應情況頁面 2:在旅宿詳情頁面上顯示住宿管理類型 (僅限歐盟/英國)
僅適用歐盟/英國銷售點
私人屋主的住宿
當住宿的管理類型標示為私人屋主時,需根據銷售點顯示正確訊息。
- 歐盟/英國銷售點:「此旅宿管理者為私人屋主。私人屋主不把出租旅宿當做一種交易、業務或職業。與專業屋主有關的歐盟/英國消費者法律可能不適用,但安心預訂沒煩惱和私人屋主制定的取消規定將涵蓋您的預訂」。
- France POSa: "Cette propriété est celle d’un particulier. La fourniture de logements n’est pas liée à son commerce, entreprise ou profession. Le droit de la consommation de l'Union Européenne peut ne pas s'appliquer, toutefois la Garantie Réservation en tout Confiance et les conditions d'annulation définies par l'hôte particulier couvriront votre réservation."
上面的粗體內容為可選用。如果合作夥伴在結帳頁面提供 Vrbo 的「安心預訂沒煩惱」保證連結,就可以在此處的旅宿詳情頁面納入此訊息。
專業經營的旅宿
當住宿的管理類型標示為專業經營時,需根據銷售點顯示正確訊息。
- 歐盟/英國銷售點:**取消權利須知。**取消預訂時,須遵守旅宿業者的取消規定。根據歐盟/英國消費者權益相關法規,旅宿預訂服務不適用撤回權。
- 法國銷售點:"Informations sur le droit de rétractation. Informations sur le droit de rétractation - Bien que les vacanciers réservant auprès d’un consommateur ou d’un non professionnel ne disposent pas du droit de rétractation, au sens de l’article L. 221-18 du Code de la consommation, ils peuvent bénéficier de la politique d’annulation du propriétaire. Les vacanciers et propriétaires sont soumis au droit des obligations et de responsabilité civile applicables à la relation contractuelle, prévues aux articles 1100 à 1386-1 du code civil."
如何識別住宿管理類型
"vacation_rental_details": {
"private_host": true,
"property_manager":
"name":
}
物件 | 格式 | 說明 |
---|---|---|
private_host | 布林值 | 顯示住宿是否為私人屋主管理。 |
供應情況頁面 3:顯示旅宿簡介任意文字。
屋主通常會詳細說明旅宿、設施服務和周邊地區。確保在 API 傳回時顯示任意文字詳情。
範例:
"free_text": "City ID#1837<br><br>If you want ELEGANCE, the Dream Home is for YOU! YOU will create MEMORIES that will last a LIFETIME and experience the history of Palm Springs, all in this 800 sq. ft STUNNING home with clerestory windows, exposed-beam ceilings, the latest home TECHNOLOGY, a large kitchenette, granite counters, full walk-in shower, and a PRIVATE POOL & SPA! This home is UNBELIEVABLY GORGEOUS, with a privacy fence, gated parking, a barbecue area, BREATHTAKING MOUNTAIN VIEWS! You simply DESERVE IT! You will be AMAZED at this home so close to downtown! You will never want to leave this stunning piece of Palm Springs!<br><br>You will also have your very own remote control gate to park your car next to your home behind a self-closing gate. You are welcome to invite friends over for a small party or cookout on your grill. All the kitchen utensils are provided. You just bring the food and start grilling!<br><br>The home is FULL of TECHNOLOGY from Alexa, to a Nest thermostat and even control the temperature of the spa directly from a wireless tablet in the home!<br><br>The home has amazing ambiance overlooking a heated pool and spa.<br><br>The home has a queen bed with a memory foam mattress and bamboo pillows. It also has a couch in the same room that could be used for a child or an adult. The home is full of beautiful MODERN furniture to give you the true Palm Springs Experience. The Dream Home is completely surrounded by a privacy fence which gives you complete privacy during stay! <br><br>**Pool heating is charged during the months of November - December - January - February - March - April and May 15 (see ADDITIONAL RULES for details). Payment request is sent at least 2 weeks in advance.<br><br>POOL HEAT FEES <br>There is a $50 per day pool charge for the following months;<br>(Aug 15 - November - December - January - February - March-April-May 15) to 80 degrees the following fee will be applied;<br>* Pool Heat Charges tracked by Pentair Software program during your stay.<br>* Pool heat invoice charges will be emailed the week before check-in.<br>* Payment must be made before check-in."
},
供應情況頁面 4:價格明細
顯示房價詳情時,旅客服務費與旅宿費用的明細也會一併顯示。
a) 旅客服務費
您必須逐字顯示範例文字:
所有歐盟/英國銷售點皆要求標示「包含增值稅」。 顯示給旅客查看時,必須說明旅客服務費 (可用滑鼠移動到文字或點擊文字的方式)。
範例:
旅客服務費詳情:旅客服務費 (含增值稅):33.32 歐元 (EUR)
合作夥伴可以使用「旅客服務費」或在詳情中簡稱「服務費」。
- 「[品牌] 提供線上工具、服務和平台功能,以利旅客與刊登旅宿的業者互動,故酌收服務費。」
請參見此頁面最底端的 Vrbo 品牌對應清單。
b) 住宿附加費
每當價格細分時都顯示旅宿費用。
可選擇以滑鼠移動到文字上方查看詳情,例如:「住宿附加費包含:清潔費、加人費用、管理和其他費用。」
範例:
住宿附加費:$4.00
"occupancy_pricing": {
"2": {
"nightly": [
[
{
"type": "tax_and_service_fee",
"value": "13.64",
"currency": "USD"
},
{
"type": "property_fee",
"value": "4.00",
"currency": "USD"
},
{
"type": "traveler_service_fee",
"value": "13.20",
"currency": "USD"
},
{
"type": "base_rate",
"value": "99.00",
"currency": "USD"
}
],
供應情況頁面 5:顯示進階版住宿規定
進階版住宿規定的完整內容必須包含在旅宿詳情頁面上 (例如禁止舉辦派對、吸煙規定)。需顯示從 API 傳回的additional_information
物件完整內容。
住宿規定確保旅客在完成預訂前了解屋主的所有要求。本物件中傳回的值係 Vrbo 旅宿專屬,而且會比 API 內容檔案中傳回的值更優渥。
使用者介面範例:
API 範例:
"enhanced_house_rules":
"Children": {
"rule": "Children allowed",
"additional_information": [
"Children allowed ages 13-17",
"Three children are possible if one is in a cot",
]
},
"Pets": {
"rule": "Pets allowed",
"additional_information": [
"Pets must be no larger than 1lbs.",
]
}
供應情況頁面 6:顯示旅宿登記證號
可以在 Rapid 內容回應中找到旅宿登記證號。
只要出現在合作夥伴的 PDP 網站內容時,就要顯示此數值。
使用者介面範例:
營業許可證號:RHL-0000954
API 範例:
"vacation_rental_details": {
"registry_number": "RHL-0000954",
"private_host": true
}
供應情況頁面 7:顯示單位設定
需納入臥室和浴室的數量。客房大小詳情為選填。該資訊可以在 statistics
陣列中找到。
使用者介面範例:
API 範例:
"statistics": {
"1073743380": {
"id": "1073743380",
"name": "Max occupancy - 5",
"value": "5"
},
"1073743378": {
"id": "1073743378",
"name": "Nunmber of bedrooms - 1",
"value": "1"
},
"1073743379": {
"id": "1073743379",
"name": "Number of bathrooms - 1",
"value": "1"
},
"52": {
"id": "52",
"name": "Total number of rooms - 1",
"value": "1"
},
"1073743538": {
"id": "1073743538",
"name": "Property floor area (square meters) - 75",
"value": "75"
},
"1073743537": {
"id": "1073743537",
"name": "Property floor area (square feet) - 807",
"value": "807"
}
供應情況頁面 8:顯示住宿管理者資訊
包括屋主姓名。
選填:納入使用的語言和相片。
API 範例:
"vacation_rental_details": {
"registry_number": "Property Registration Number SCIA 19367",
"private_host": true,
"property_manager": {
"name": "Rent Home in Rome, It"
},
"spoken_languages": {
"de": {
"id": "de",
"name": "German"
},
"en": {
"id": "en",
"name": "English"
},
"nl": {
"id": "nl",
"name": "Dutch"
}
}
結帳頁面/預訂頁面
預訂頁面 1:顯示存檔信用卡限制的金額和說明
- 這需要填入用 Rapid 供應情況 API 回應提供的數字。
- 範例文字:「當您破壞住宿或產生雜費時,最多可能從您的信用卡收取 $x。」
當您使用虛擬信用卡時,合作夥伴負責收取旅客造成的損壞賠償,這些費用將從合作夥伴虛擬信用卡中收取。
預訂頁面 2:顯示 Vrbo 相關的條款和條件連結
需在結帳頁面附上旅客所在銷售點的相關條款和條件連結。
請不要顯示為針對核心線上旅行社 (飯店) 預訂的 Rapid 啟動條件所附的 Expedia Group 條款和條件連結。
銷售點 | 連結 |
---|---|
澳洲 | https://www.vrbo.com/en-au/lp/b/terms-of-service |
奧地利 | https://www.vrbo.com/de-at/lp/b/terms-of-service |
巴西 | https://www.vrbo.com/pt-br/lp/b/terms-of-service |
加拿大 (英語) | https://www.vrbo.com/en-ca/lp/b/terms-of-service |
加拿大 (法語) | https://www.vrbo.com/fr-ca/lp/b/terms-of-service |
丹麥 | https://www.vrbo.com/da-dk/lp/b/terms-of-service |
芬蘭 | https://www.vrbo.com/fi-fi/lp/b/terms-of-service |
法國 | https://www.abritel.fr/lp/b/terms-of-service |
德國 | https://www.fewo-direkt.de/lp/b/terms-of-service |
希臘 | https://www.vrbo.com/el-gr/lp/b/terms-of-service |
義大利 | https://www.vrbo.com/it-it/lp/b/terms-of-service |
日本 | https://www.vrbo.com/ja-jp/lp/b/terms-of-service |
墨西哥 | https://www.vrbo.com/es-mx/lp/b/terms-of-service |
荷蘭 | https://www.vrbo.com/nl-nl/lp/b/terms-of-service |
紐西蘭 | https://www.vrbo.com/en-nz/lp/b/terms-of-service |
挪威 | https://www.vrbo.com/no-no/lp/b/terms-of-service |
波蘭 | https://www.vrbo.com/pl-pl/lp/b/terms-of-service |
葡萄牙 | https://www.vrbo.com/pt-pt/lp/b/terms-of-service |
新加坡 | https://www.vrbo.com/en-sg/lp/b/terms-of-service |
西班牙 | https://www.vrbo.com/es-es/lp/b/terms-of-service |
瑞典 | https://www.vrbo.com/sv-se/lp/b/terms-of-service |
英國 | https://www.vrbo.com/en-gb/lp/b/terms-of-service |
美國 | https://www.vrbo.com/lp/b/terms-of-service |
預訂頁面 3:顯示向旅客信用卡收費的商戶詳細資料
透過旅客信用卡或合作夥伴虛擬信用卡付款時:
- 「您所選擇的住宿是透過我們的合作夥伴 [品牌] 預訂,他們將寄送內含付款詳情的電子郵件給您,並附上連結,方便您註冊帳戶並管理預訂。」
進階:發佈 IPM 供應內容的合作夥伴還必須告知旅客向旅客信用卡收費時 IPM 的角色:
- 「此項收費在您的信用卡明細表上將顯示為支付給 [IPM 名稱] 的費用。」
請參見此頁面最底端的 Vrbo 品牌對應清單。
預訂頁面 4:顯示預訂後流程說明文字
合作夥伴應帶給旅客正面體驗,其中包括讓旅客在預訂後有所期待。
「我們已與 [品牌] 成為合作夥伴,您應該會收到來自 [品牌] 和旅宿屋主的電子郵件。」
例如:
- 預訂確認
- Vrbo 歡迎指南
- 旅宿入住指示
- 設施服務使用說明
- 屋主所提供與您的住宿相關的資訊
請參見此頁面最底端的 Vrbo 品牌對應清單。
如果您同時銷售 IPM 旅宿,另請附上文字:「您可能還會收到來自 [IPM 名稱] 的電子郵件,內含有關您住宿的資訊。」
預訂頁面 5:顯示房價詳情時,旅客服務費與旅宿費用的明細也會一併顯示
a) 旅客服務費
您必須逐字顯示範例文字:
- 所有歐盟/英國銷售點皆要求標示「包含增值稅」。
- 顯示給旅客查看時必須說明旅客服務費 (可用滑鼠移動到旅客服務費名稱上方或點擊費用名稱的方式)。
範例:
- 旅客服務費詳情:旅客服務費 (含增值稅):33.32 歐元 (EUR)。
合作夥伴可以使用「旅客服務費」或在詳情中簡稱「服務費」。
- 「[品牌] 提供線上工具、服務和平台功能,以利旅客與刊登旅宿的業者互動,故酌收服務費。」
請參見此頁面最底端的 Vrbo 品牌對應清單。
b) 住宿附加費
每當價格細分時都顯示旅宿費用。
可選擇以滑鼠移動到文字上方查看詳情,例如:「住宿附加費包含:清潔費、加人費用、管理和其他費用。」
範例:
住宿附加費:$4.00
"occupancy_pricing": {
"2": {
"nightly": [
[
{
"type": "tax_and_service_fee",
"value": "13.64",
"currency": "USD"
},
{
"type": "property_fee",
"value": "4.00",
"currency": "USD"
},
{
"type": "traveler_service_fee",
"value": "13.20",
"currency": "USD"
},
{
"type": "base_rate",
"value": "99.00",
"currency": "USD"
}
],
預訂頁面 6:顯示住宿租賃合約
租賃合約連結可在 Rapid 內容 API 回應中找到 (若有提供的話)。
"vacation_rental_details": {
"rental_agreement": {
"links": {
"rental_agreement": {
"method": "GET",
"href": "<https://www.leisure-group.net/eris/pdf/hrvw-bvag-bv-en.pdf">
}
}
},
預訂頁面 7:顯示完整的級別取消規定詳情
許多出租度假屋旅宿提供多級別的退款標準。強烈建議以圖形顯示,較能清楚地顯示下單日期、目前日期和旅客抵達日期的連動變化。
請務必清楚告知旅客:只有 100% 可退款的預訂,才可退款服務費。請於取消規定說明和/或預訂條款小節中顯示這項規定。旅客預訂之後,一旦到了可部分退款或不得退款期間,便不得退回服務費。
說明範例:
「只有在您的整筆預訂可全額退款時,服務費才可退款。」
使用者介面範例:
條款範例:
預訂頁面 8:將 Expedia Group 顯示為交易者 (僅限歐盟/英國銷售點)
請務必在結帳頁面和預訂後聯絡內容中,向 Vrbo 客房庫存交易者顯示這段文字。
Expedia Group 出租度假屋 (愛爾蘭) 有限責任公司
地址:25 St. Stephen's Green, 4th floor, Dublin 2, D02 XF99, Ireland
+353 15621133
support@chat.travelnow.com
預訂頁面 9:顯示交易者資訊、條款和條件,以及聯絡訊息 (僅限歐盟/英國銷售點)
當 trader_information
、terms_and_conditions
和 contact_message
欄位由 API 提供時,必須在結帳頁面和預訂後聯絡內容中提供這些資訊。
API 範例:
"trader_information": {
"traders": [
{
"name": "Expedia",
"address": {
"line_1": "555 1st St",
"line_2": "10th Floor",
"line_3": "Unit 12",
"city": "Seattle",
"state_province_code": "WA",
"postal_code": "98121",
"country_code": "US"
},
"email": "travel@support.expedia.com",
"phone": "0330-123-1235",
"contact_message": "This property is managed by a professional host. The provision of housing is linked to trade, business, or profession."
}
],
"terms_and_conditions": "https://www.expedia.com/terms_and_conditions"
}
預訂後條件需求
預訂後 1:住宿須知資訊
產生一封預訂後電子郵件,其中包含 API 傳回的所有住宿須知資訊。
與出租度假屋住宿相關的重要資訊,其可能並未明顯列於旅宿內容中。
例如:
- 游泳池清潔工每週二下午 2 點至 4 點來,並可進入院子。
- 若要使用壁爐,您必須從後門外的儲物箱中收集木材。
- 使用桑拿/熱水浴缸需支付每小時 $10 的額外費用。
- 恆溫器的設定不得高於 72F。
進一步詳情請參見這裡
技術條件
技術條件 1:旅客服務費和帳單國家/地區詳情
用於支付預訂的虛擬信用卡帳單國家/地區必須與購物請求中提供的銷售點國家/地區代碼一致。
Expedia Group 就每筆預訂收取旅客服務費 (TSF),因此我們要求旅客提供帳單國家/地區,以決定正確房價。因此,若購物請求所使用的國家/地區和帳單地址所示的國家/地區不同,則會因「國碼/地區碼無效」而預訂失敗。
例如:購物請求使用了 country_code=US
,故系統提供了一個美國旅客的價格 (服務費不含增值稅)。如果預訂申請中提供了英國發行的信用卡,我們需要收取 20% 的增值稅。
技術條件 2:每筆預訂申請都要提供正確的旅客資料
需要提供旅客聯絡資訊,以便屋主和旅客在入住前和入住期間進行溝通,藉此促進正面的旅客體驗。
預訂申請必須包括:
- 旅客姓名
- 旅客電話號碼
- 旅客電子郵件地址
進階部分
**注意:**僅適用於使用進階整合選項的合作夥伴。您的整合團隊將建議其中任何一項是否適用於您的認證。
情境 1:可退款的損壞保證金
進階頁面 1.1:顯示可退款的損壞保證金的金額和說明
- 這需要填入用 Rapid 供應情況 API 回應提供的數字。
- 範例:此住宿要求支付 X 英鎊的可退款損壞押金。
- Vrbo 將於最後一次付款時,收取可退款損壞押金。若無分期付款,則於第一次付款時收取。
此外,當旅客是透過合作夥伴虛擬信用卡付款時,合作夥伴負責向旅客收取訂金,並在旅客退房後將任何餘額退還給旅客。
情境 2:旅客信用卡
進階 2.1 - 顯示信用卡豁免權
在結帳頁面上包含以下豁免權 (或類似內容):
「屋主收取的服務費和預訂金額,將在您的信用卡明細表中顯示為支付給 [品牌] 的款項。若付款處理地點為海外,您的銀行可能會收取外幣交易手續費。」
進階 2.2 - 旅客服務費和帳單國家/地區詳情
Expedia Group 就每筆預訂收取旅客服務費 (TSF),因此我們要求旅客提供帳單國家/地區,以決定正確房價。因此,若購物請求所使用的國家/地區和旅客所示做為帳單地址的國家/地區不同,則會因「國碼/地區碼無效」而預訂失敗。
**例如:購物請求使用了 **country_code=US
,故系統提供了一個美國旅客的價格 (服務費不含增值稅)。若這位旅客隨後用了英國的信用卡付款,則 Expedia Group 必須收取 20% 的增值稅。也就是說,若為英國旅客以美國房價送出預訂請求,則會導致預訂失敗。
**解決方式:**若旅客在結帳頁面帳單地址欄位上指定的國家/地區與購物時使用的國家/地區不同,合作夥伴應更新國碼/地區碼後再重新購買旅宿預訂,以取得正確價格。在送出預訂申請前,應向旅客顯示更新後的價格並取得確認。
帳單資訊
預訂 Vrbo 住宿必須提供正確帳單地址。若旅客帳單地址資料不符,則可能會出現預訂錯誤。
目前若無提供此資訊,還可順利在 Rapid 上預訂傳統旅宿 (如:飯店),但預訂 Vrbo 旅宿則不行。
**A:**帳單國家/地區 - 帳單國家/地區須與購物國家/地區一致。
**B:**帳單郵遞區號 - 大多數國家/地區皆要求地址包含郵遞區號。可再提供額外資訊。可以在 Vrbo 整合指南中查看更多詳情。
**C:**帳單州碼 - 美國銷售點還需要州碼。
呼叫付款選項連結以取得可接受的信用卡類型。
Vrbo 旅宿可接受的信用卡類型比傳統旅宿還少。請呼叫付款選項連結來查看可接受的信用卡類型,並將此訊息顯示在結帳頁面。
**注意:**合作夥伴出租主房源時可自行指定帳單幣別,但出租 Vrbo 客房庫存時則無法。Rapid 購物會傳回預訂的正確帳單幣別。應告知旅客:跨國交易可能需要支付銀行手續費。
情境 3:付款安排
進階 3.1:通知旅客付款安排
當 Rapid 購物/價格檢查 API 回傳的訂金規定載明可分次付款,需向旅客清楚顯示該規定,並通知旅客須於指定的付款期限前,在 Vrbo 網站完成付款。Vrbo 和/或屋主將提前一週發送提醒,如果未完成付款,預訂可能會被取消。
在您的結帳頁面上納入以下語言:
「屋主現在只先收取部分房價。Vrbo 或屋主會以電子郵件通知您細節,包括下次付款到期的提醒。」
"deposits": [
{
"value": "412.10",
"due": "2023-05-17",
"currency": "USD"
},
{
"value": "236.17",
"due": "2023-08-24",
"currency": "USD"
}
]
其他參考資訊
Vrbo 品牌對應表:
銷售點國家/地區 | Vrbo 品牌 |
---|---|
德國 | Fewo-direkt.de |
法國 | Abritel.fr |
澳洲 | Stayz.com.au |
紐西蘭 | Bookabach.co.nz |
世界其他地區 | Vrbo.com |