Vrbo 與 Rapid 整合指南
為合作夥伴提供的 Vrbo 整合流程指南。
簡介
本文旨在介紹 Rapid 與 Vrbo 整合流程,包括整合方式、API 要求與回應範例、限制、錯誤處理和常見問題。
本指南主要針對我們推薦的 Vrbo 供應優惠。如需進階使用案例,請參閱下方的進階整合指南。
地理
須知事項
- 使用快速地理 API 並啟用 Vrbo 的合作夥伴還可以從所有地理 API 存取 Vrbo 房產 ID 以及傳統住宿房產。
關鍵主題:對應
- 請注意,在完成預訂前,我們無法公開旅宿的街道地址。詳情請參閱「住宿須知內容」整合指南。
- 合作夥伴應使用「內容 API」的經度/緯度來搭配自身的地理位置解決方案,以標示旅宿的所在地。
- 要求隱私權的旅宿應使用模糊處理的經緯度進行地圖顯示,但只要不向旅客顯示確切的旅宿位置,就可以使用精確的經緯度搜尋旅宿。
與其他住宿選擇的主要區別
- 合作夥伴可以要求 Vrbo 和住宿的地理回應、僅 Vrbo (在啟用的個人資料上使用
supply_source=vrbo
) 或僅住宿 (使用supply_source=expedia
)。如果未提供supply_source
,Rapid Geography API 將預設僅提供住宿。
地理常見問題
**問題:**我可以將地理 API 篩選為僅回傳 Vrbo 旅宿或僅回傳非 Vrbo 旅宿嗎?
**解答:**是的,合作夥伴可以使用 supply_source=vrbo
進行篩選。如果個人檔案不受允許存取 Vrbo 供應,則不會回傳任何結果。
內容
須知事項
- Vrbo 內容透過與其他住宿選項相同的快速內容 API 傳遞
supply_source=vrbo
來提供,但請注意以下架構中的差異。 - 與其他 Rapid 住宿選擇相比,Vrbo 內容需要物業經理更頻繁地更新。不正確的旅宿刊登內容資訊可能會導致旅客體驗不佳、增加支援電話及退款要求。我們強烈建議合作夥伴至少每週更新一次 Vrbo 內容,以確保旅客能看到準確的旅宿資訊、設施服務和規定。
- Vrbo 優質屋主計畫是一項邀請制福利,僅限那些透過 Vrbo 平台評估 (包括低屋主取消率、正面評價及良好的旅客服務體驗) 證明能提供優質旅客體驗的屋主參加。合作夥伴可以使用來辨識 Premier Host 屬性
attribute_id=1073745445
。此外,合作夥伴可以在請求中包含attribute_id=1073745445
來過濾結果並只傳回 Premier Host 屬性。
與其他住宿選擇的主要區別
Vrbo 專屬欄位:
API | 說明 |
---|---|
內容檔案 | Vrbo 的房源與其他 Rapid 住宿選項在單獨的內容檔案中提供。 |
欄位 | 說明 |
---|---|
vacation_rental_details:registry_number | 出租度假屋旅宿展示的必填欄位。如需更多詳情,請參閱啟動條件。 |
私人出租住宿 | 屬性 1073745102‘私有主機屬性’表示該屬性由私有主機管理。展示的必填欄位,以及附加的必要詳情。如需更多詳情,請參閱啟動條件。 |
專業房東物業 | 屬性 1073745142‘專業房產房東/經理’表示該房產由專業房東/經理管理。展示的必填欄位,以及附加的必要詳情。如需更多詳情,請參閱啟動條件。 |
優質屋主 | 屬性 1073745445‘Premier partner’表示該房產由 Premier host 管理。可用於為具有 Premier Host 指示器的清單新增徽章,或篩選結果以僅傳回 Premier Host 屬性。 |
statistics | 包括特定出租度假屋單位的資訊,包括入住人數上限、臥室數量、浴室數量、客房數量 (獨立單位出租度假屋為 1) 和住宿建築面積 (單位為平方公尺和英尺)。應用於在搜尋結果和旅宿詳情頁面頂端展示關鍵旅宿資訊的摘要。 |
浴室和臥室數量 | 屬性 1073743378「臥室數量」是指單位內的臥室數量。屬性 1073743379「浴室數量」是指單位內的浴室數量。 |
vacation_rental_details:property_manager | 包括旅宿管理者姓名、圖片和可聯絡時使用的語言。應用於將旅客介紹給管理該旅宿的屋主。預訂完成後將提供聯絡資訊,做為基本住宿內容的一部分。 |
vacation_rental_details:unit_configurations | 描述客房的床型以及客房內每種床型的數量。此資訊應用於向旅客展示旅宿佈局,以確保旅宿能夠容納旅客的旅遊團體。 |
vacation_rental_details:house_rules | 此欄位已不使用。請使用 vacation_rental_details:enhanced_house_rules 代替。 |
vacation_rental_details:enhanced_house_rules | 完善的房屋規則包括有關寵物、派對、兒童、吸煙政策等關鍵政策資訊。additional_information 可以包含對客人住宿至關重要的每項政策的詳細信息,例如政策說明、訪問代碼、密碼、圖像和 stay-collected 費用 (城市旅遊稅或 usage-based 費用)。請參閱 Vrbo 住宿須知內容指南了解更多資訊。 |
vacation_rental_details:rental_agreement | 提供旅宿管理者所提供 PDF 檔或網站的連結,該連結必須顯示在結帳頁面上。可能還需要旅客進行簽署並回傳或送出的動作,同時可能需要租賃合約。 |
vacation_rental_details: free_text | 這是屋主提供的任意文字欄位,重點強調旅宿為旅客提供的獨特屬性或體驗。該描述還可能包括附近的景點、屋主提供的可選服務或旅客在下預訂之前應先了解的其他重要資訊 (例如施工、噪音、水質狀況、滑雪場通道、停車等)。這部分可能會相當冗長,因此應特別注意此欄位的 UI 顯示畫面,尤其是應顧慮到行動裝置的體驗。 若未出現此欄位,合作夥伴應退回到 Descriptions.General 。 |
descriptions.general | 提供根據旅宿屬性、設施服務和位置由機器產生之出租度假屋旅宿詳情。這段文字不包含屋主的任何指南或資訊。這個欄位與傳統旅宿最相關。若未出現 vacation_rental_details.free_text 則應使用此欄位。 |
traveler_service_fee | 此欄位已不使用。請勿使用。請參閱啟動條件以取得推薦的結帳顯示文字。 |
欄位不適用 Vrbo 旅宿:
欄位 | 說明 |
---|---|
旅宿評價 | Vrbo 旅宿目前尚無評分功能。可以改為使用旅客評分。 |
客房說明 | 不適用於獨立單位的出租度假屋旅宿。應改用客房等級的資訊。 |
房價計畫 | 不適用 Vrbo 旅宿。 |
客房等級資訊 | 旅宿等級包含所有房型說明資訊。因為 Vrbo 旅宿沒有房型層級內容,所以通常在房型層級的設施服務會併入稱為 vacation_rental_details 的新區段。 |
vrbo_srp_id 、listing_id 、listing_number 、listing_source 、listing_unit | 這些欄位僅與 Vrbo 站外連結模型相關,但也可用於旅宿對應/比對。 |
IPM_Name | 僅供參與 Vrbo IPM 試用的合作夥伴使用。值會提供 IPM 的名稱,因此應將其傳送給旅客,告知旅客商戶會向其信用卡收費,同時也向旅客傳送住宿電子郵件。 |
內容常見問題
**問題:**如果街道地址並未在 Rapid 內容中提供,我該如何標示 Vrbo 內容位置?
**解答:**Rapid 地理 API 和/或旅宿經緯度值可用於對旅宿進行地理定位。
**問題:**Rapid 內容檔案中是否包含 Vrbo 住宿?
**解答:**是。Vrbo 專屬的內容檔案可透過在 API 要求中傳遞 supply_source=vrbo
來擷取。
**問題:**Vrbo 住宿是否提供所有語言版本?
**解答:**是。不過,屋主提供的部分任意文字欄位並不會在地化,而是會以屋主使用的語言提供。受影響的欄位會包括 property_description (descriptions.general)、進階版住宿規定 (vacation_rental_details:enhanced_house_rules)、住宿須知內容,以及屋主傳送給旅客的電子郵件對話 (由 Vrbo 提供支援)。
**問題:**我的旅客不熟悉 Vrbo。所有地區都需要展示 Vrbo 品牌嗎?
**解答:**在德國、法國、澳洲和紐西蘭,需要展示,但可以使用當地的 Vrbo 品牌替代。請參閱下方的附錄 2。如需每個頁面和地區的相關要求,請參閱啟動需求指南。如果合作夥伴從多個供應商取得相同的旅宿,就有可能視為例外。不過,只要已識別預訂供應商為 Vrbo,就必須顯示 Vrbo 名稱。介紹 Vrbo 品牌是教育旅客並著手設定預訂後期望值的重要步驟之一。
**問題:**沒有 bed_groups
,我要如何描述每個客房的床型?
**解答:**有關床型描述的詳細信息,請參閱單元配置頁面。
購物
須知事項
- Vrbo 旅宿僅為整棟旅宿,無共用住宿。
- Vrbo 旅宿僅是獨立單位。
- Vrbo 旅宿僅回傳單一房價計畫。
- 必須透過在購物請求中傳遞
exclusion=refundable_damage_deposit
來排除含損壞押金的旅宿。請參閱進階整合指南,取得啟用這些旅宿之前需要了解的更多詳情。 - 含訂金規定的旅宿已排除。請參閱下方的進階整合指南了解更多詳情。
- 不支援當天預訂 (因此會回傳「沒有空房」)。
關鍵主題:Vrbo 預訂的 merchant_of_record
Rapid 購物中的 merchant_of_record
欄位對於 Vrbo 的 Rapid 整合旅宿有不同的含意。
- 此欄位並不代表將從預訂時提供的卡片中扣款的對象。所有預訂都須預先付款。
- merchant=expedia (「商家」) 代表將透過 EG 結帳系統預訂,該系統提供最理想的預訂成功率,以及一致的錯誤說明。
- merchant=property (「旅行社」) 代表將透過舊版 Vrbo 結帳系統預訂。此供應商的經銷預設為停用。如需詳細資訊,請參閱進階整合部分。
- 旅宿不會固定在單一模式。「商家」資格會根據 3 個關鍵要素來判斷:
- 無可退款損壞保證金 (並非建議的進階整合選項,請參閱下方的進階整合部分)
- 無訂金規定/付款時間表 (並非建議的進階整合選項,請參閱下方的進階整合部分)
- 搜尋必須使用目的地幣別進行,才能取得供應情況。
關鍵主題:Vrbo 預訂的幣別代碼
購物請求中指定的幣別不會影響預訂的帳單幣別。
- 無法為 Vrbo 預訂指定幣別。帳單幣別將一律與旅宿的幣別一致。
- 重要提示:合作夥伴必須在每個快速購物請求中包含目標貨幣,才能以「商家」身分存取最多的 Vrbo 供應。若未提供目的地幣別,則 Rapid 購物回應將只會回傳選擇以該特定幣別付款的屋主所提供的旅宿。如需更詳盡的對應內容,請參閱附錄以了解按地區劃分的目的地幣別建議,或聯絡您的 Partner Connect 聯絡窗口。
關鍵主題:Vrbo 預訂的國碼/地區碼
購物要求中指定的國碼/地區碼必須與在預訂時所提供之信用卡的帳單國家/地區相符。原因在於,Vrbo 要求根據旅客的所在地收取旅客服務費的增值稅,而該地點取決於帳單地址的國碼/地區碼。
- 如果不相符,由於增值稅徵收要求不同,可能會導致預訂錯誤。
- 旅客輸入其付款帳單地址後,合作夥伴必須驗證國碼/地區碼是否等於在購物期間傳遞至 Rapid 的國碼/地區碼。如果這些值不相符,則提交預訂將導致錯誤。合作夥伴必須使用旅客提供的帳單地址重新訂購,才能取得有效的預訂價格。在送出預訂申請之前,請務必告知旅客價格上的變動 (更高或更低)。
與其他住宿選擇的主要區別
Vrbo 專屬欄位:
費用 | 說明 |
---|---|
property_fee | 描述預訂的旅宿費用總額,包括清潔費、管理費、加人費用等。 |
traveler_service_fee | Vrbo 收取服務費以方便預訂並提供支援。一旦任何的預訂部分若為不得退款,此費用將不得退款。如需展示的更多詳情,請參閱啟動條件。 **旅客服務費和 Rapid 購物國家/地區選擇:**當 Vrbo 在定價回應中包含旅客服務費時,該金額將包含與 Rapid 購物請求中使用的國家/地區對應的增值稅。為了成功預訂,合作夥伴必須確保購物中請求的國家/地區與結帳時使用的國家/地區相符。 |
欄位不適用 Vrbo 旅宿:
欄位 | 說明 |
---|---|
客房編號 | 客房名稱和房價編號不適用於 Vrbo 客房庫存,故不應顯示。 |
可供應客房數 | Vrbo 旅宿永遠顯示為 0。請不要使用此欄位來表示緊急情況。 |
床組 | 不適用於 Vrbo,因為沒有偏好選項。 |
促銷編號與說明 | 不適用於 Vrbo 客房庫存。 |
購物常見問題
**問題:**Vrbo 住宿如何排名?
**解答:**旅客評分可以在出現時使用。此外,屬性 1073745445「Premier partner」可協助您識別由符合 Premier Host Program 資格的房東管理的房產,並且您可以使用該屬性來影響房產排序。
**問題:**為什麼不允許只有 1 晚的住宿?
**解答:**由於 VrboCare 僅適用於 2 晚以上的住宿,我們不建議合作夥伴允許短期預訂,以避免客人的不良後果。
**問題:**為什麼不允許較短的提前預訂天數 (不到 72 小時)?
**解答:**屋主需要花時間處理預訂申請、為旅客的抵達預做旅宿相關準備,以及與旅客溝通。為了避免旅客體驗不佳或供應商取消,合作夥伴應限制提前天數較短的預訂。
**問題:**我如何才能讓旅客以「可攜帶寵物」的條件進行搜尋?
**解答:**Rapid 目前不提供按寵物規定篩選或提供包含寵物費用價格的功能。合作夥伴可以根據內容旅宿屬性識別寵物友善的旅宿,且旅客可以查看個別的寵物規定。屋主可以在 vacation_rental_details.free_text
或 enhanced_house_rules
中提供有關寵物規定的附加資訊,這些資訊可能會提供特定寵物規定的詳細和準確說明。建議旅客應與旅宿屋主討論有關寵物及相應費用的支付事宜。
**問題:**我可以搜尋長期住宿 (例如超過 28 晚) 嗎?
**解答:**是的,Rapid 允許購買和預訂 Vrbo 房產,最長可入住 365 晚,但我們強烈建議限制為 90 晚。接近購物平台設定限制的合作夥伴應了解,長期住宿搜尋會對購物呼叫量產生較大的影響。
**問題:**為什麼我在 Rapid 上看不到與 Vrbo.com 上相同的費用明細?
**解答:**Rapid 目前無法將旅宿費用拆解為個別組成部分。這些組成部分可能包括清潔費、管理費、加人費用和其他費用,且已結合到property_fees
。
**問題:**我可以打包 Vrbo 客房庫存嗎?
**解答:**不可以,您不能將 Vrbo 房產作為套餐的一部分進行行銷或預訂。
**問題:**Vrbo 住宿是否有資格享受會員專享優惠?
**解答:**目前不行。
**問題:**Rapid 上的 Vrbo 房產是否有資格享受 Vrbo.com 上提供的促銷活動,例如提前預訂、最後一分鐘、新房源、每周和每月折扣?
**解答:**是的,Rapid 會返回促銷描述、促銷價格和原始 (刪除線) 價格,就像傳統住宿一樣,讓您能夠向旅客推銷優惠和節省。
**問題:**我可以在結帳前的購物階段啟用旅客與屋主的溝通嗎?
**解答:**目前不行。
**問題:**我會在供應情況回應中看到正確的行銷費用嗎?
**解答:**請參考 gross_profit
估算並根據您的簽約合約執行計算。
問題:「Vrbo 與 Rapid 整合」上的房價是否與在 Vrbo 和 Expedia Group 網站上的房價一致?
**解答:**在 Rapid 上的 Vrbo 供應價格應該會反映 Expedia Group 品牌網站上顯示的價格,但可能與 Vrbo 上顯示的價格不同。這通常是根據服務費計算的,可能會略高或略低。此外,不同品牌的旅宿費用彙總可能略有不同。
預訂和付款
須知事項
- 合作夥伴必須提供每筆預訂的旅客聯絡資料 (姓名、電話號碼和電子郵件),以方便屋主/旅客進行通訊。
- Vrbo 針對哪些國家/地區的旅客在預訂時需提供州別和郵遞區號有較嚴格的要求。請參閱下方的進階整合指南了解更多詳情。
- 內容中提供的租賃合約必須顯示在結帳頁面上。如需更多資訊,請參閱啟動條件。
- 透過 Rapid API 進行 Vrbo 預訂需要使用虛擬卡進行付款。希望傳送旅客信用卡的合作夥伴必須參閱進階整合指南。
- Vrbo 旅宿的帳單幣別已預先定義,因此應注意虛擬卡信用額度限制。合作夥伴應確保虛擬卡反映潛在的匯率差異和國際銀行收費,以避免款項不足的預訂錯誤。
- 請注意,目前 Rapid 上的 Vrbo 預訂不支援 Expedia Affiliate Collect (EAC)。需要多次付款的旅宿不符合合作夥伴為正式商戶的資格。請參閱進階整合指南,了解如何啟用這些旅宿。
- 目前,特別要求並不會傳達給旅宿。旅客應在預訂完成後,直接與屋主討論自身的任何特別要求。
關鍵主題:付款
驗證
- 所有 Vrbo 與 Rapid 整合預訂都需使用具有相符帳單地址的有效信用卡。
- 在部分地區,Vrbo 可能會使用 $0 或名目金額來驗證卡片。傳送虛擬信用卡的合作夥伴必須確保已設定為接受多筆收費。
- 信用卡驗證規則與其他 Rapid 預訂不同。詳情請參閱附錄 4。
- Vrbo 價格通常包含服務費 (由 Vrbo 收取)。由於法律要求收取這筆費用的增值稅,因此,服務費的金額會根據旅客的所在地而有所不同。基於上述原因,如果預訂時提供的卡片帳單地址與購物期間提供的國家/地區不同,就會出現「國碼/地區碼無效」的預訂錯誤
- 合作夥伴必須在提交預訂之前偵測此一不相符情況,以避免此預訂錯誤。在這種情況下,合作夥伴必須重新訂購旅宿,以根據旅客的帳單國家/地區要求新的價格。
- 合作夥伴可以限制僅接受在購物銷售點使用的卡片付款,以確保此一不相符情況不會發生。
客戶信用卡
- 請務必告知旅客,使用其他幣別進行預訂可能需支付國際交易手續費,而任何退款都有可能受匯率影響。
合作夥伴信用卡 (虛擬卡)
- 合作夥伴也必須將以其他幣別預訂的任何國際交易手續費列入考量。
- 合作夥伴不得刊登提供付款時間表的旅宿 (Rapid 購物保證金)
- 合作夥伴卡片必須設定為接受多筆收費,以允許任何必要的 ($0 或名目金額) 預先授權
- 合作夥伴卡片的帳單地址必須與其銷售點的帳單幣別相符
- 合作夥伴卡片設定必須允許以多種幣別收費,或者合作夥伴應保有一組卡片,以啟用收費並減少銀行費用。
- 合作夥伴應在傳送預訂要求前的數秒內啟動 VCC,以確保該卡片可進行收費
- 請參閱下方的進階整合部分,以了解有付款時間表之旅宿的詳細資訊
關鍵主題:旅宿損壞
可退款損壞保證金 (RDD):
- 旅宿所需的 RDD 會顯示在 Rapid 購物中,並代表在預訂時收取的保證金。如果旅客沒有對旅宿造成損壞,保證金將在旅客退房後 2 週內退款。
- 在 Rapid 購物要求中,必須使用排除參數來排除具有 RDD 的旅宿。
- 有關更多詳細信息,請參閱下面的高級集成部分。
存檔信用卡:
- 存檔信用卡表示在旅客離開旅宿後,若旅客對旅宿造成損壞,Vrbo 有權從所提供的卡片中扣款,金額最高可達 Rapid 購物中回傳的金額。提出損壞索賠時,Vrbo 將向旅客寄送損壞摘要和發票。如果使用預訂時提供的卡片收費失敗,Vrbo 將向旅客寄送通知,要求他們透過 Vrbo 網站提交付款。
- 應告知旅客如果旅宿在其住宿期間損壞,旅宿會向他們收取費用。這會在購物回應的
card_on_file_limit
物件下方回傳。 - 在 Rapid 購物要求中,必須使用排除參數來排除存檔信用卡旅宿。
關鍵主題:Vrbo 預訂的幣別代碼
購物請求中指定的幣別不會影響預訂的帳單幣別。
- 無法為 Vrbo 預訂指定幣別。帳單幣別將一律與旅宿指定的幣別一致。否則,價格檢查回應中返回的貨幣可能與 Rapid Shop 中返回的貨幣不同,並且是支付工具收費的計費貨幣。
- 使用虛擬卡付款的合作夥伴必須預留足夠的緩衝額度,以支付合作夥伴銀行收取的國際兌換費用。
- 請務必告知旅客國際交易可能產生的銀行費用,並提醒取消預訂的退款可能因匯率波動而不等於原始支付金額。
與住宿的主要區別
Vrbo 專屬欄位:
欄位 | 說明 |
---|---|
州/省 | 要求與其他 Rapid 飯店客房庫存不同。詳情請參閱下方資訊。 |
郵遞區號 | 要求與其他 Rapid 飯店客房庫存不同。詳情請參閱下方資訊。 |
欄位不適用 Vrbo 旅宿:
功能 | 說明 |
---|---|
暫停/繼續處理 | 目前與 Vrbo 與 Rapid 整合預訂不相容。 |
特殊要求 | 目前無法向旅宿提出特別要求。旅客應在預訂後與旅宿聯絡以提出特別要求。 |
旅客處理說明 | 目前不支援 Vrbo 預訂。 |
預訂與付款常見問題
**問題:**預訂申請需要哪些旅客資訊?
**解答:**Rapid 上的所有 Vrbo 預訂都需要旅客的電子郵件和電話號碼,以便與屋主進行連絡。這一點很重要,因為屋主可能會在旅客預訂後或抵達前,透過電子郵件提供與住宿相關的資訊,包括在旅客抵達時需協調與旅客會面或提供門禁密碼。
Post-booking 體驗
透過 Rapid API 完成 Vrbo 預訂後,合作夥伴應向客人提供有關 post-booking 體驗的指導。指南主題建議如下:
後續動作
- 屋主可能會傳訊息給旅客 (請看以下主題範例),電子郵件將會從 Vrbo (或 Vrbo 的當地品牌) 傳送。
- 如何使用 Rapid 住宿須知內容中提供的聯絡資訊來聯絡屋主。
- 入住登記指示應在抵達前 72 小時提供。如果在抵達前 48 小時內仍未收到,旅客必須立即聯繫支援人員。
- 額外付款要求
- 儘管 Rapid API 不支援對 Vrbo 預訂進行硬更改,但可以在 Rapid API 之外更改預訂。在這種情況下,快速檢索回應將僅包括總價格 (不包括每晚或住宿價格)。此外,請注意,由於 Rapid API 生態系統的性質,對於那些 Vrbo 修改的預訂,檢索延遲將高於 non-modified 檢索。
如何管理預訂
- 客人可以根據快速取消 API 透過合作夥伴網站取消預訂。
- 旅客可以向屋主提出變更要求,或透過取消再重新預訂來進行變更 (建議做法)。
- 如果在預訂建立後的 4 小時內嘗試取消,則 VRBO 庫存的取消請求將有特別考量。
- 該要求可能會回傳一個 http 代碼,指出後端需要額外的時間來進行處理。在此情況下,請等待幾分鐘後再次嘗試取消 (建議前 6 次每 10 分鐘嘗試一次,之後每 30 分鐘嘗試一次)。如果預訂建立 5 小時後取消嘗試仍然失敗,請聯絡 EPS 支援團隊並提供快速日誌。
如果發生問題
- 應告知旅客如何聯絡客服 (合作夥伴、客戶直接支援服務 (CDS) 或 Vrbo)。
- 建議旅客在問題出現時立即聯絡支援人員,切勿等到退房後才提出問題,因為 Vrbo 無法在退房後解決問題。
- 如果旅客無法進入旅宿,應先行嘗試聯絡屋主。如果無法成功聯絡屋主,旅客應立即聯繫合作夥伴,以尋求支援。如果旅客自行安排其他住宿,將不會獲得退款。
**注意:**Vrbo 確認編號 (HA-########) 應提供給旅客,因為它是屋主和 Vrbo 支援人員唯一可用的參考編號,且所有 Vrbo 電子郵件中都會引用此編號。
關鍵主題:Post-booking 付款
Vrbo 屋主可能會在預訂完成後或旅客入住後提出額外的付款要求。付款要求將透過 Vrbo 傳送給旅客的電子郵件進行,當中包含付款頁面的連結 (無需登入)。旅客應注意,若未支付屋主要求的任何額外費用,預訂可能會遭到取消。屋主要求的所有費用均包含在 Rapid 內容的任意文字欄位中,例如 free_text 屬性描述、住宿規定或租賃合約。
額外付款要求的範例包括:
- 支付寵物保證金
- 如果屋主要求延長住宿,則需支付額外的住宿費用
- 支付住宿期間費用,例如電費或毛巾使用費。
- 旅宿損壞賠償
請參閱附錄 5 中 stay-collected 費用的範例
與其他住宿選擇的主要區別
Vrbo 專屬欄位:
欄位 | 說明 |
---|---|
住宿須知內容 | 代表 Vrbo 歡迎指南,應在預訂建立後立即提供給旅客。請參閱 Vrbo 住宿須知內容指南了解更多詳情。 |
欄位不適用 Vrbo 旅宿:
欄位 | 說明 |
---|---|
取消退款金額 | 不適用於 Vrbo 與 Rapid 整合預訂。 |
對話記號 | 不適用於 Vrbo 與 Rapid 整合預訂。 |
無價差變更 | 不支援 Vrbo 預訂。旅客應直接透過電子郵件向屋主請求變更或聯絡客服。 |
有價差變更 | 不支援 Vrbo 預訂。旅客應直接透過電子郵件向屋主請求變更或聯絡客服。 |
Post-booking 常見問題解答
**問題:**我的旅客會從 Vrbo 收到哪些電子郵件?
**解答:**旅客不會收到 Vrbo 的預訂或取消確認。合作夥伴可以根據 Rapid 行程 API 提供這些確認。
**問題:**我的旅客會收到屋主 (透過 Vrbo) 的哪些電子郵件?
**解答:**旅客將使用建立預訂時傳送的旅客電子郵件接收屋主的對話。對話所包含的資訊可能對旅客的旅宿入住和體驗至關重要,也可做為住宿期間的溝通管道。這些電子郵件可能會由 Vrbo 提供,或由屋主直接傳送。屋主也可以透過其他方式聯繫,例如簡訊或 WhatsApp。
**問題:**可以透過 Rapid Cancel API 取消 Rapid 上的 Vrbo 預訂嗎?
**解答:**是,所有 Vrbo 與 Rapid 整合預訂都可以使用 Rapid 行程回應上的取消記號取消。或者,旅客可以向旅宿管理者或支援人員提出取消要求。
**問題:**Vrbo 網站提供哪些預訂後功能?
**解答:**旅客的 Vrbo 帳戶無法存取在合作夥伴網站上進行的 Vrbo 預訂。旅客只能使用 Vrbo 收件匣 (包含旅客和屋主之間的對話)。
**問題:**如何更改 Vrbo 預訂?
**解答:**建議旅客取消預訂並重新預訂,但旅客可以透過與屋主溝通,透過支援人員發出變更要求等方式,要求變更 Vrbo 預訂。
**問題:**我會收到預訂更改或取消的 Rapid 通知嗎?
**解答:**訂閱快速通知的合作夥伴將在預訂發生變更或取消時收到通知。請注意,我們目前無法確定是誰更改了預訂。
**問題:**Vrbo 屋主對話是否與 Property Message Center 可以一起使用?
**解答:**目前不行。
**問題:**旅客將如何收到入住資訊?
**解答:**合作夥伴需負責在旅客抵達前 72 小時,向其傳送歡迎指南。本歡迎指南的內容來自 Rapid 行程 API 中的 Rapid 住宿須知內容。請注意,並非所有屋主都會運用此功能。許多屋主會透過電子郵件對話的形式,向旅客傳送歡迎指南。如果旅客在抵達前的 48 小時內未收到入住指示,請務必建議他們聯絡合作夥伴支援人員,以尋求聯絡屋主或尋找其他類住宿的協助。請參閱 Rapid 住宿須知內容了解更多詳情。
**問題:**Vrbo 預訂經確認後,住宿可以取消嗎?
**解答:**可以,旅宿管理者可以在預訂後到旅客抵達前的任何時間取消 Vrbo 預訂。這通常會發生在建立預訂後的一天內,也就是旅宿管理者發現其旅宿在該日期沒有空房時。如果這種情況發生在客人抵達之前,VrboCare 將協助客人尋找合適的替代住宿。請參閱 Vrbo 與 Rapid 整合支援指南了解更多詳情。
**問題:**屋主會因取消預訂而受到處罰嗎?
**解答:**旅宿管理者的取消頻率是決定優質屋主資格的因素之一,且會影響旅宿在搜尋結果中的排名,因此,旅宿管理者對於取消應謹慎操作,且只在必要時進行。使用優質屋主狀態在搜尋結果最上方顯示最佳旅宿,可協助合作夥伴降低此一風險。
進階整合指南
進階情境:可退款損壞保證金 (RDD)
部分 Vrbo 旅宿要求在入住前收取損壞保證金,並在退房後根據旅宿狀況提供退款。由於 RDD 金額可能很高,並讓合作夥伴和旅客難以接受,因此,我們強烈建議在合作夥伴搜尋結果中排除這些旅宿。
關於 RDD
- 在假日等需求較高的期間,可能會出現更多請求 RDD 的旅宿。
- 大約 2% 的旅宿需要在入住前支付可退款的損壞訂金。
- RDD 金額和要求可能因地理位置和季節而異。
請務必告知旅客
- 損壞訂金將在最後一次預定付款時支付 (如果是單次付款,則在預訂時支付)。

- 損壞保證金將根據屋主的檢查情況,在退房後的 14 天內退款。
- 如果發生損壞,Vrbo 將透過電子郵件傳送損壞金額的發票給旅客。
- 結帳時,請務必顯示可退款損壞保證金的金額。
- Rapid 購物中顯示的 RDD 金額是估計值。Rapid 價格檢查中的金額是向旅客收取的金額,必須在結帳時向旅客顯示。
合作夥伴為正式商家:
- 我們建議合作夥伴透過虛擬卡提供付款時排除 RDD,除非他們能夠協助向旅客收取和退還損壞訂金。
- 合作夥伴負責向旅客顯示金額並分別進行收款/退款作業。
範例:
"rates": [
{
"refundable_damage_deposit": {
"value": "150.00",
"currency": "USD"
}
}
]
進階情境:旅客信用卡
使用旅客信用卡需要進行額外的驗證,並與旅客溝通。
地址驗證
由於某些國家不需要郵政編碼,而某些國家/地區則需要額外的詳細信息,因此 Vrbo 預訂需要與其他住宿選項不同的地址驗證。
郵遞區號為 的國家

沒有郵遞區號的國家

國家/地區郵遞區號和其他詳細資訊

受支援的國家列表請參閱附錄 4。
進階情境:付款時間表
Vrbo 旅宿有時會根據預先定義的時間表收取付款。這些旅宿可透過合作夥伴簡介設定來啟用/停用。如果存在這類型的旅宿,付款時間表將以保證金的形式顯示在 Rapid 購物中,並與入住時付款一致。如需如何識別保證金的詳細資訊,請參閱 Rapid 購物文件。
關於保證金 (付款時間表)
- 約 20-30% 的旅宿會針對超過 3 個月的較長提前預訂天數提供付款時間表。
- 不到 15% 的旅宿會針對不到 1 個月的較短提前預訂天數提供付款時間表。
請務必告知旅客
- 付款安排詳情應在購物/結帳期間顯示,最好以圖像的時間軸檢視形式顯示。
範例:
"deposits": [
{
"value": "412.10",
"due": "2023-05-17",
"currency": "USD"
},
{
"value": "236.17",
"due": "2023-08-24",
"currency": "USD"
}
]

- 必須告知旅客,他們有責任根據提供的時間表在 Vrbo 網站上付款,否則有遭屋主取消預訂的風險。
- Vrbo 將在付款到期日之前、當天和之後寄送電子郵件提醒,以確保旅客了解付款要求。
與可退款損壞訂金結合:
- 當需要 RDD 時,它將做為最後預定付款的一部分收取。如果是一次性付款,則將在預訂時收取。
與合作夥伴為正式商戶的組合:
- 由於 Vrbo.com 上的手動付款要求,我們不建議將已有付款安排的旅宿視為合作夥伴為正式商戶進行預訂。
附錄 1:屋主聯絡方式
所有 Vrbo 預訂都必須留下旅客電子郵件地址,以方便旅宿管理者和旅客直接溝通。在某些情況下,使用合作夥伴/服務專員電子郵件可能會導致屋主取消預訂。
旅宿管理者聯絡旅客的內容包括以下幾種:
- 歡迎訊息和旅宿管理者自我介紹
- 聯絡資訊
- 住宿規定和行前須知
- 地址和交通資訊
- 鑰匙箱密碼
- 付款安排
- 租賃合約 (有些旅宿管理者會要求履行,否則便取消預訂)
- 護照相片要求 (有些旅宿管理者會要求提供這項資訊,否則將取消預訂)
- 屋主回應訊息
- 旅客傳訊息給屋主
範例:

附錄 2:Vrbo 聯絡方式
透過 Rapid API 進行的預訂將不會收到以下 Vrbo 電子郵件:
- 預訂確認
- 由旅客取消的預訂
- 由旅宿取消預訂
- 預訂退款確認
- 歡迎指南
- 再行銷
- 旅客評論請求
- 客服體驗評論請求
- 取消後的旅客再行銷
可能傳送給旅客的其他 Vrbo 付款相關電子郵件,包括支付額外住宿費用 (例如寵物費)、變更 (額外住宿晚數)、損壞賠償金:
- 要求額外付款
- 付款確認
- 收到付款
- 旅宿損壞報告
根據旅客與 Vrbo.com 互動的其他電子郵件
- 建立帳戶
- 重設密碼
- 密碼重設確認
- 建立密碼
進階整合情境專屬的 Vrbo 電子郵件範本:
- 欺詐取消
- 收取損壞保證金 – 僅適用於具有 RDD 的旅宿
- 損壞保證金收據 – 僅適用於具有 RDD 的旅宿
- 申請損壞保證金 – 僅適用於具有 RDD 的旅宿
- 付款時間表逾期 – 僅適用於具有付款時間表的旅宿
附錄 3:向旅客呈現的品牌
銷售點 | 面向旅客的品牌 |
---|---|
法國 | Abritel |
德國 | Fewo-Direkt |
澳洲 | Stayz |
紐西蘭 | Bookabach |
其他 | Vrbo |
附錄 4:地址驗證
為了驗證地址,以下國家需要郵遞區號。有些還需要額外的詳細資訊。
- 阿根廷
- 澳洲 (+ 州)
- 奧地利
- 巴西 (+ 州和 CPF/CNPJ 納稅人 ID;如果使用巴西銷售點,也必須包括街區)
- 加拿大 (+ 省)
- 丹麥
- 法國
- 德國
- 英國
- 希臘
- 義大利
- 日本 (無需郵遞區號,但需要填寫州和地址第 2 行)
- 荷蘭
- 挪威
- 波蘭
- 葡萄牙
- 西班牙
- 瑞典
- 土耳其
- 美國 (無需郵遞區號,但必須包含州)
附錄 5:Stay-collected 費用範例
飯店收取的費用可能包括:
- 行政費
- 空調
- 俱樂部
- 電力
- 暖氣
- 浴缸
- 網路
- 洗衣設施
- 床單
- 毛巾
- 停車位
- 游泳池
- 住宿附加費
- 水