Vrbo on Rapid 集成指南
面向合作伙伴的 Vrbo 集成流程指南。
概述
本文提供了 Rapid Vrbo 集成流程的指南，包括工作方式、示例 API 请求和响应、限制、错误处理和常见问题解答。
本指南适用于我们推荐的 Vrbo 供应产品。有关高级用例，请参阅下面的《高级集成指南》。
场景 1：可退款的损坏押金 (RDD)
部分 Vrbo 住宿要求在抵达前收取损坏押金，并在退房后根据住宿状况提供退款。
关于 RDD
- 在假期等需求高峰期间，可能会有更多住宿要求支付 RDD。
- 大约 2% 的住宿需要在抵达前支付可退款的损坏押金。
- RDD 的金额和要求可能因地理位置和季节而异。
必须告知住客
- 损坏押金将在安排的最后一次付款时支付（或者，如果是一次性付款，则在预订时支付）。
- 损坏押金将根据房东的检查情况在退房后 12 天内退还。
- 如果发生损坏，Vrbo 将向住客发送损坏费用发票。
- 付款时必须显示可退款的损坏押金的金额。
- Rapid 选购中显示的 RDD 金额是估计值。Rapid 价格检查中的金额是向住客收取的金额，必须在付款时向住客显示。
合作伙伴记录商户：
- 我们建议当合作伙伴通过虚拟卡付款时排除 RDD，除非他们能够协助向住客收取和退还损坏押金。
- 合作伙伴负责向住客显示金额并相应地收费/退款。
示例：
"rates": [
{
"refundable_damage_deposit": {
"value": "150.00",
"currency": "USD"
}
}
]
场景 2：客户信用卡
使用客户信用卡需要额外验证并与住客沟通。
地址验证
- Vrbo 预订需要的地址验证与 Rapid 住宿不同。
详情见下文：
| 有邮政编码的国家/地区 | 没有邮政编码的国家/地区 | 有邮政编码和其他详细信息的国家/地区 |
|---|---|---|
 |  |  |
| 阿富汗 | 安哥拉 | 澳大利亚：州 |
| 奥兰群岛 | 安提瓜和巴布达 | 巴西：州（+BR POSA 上的街区）和 CPF/CNPJ |
| 阿尔巴尼亚 | 阿鲁巴 | 加拿大：省 |
| 美属萨摩亚 | 巴哈马 | 日本：都道府县和地址第 2 行 |
| 安道尔 | 伯利兹 | 西班牙：身份证号码 |
| 安圭拉 | 贝宁 | 美国：州 |
| 南极洲 | 博茨瓦纳 | |
| 阿根廷 | 布基纳法索 | |
| 亚美尼亚 | 布隆迪 | |
| 奥地利 | 喀麦隆 | |
| 阿塞拜疆 | 中非共和国 | |
| 巴林 | 科摩罗 | |
| 孟加拉国 | 刚果 | |
| 巴巴多斯 | 刚果民主共和国 | |
| 白俄罗斯 | 库克群岛 | |
| 比利时 | 科特迪瓦 | |
| 百慕大 | 吉布提 | |
| 不丹 | 多米尼克 | |
| 玻利维亚（多民族国）† | 赤道几内亚 | |
| 波斯尼亚和黑塞哥维那 | 厄立特里亚 | |
| 布韦岛 | 斐济 | |
| 英属印度洋领地 | 法国南部领土 | |
| 文莱达鲁萨兰国 | 冈比亚 | |
| 保加利亚 | 加纳 | |
| 柬埔寨 | 格林纳达 | |
| 佛得角 | 几内亚 | |
| 开曼群岛 | 圭亚那 | |
| 乍得 | 香港特区 | |
| 智利 | 爱尔兰†† | |
| 中国 | 肯尼亚 | |
| 圣诞岛 | 基里巴斯 | |
| 科科斯群岛 | 澳门特别行政区 | |
| 哥伦比亚 | 马拉维 | |
| 哥斯达黎加 | 马里 | |
| 克罗地亚 | 毛里塔尼亚 | |
| 古巴 | 毛里求斯 | |
| 塞浦路斯 | 蒙特塞拉特岛 | |
| 捷克共和国 | 瑙鲁 | |
| 丹麦 | 纽埃岛 | |
| 多米尼加共和国 | 巴拿马 | |
| 厄瓜多尔 | 卡塔尔 | |
| 埃及 | 卢旺达 | |
| 萨尔瓦多 | 圣基茨和尼维斯 | |
| 爱沙尼亚 | 圣卢西亚 | |
| 埃塞俄比亚 | 圣多美和普林西比 | |
| 福克兰群岛（马尔维纳斯群岛） | 塞舌尔 | |
| 法罗群岛 | 塞拉利昂 | |
| 芬兰 | 所罗门群岛 | |
| 法国 | 索马里†† | |
| 法属圭亚那 | 南非†† | |
| 法属玻利尼西亚 | 苏里南 | |
| 加蓬 | 叙利亚阿拉伯共和国 | |
| 格鲁吉亚 | 坦桑尼亚联合共和国 | |
| 德国 | 东帝汶 | |
| 直布罗陀 | 托克劳群岛 | |
| 希腊 | 汤加 | |
| 格陵兰岛 | 特立尼达和多巴哥 | |
| 瓜德罗普 | 图瓦卢 | |
| 关岛 | 乌干达 | |
| 危地马拉 | 阿拉伯联合酋长国 | |
| 几内亚比绍 | 瓦努阿图 | |
| 海地 | 也门 | |
| 赫德岛和麦克唐纳群岛† | 津巴布韦 | |
| 梵蒂冈（梵蒂冈城国） | ||
| 洪都拉斯 | ||
| 匈牙利 | ||
| 冰岛 | ||
| 印度 | ||
| 印度尼西亚 | ||
| 伊朗伊斯兰共和国 | ||
| 伊拉克 | ||
| 以色列 | ||
| 意大利 | ||
| 牙买加 | ||
| 约旦 | ||
| 哈萨克斯坦 | ||
| 韩国 | ||
| 科威特 | ||
| 吉尔吉斯斯坦 | ||
| 老挝人民民主共和国 | ||
| 拉脱维亚 | ||
| 黎巴嫩 | ||
| 莱索托 | ||
| 利比里亚 | ||
| 利比亚† | ||
| 列支敦士登 | ||
| 立陶宛 | ||
| 卢森堡 | ||
| 马其顿共和国 | ||
| 马达加斯加 | ||
| 马来西亚 | ||
| 马尔代夫 | ||
| 马耳他 | ||
| 马绍尔群岛 | ||
| 马提尼克 | ||
| 马约特岛 | ||
| 墨西哥 | ||
| 密克罗尼西亚联邦 | ||
| 摩尔达维亚共和国 | ||
| 摩纳哥 | ||
| 蒙古 | ||
| 黑山 | ||
| 摩洛哥 | ||
| 莫桑比克 | ||
| 缅甸 | ||
| 纳米比亚 | ||
| 尼泊尔 | ||
| 荷兰 | ||
| 新喀里多尼亚 | ||
| 新西兰 | ||
| 尼加拉瓜 | ||
| 尼日尔 | ||
| 诺福克岛 | ||
| 北马里亚纳群岛 | ||
| 挪威 | ||
| 阿曼 | ||
| 帕劳 | ||
| 巴勒斯坦国 | ||
| 巴布亚新几内亚 | ||
| 巴拉圭 | ||
| 秘鲁 | ||
| 菲律宾 | ||
| 皮特凯恩 | ||
| 波兰 | ||
| 葡萄牙 | ||
| 波多黎各 | ||
| 留尼汪岛 | ||
| 罗马尼亚 | ||
| 俄罗斯联邦 | ||
| 圣巴泰勒米 | ||
| 圣赫勒拿、阿森松岛和特里斯坦达昆哈 | ||
| 圣皮埃尔和密克隆群岛 | ||
| 圣文森特和格林纳丁斯 | ||
| 萨摩亚 | ||
| 圣马力诺 | ||
| 塞内加尔 | ||
| 塞尔维亚 | ||
| 塞尔维亚和黑山 | ||
| 新加坡 | ||
| 斯洛伐克 | ||
| 斯洛文尼亚 | ||
| 南乔治亚和南德桑威奇群岛 | ||
| 斯里兰卡 | ||
| 苏丹 | ||
| 斯瓦尔巴特和扬马延 | ||
| 斯威士兰 | ||
| 瑞典 | ||
| 瑞士 | ||
| 中国台湾 | ||
| 塔吉克斯坦 | ||
| 泰国 | ||
| 多哥† | ||
| 突尼斯 | ||
| 土耳其 | ||
| 土库曼斯坦 | ||
| 特克斯和凯科斯群岛 | ||
| 乌克兰 | ||
| 英国 | ||
| 美属外岛 | ||
| 乌拉圭 | ||
| 乌兹别克斯坦 | ||
| 委内瑞拉玻利维亚共和国 | ||
| 越南 | ||
| 英属维尔京群岛 | ||
| 美属维尔京群岛 | ||
| 瓦利斯和富图纳群岛 | ||
| 西撒哈拉 | ||
| 赞比亚 |
†国家/地区提供了部分邮政编码，但在 Vrbo 付款时仍强制使用。
††国家/地区提供了部分邮政编码，但在付款时不强制使用。
必须告知住客
- 关于谁将向其卡收费的说明。
- 银行收费：应提醒住客，银行可能会收取国际交易费用。
- 退款：应提醒住客，汇率波动可能会影响退款金额。
损坏：必须告知住客最高收费金额以及收费/退款时间
- 最高收费金额在
refundable_damage_deposit下的 Rapid 选购响应中提供。 - 如果住宿有损坏，我们将从住客的卡中收取损坏费用，但不会超过规定的最高金额。
- 如果发生损坏，Vrbo 将向住客发送损坏费用发票。
预订错误：选购国家/地区与客户国家/地区（帐单地址）不同
Vrbo 住宿的价格可能会因住客所在的位置而异。该位置由住客在付款时输入的帐单地址来确定。因此，合作伙伴必须在提交预订之前发现这种不一致的情况，以避免预订错误。如果国家/地区不同，合作伙伴必须根据住客的账单所在国家/地区获取新价格。
**选项 1：**在提交之前，预订合作伙伴应将选购所在国家/地区与住客账单所在国家/地区进行比较。如果不同，请使用帐单地址国家/地区重新选购，显示更新的价格并允许住客重新提交预订。
**选项 2：**将付款页面上的帐单地址字段限制为仅 POSa 国家/地区。
场景 3：付款安排
Vrbo 住宿有时会根据预先定义的时间表收取付款。
关于押金（付款安排）
- 约 25% 的住宿提供超过 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 预订都必须包含客户邮箱，以促进物业经理和旅客之间的直接沟通。在某些情况下，使用合作伙伴/客服邮箱可能会导致房东取消预订。
物业经理通信的示例包括：
- 欢迎消息及物业经理介绍
- 详细联系信息
- 政策和旅行须知
- 地址和路线
- 钥匙箱密码
- 付款安排
- 租房协议（可能需要，否则物业经理可能会取消预订）
- 护照照片要求（可能需要，否则物业经理可能会取消预订）
- 取消确认
- 退款确认
示例：
