Vrbo 與 Rapid 整合指南
為合作夥伴提供的 Vrbo 整合流程指南。
簡介
本文旨在介紹 Rapid 與 Vrbo 整合流程，包括整合方式、API 要求與回應範例、限制、錯誤處理和常見問題。
本指南主要針對我們推薦的 Vrbo 供應優惠。如需進階使用案例，請參閱下方的進階整合指南。
|
進階情境：可退款損壞保證金 (RDD)
部分 Vrbo 旅宿要求在入住前收取損壞保證金，並在退房後根據旅宿狀況提供退款。由於 RDD 金額可能很高，並讓合作夥伴和旅客難以接受，因此，我們強烈建議在合作夥伴搜尋結果中排除這些旅宿。
關於 RDD
- 在假日等需求較高的期間，可能會出現更多請求 RDD 的旅宿。
- 大約 2% 的旅宿需要在入住前支付可退款的損壞訂金。
- RDD 金額和要求可能因地理位置和季節而異。
請務必告知旅客
- 損壞訂金將在最後一次預定付款時支付 (如果是單次付款，則在預訂時支付)。
- 損壞保證金將根據屋主的檢查情況，在退房後的 14 天內退款。
- 如果發生損壞，Vrbo 將透過電子郵件傳送損壞金額的發票給旅客。
- 結帳時，請務必顯示可退款損壞保證金的金額。
- Rapid 購物中顯示的 RDD 金額是估計值。Rapid 價格檢查中的金額是向旅客收取的金額，必須在結帳時向旅客顯示。
合作夥伴為正式商家：
- 我們建議合作夥伴透過虛擬卡提供付款時排除 RDD，除非他們能夠協助向旅客收取和退還損壞訂金。
- 合作夥伴負責向旅客顯示金額並分別進行收款/退款作業。
範例：
"rates": [
{
"refundable_damage_deposit": {
"value": "150.00",
"currency": "USD"
}
}
]
進階情境：旅客信用卡
使用旅客信用卡需要進行額外的驗證，並與旅客溝通。
地址驗證
- Vrbo 預訂需要的地址驗證與 Rapid 住宿不同。
詳情見下文：
| 具有郵遞區號的國家/地區 | 不具郵遞區號的國家/地區 | 具有郵遞區號和其他詳細資訊的國家/地區 |
|---|---|---|
 |  |  |
| 阿富汗 | 安哥拉 | 澳洲：州 |
| 奧蘭群島 | 安地卡及巴布達 | 巴西：州 (+BR POSA 上的鄰近地區) 和 CPF/CNPJ |
| 阿爾巴尼亞 | 阿魯巴 | 加拿大：省 |
| 美屬薩摩亞 | 巴哈馬 | 日本：州和地址第 2 行 |
| 安道爾 | 貝里斯 | 西班牙：國民身份證 |
| 安圭拉 | 貝南 | 美國：州 |
| 南極洲 | 波札那 | |
| 阿根廷 | 布吉納法索 | |
| 亞美尼亞 | 蒲隆地 | |
| 奧地利 | 喀麥隆 | |
| 亞塞拜然 | 中非共和國 | |
| 巴林 | 葛摩 | |
| 孟加拉 | 剛果 | |
| 巴貝多 | 剛果民主共和國 | |
| 白俄羅斯 | 庫克群島 | |
| 比利時 | 象牙海岸 | |
| 百慕達 | 吉布地 | |
| 不丹 | 多明尼加 | |
| 多民族玻利維亞國† | 赤道幾內亞 | |
| 波士尼亞與赫塞哥維納 | 厄利垂亞 | |
| 布威島 | 斐濟 | |
| 英屬印度洋領土 | 法屬南部屬地 | |
| 汶萊 | 甘比亞 | |
| 保加利亞 | 迦納 | |
| 柬埔寨 | 格瑞納達 | |
| 維德角 | 幾內亞 | |
| 開曼群島 | 圭亞那 | |
| 查德 | 香港 | |
| 智利 | 愛爾蘭†† | |
| 中國 | 肯亞 | |
| 聖誕島 | 吉里巴斯 | |
| 科科斯 (基林) 群島 | 澳門 | |
| 哥倫比亞 | 馬拉威 | |
| 哥斯大黎加 | 馬利 | |
| 克羅埃西亞 | 茅利塔尼亞 | |
| 古巴 | 模里西斯 | |
| 賽普勒斯 | 蒙哲臘 | |
| 捷克共和國 | 諾魯 | |
| 丹麥 | 紐威島 | |
| 多明尼加共和國 | 巴拿馬 | |
| 厄瓜多 | 卡達 | |
| 埃及 | 盧安達 | |
| 薩爾瓦多 | 聖克里斯多福及尼維斯 | |
| 愛沙尼亞 | 聖露西亞 | |
| 衣索比亞 | 聖多美普林西比 | |
| 福克蘭群島 (馬爾維納斯) | 塞席爾 | |
| 法羅群島 | 獅子山 | |
| 芬蘭 | 索羅門群島 | |
| 法國 | 索馬利亞†† | |
| 法屬圭亞那 | 南非†† | |
| 法屬玻里尼西亞 | 蘇利南 | |
| 加彭 | 敘利亞阿拉伯共和國 | |
| 喬治亞 | 坦尚尼亞聯合共和國 | |
| 德國 | 東帝汶 | |
| 直布羅陀 | 托克勞 | |
| 希臘 | 東加 | |
| 格陵蘭 | 千里達及托巴哥 | |
| 瓜地洛普 | 吐瓦魯 | |
| 關島 | 烏干達 | |
| 瓜地馬拉 | 阿拉伯聯合大公國 | |
| 幾內亞比索 | 萬那杜 | |
| 海地 | 葉門 | |
| 赫德島及麥當勞群島† | 辛巴威 | |
| 教廷 (梵蒂岡城) | ||
| 宏都拉斯 | ||
| 匈牙利 | ||
| 冰島 | ||
| 印度 | ||
| 印尼 | ||
| 伊朗伊斯蘭共和國 | ||
| 伊拉克 | ||
| 以色列 | ||
| 義大利 | ||
| 牙買加 | ||
| 約旦 | ||
| 哈薩克 | ||
| 大韓民國 | ||
| 科威特 | ||
| 吉爾吉斯 | ||
| 寮人民民主共和國 | ||
| 拉脫維亞 | ||
| 黎巴嫩 | ||
| 賴索托 | ||
| 賴比瑞亞 | ||
| 利比亞† | ||
| 列支敦斯登 | ||
| 立陶宛 | ||
| 盧森堡 | ||
| 前南斯拉夫馬其頓共和國 | ||
| 馬達加斯加 | ||
| 馬來西亞 | ||
| 馬爾地夫 | ||
| 馬爾他 | ||
| 馬紹爾群島 | ||
| 法屬馬丁尼克 | ||
| 馬約特 | ||
| 墨西哥 | ||
| 密克羅尼西亞聯邦 | ||
| 摩爾多瓦 | ||
| 摩納哥 | ||
| 蒙古 | ||
| 蒙特內哥羅 | ||
| 摩洛哥 | ||
| 莫三比克 | ||
| 緬甸 | ||
| 納米比亞 | ||
| 尼泊爾 | ||
| 荷蘭 | ||
| 新喀里多尼亞 | ||
| 紐西蘭 | ||
| 尼加拉瓜 | ||
| 尼日 | ||
| 諾福克島 | ||
| 北馬里亞納群島 | ||
| 挪威 | ||
| 阿曼 | ||
| 帛琉 | ||
| 巴勒斯坦國 | ||
| 巴布亞紐幾內亞 | ||
| 巴拉圭 | ||
| 秘魯 | ||
| 菲律賓 | ||
| 皮特肯 | ||
| 波蘭 | ||
| 葡萄牙 | ||
| 波多黎各 | ||
| 留尼旺 | ||
| 羅馬尼亞 | ||
| 俄羅斯聯邦 | ||
| 聖巴瑟米 | ||
| 聖赫勒拿、亞森欣與崔斯坦達庫尼亞 | ||
| 聖皮耶與密克隆群島 | ||
| 聖文森及格瑞那丁 | ||
| 薩摩亞 | ||
| 聖馬利諾 | ||
| 塞內加爾 | ||
| 塞爾維亞 | ||
| 塞爾維亞與蒙特內哥羅 | ||
| 新加坡 | ||
| 斯洛伐克 | ||
| 斯洛維尼亞 | ||
| 南喬治亞與南桑威奇 | ||
| 斯里蘭卡 | ||
| 蘇丹 | ||
| 斯瓦巴及尖棉島 | ||
| 史瓦濟蘭 | ||
| 瑞典 | ||
| 瑞士 | ||
| 台灣 | ||
| 塔吉克 | ||
| 泰國 | ||
| 多哥† | ||
| 突尼西亞 | ||
| 土耳其 | ||
| 土庫曼 | ||
| 土克凱可群島 | ||
| 烏克蘭 | ||
| 英國 | ||
| 美國邊疆群島 | ||
| 烏拉圭 | ||
| 烏茲別克 | ||
| 委內瑞拉玻利瓦共和國 | ||
| 越南 | ||
| 英屬維京群島 | ||
| 美屬維京群島 | ||
| 瓦利斯和富圖那 | ||
| 西撒哈拉 | ||
| 尚比亞 |
†提供部分郵遞區號，但在 Vrbo 結帳時仍強制規定使用的國家/地區。
††提供部分郵遞區號，但我們並未強制規定使用的國家/地區。
進階情境：付款時間表
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 上的手動付款要求，我們不建議將已有付款安排的旅宿視為合作夥伴為正式商戶進行預訂。
所有 Vrbo 預訂都必須留下旅客電子郵件地址，以方便旅宿管理者和旅客直接溝通。在某些情況下，使用合作夥伴/服務專員電子郵件可能會導致屋主取消預訂。
旅宿管理者聯絡旅客的內容包括以下幾種：
- 歡迎訊息和旅宿管理者自我介紹
- 聯絡資訊
- 住宿規定和行前須知
- 地址和交通資訊
- 鑰匙箱密碼
- 付款安排
- 租賃合約 (有些旅宿管理者會要求履行，否則便取消預訂)
- 護照相片要求 (有些旅宿管理者會要求提供這項資訊，否則將取消預訂)
- 屋主回應訊息
- 旅客傳訊息給屋主
範例：
