Vrbo on 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 选购中，与 Property Collect 保持一致。请参阅 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 预订都必须包含客户邮箱，以促进物业经理和旅客之间的直接沟通。在某些情况下，使用合作伙伴/客服邮箱可能会导致房东取消预订。
物业经理通信的示例包括：
- 欢迎消息及物业经理介绍
- 详细联系信息
- 政策和旅行须知
- 地址和路线
- 钥匙箱密码
- 付款安排
- 租房协议（可能需要，否则物业经理可能会取消预订）
- 护照照片要求（可能需要，否则物业经理可能会取消预订）
- 房东回复消息
- 旅客向房东发送消息
示例：
