Vrbo on Rapid 集成指南
Vrbo 集成流程指南
概述
本文提供了 Rapid Vrbo 集成流程的指南,包括工作方式、示例 API 请求和响应、限制、错误处理和常见问题解答。
本指南适用于我们推荐的 Vrbo 供应产品。有关高级用例,请参阅下面的《高级集成指南》。
地理
需要了解
如果您正在使用 Rapid Geography API 并已启用 Vrbo,则除了传统的住宿房源外,您还可以从所有 Geography 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 内容通过与其他住宿选项相同的 Rapid Content API 提供,通过传递
supply_source=vrbo,但请注意以下架构的差异。 - 与其他 Rapid 住宿选项相比,Vrbo 的内容会受到物业经理更频繁的更新。不正确的住宿房源信息可能会导致较差的住客体验、支持电话和退款申请。我们强烈建议您至少每周更新一次 Vrbo 内容,以确保客人能够准确了解房源、设施和政策。
- Vrbo 优质房东计划是一项仅限受邀房东参加的福利,该计划面向的是那些经证实可以通过较低的房东取消率、住客好评和通过 Vrbo 平台为住客提供服务的体验来提供积极住客体验的房东。您可以使用以下方式识别高级主机属性
attribute_id=1073745445。此外,您可以在请求中添加attribute_id=1073745445来筛选结果,仅返回高级房东房源。
与其他住宿选择的主要区别
在内容文件 API 中,Vrbo 房源与其他 Rapid Lodging 选项是分开提供的。
Vrbo-specific 字段
| 字段 | 说明 |
|---|---|
vacation_rental_details:registry_number | 必填字段,用于显示度假短租住宿。有关更多详细信息,请参阅上线要求。 |
| 私人房东负责接待 | 属性 1073745102“私有主机属性”表示该属性由私有主机管理。必须显示该信息以及其他必要的介绍。有关更多详细信息,请参阅上线要求。 |
| 专业房东房源 | 属性 1073745142“专业房东/经理”表示该房产由专业房东/经理管理。必须显示该信息以及其他必要的介绍。有关更多详细信息 ,请参阅上线要求。 |
| 优质房东 | 属性 1073745445“高级合作伙伴”表示该房产由高级房东管理。可用于为房源添加“优质房东”标识,或筛选结果以仅返回“优质房东”房源。 |
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 | 已弃用此字段。请勿使用。请参阅发布要求,了解推荐的 check-out 显示文本。 >> 查看发布要求 |
与 Vrbo 房源无关的字段
| 字段 | 说明 |
|---|---|
| 住宿评分 | 目前 Vrbo 住宿尚不支持评分。可以使用住客打分来代替。 |
| 客房介绍 | 与独立单元度假短租住宿无关。应使用客房级别的信息。 |
| 房价计划 | 与 Vrbo 住宿无关。 |
| 客房级别信息 | 所有客房介绍信息均在住宿级别提供。由于 Vrbo 住宿没有客房级别的内容,通常在客房级别的服务设施则包含在名为 vacation_rental_details 的新部分中。 |
vrbo_srp_id、 listing_id、 listing_number、 listing_source、 listing_unit | 这些字段仅与 Vrbo Link-off 模式有关,但也可用于住宿映射/匹配。 |
IPM_Name | 仅供参与 Vrbo IPM 试用的合作伙伴使用。值提供 IPM 名称,并应告知住客商家向住客卡片收费并向住客发送有关其住宿的电子邮件。 |
内容常见问题解答
**问:**如果 Rapid 内容中没有提供街道地址,我该如何在地图上定位 Vrbo 内容?
**答:**可使用 Rapid 地理 API 和/或住宿经纬度值对住宿进行地理定位。
**问:**Vrbo 住宿是否包含在 Rapid 内容文件中?
**答:**是。可以通过在 API 请求中传递 supply_source=vrbo 来检索 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 Shopping API 中的 merchant_of_record字段对于 Rapid 上的 Vrbo 房源具有不同的含义。
- 它并不代表谁将从预订时提供的卡中收取费用。所有预订均需预付费用。
- 将 merchant 设置为 expedia(“商户”)表示将通过 EG 付款系统进行预订,该系统提供最佳的预订成功率和一致的错误描述。
- 将 merchant 设置为 property(“旅行社”)表示将由传统的 Vrbo 付款系统进行预订。默认禁用此供应产品的分销。请参阅高级集成部分了解更多信息。
- 住宿不绑定为单一模式。相反,“商户”资格基于 3 个关键因素:
- 没有可退款的损坏押金(不推荐高级集成选项,请参阅下面的高级集成部分)
- 没有订金政策/付款安排(不推荐高级集成选项,请参阅下面的高级集成部分)
- 需要以目的地货币进行搜索,才能查看房态。
关键主题:Vrbo 预订的货币代码
商店请求中指定的货币不会影响预订的结算货币。
- 无法为 Vrbo 预订指定货币。记账货币将始终与住宿使用的货币保持一致。
- 重要提示:作为“商家”,您必须在每个店铺请求中包含目的地货币,才能访问最多的 Vrbo 商品供应。如果未提供目标货币,则商店响应中只会返回房东选择以该指定货币付款的可用房源。有关各地区目标货币的建议,请参阅附录,或联系您的 Partner Connect 联系人以获取更详细的映射信息。
关键主题:Vrbo 预订的国家/地区代码
购物 API 请求中指定的国家/地区代码必须与预订时提供的信用卡的账单国家/地区一致。这是由于 Vrbo 要求根据住客所在地(由账单地址国家/地区代码确定)对旅客服务费收取增值税。
- 如果不一致,由于增值税征收要求不同,可能会导致预订错误。
- 客人输入付款账单地址后,您必须验证国家/地区代码是否与购物期间传递给 Rapid 的国家/地区代码一致。如果值不同,提交预订将导致错误。要获得有效的预订价格,您必须使用 guest-provided 账单地址再次提出购物请求。在提交预订请求之前,应告知客人价格变动情况(上涨或下跌)。
与其他住宿选择的主要区别
Vrbo-specific 字段
| 费用 | 说明 |
|---|---|
property_fee | 描述预订的住宿费用总额,包括清洁费、管理费、加人费和其他费用。 |
traveler_service_fee | 由 Vrbo 收取的服务费,旨在方便预订并提供支持。一旦预订的任意部分不可退款,则此费用将不可退款。请查看上线要求了解有关展示的详细信息。 旅行者服务费和快速购物 API 国家/地区选择: 当 Vrbo 在定价响应中包含旅行者服务费时,金额将包含与快速购物 API 请求中使用的国家/地区对应的增值税。为了成功预订,您必须确保商店中请求的国家/地区与要在 check-out 上使用的付款国家/地区一致。 |
与 Vrbo 房源无关的字段
| 字段 | 说明 |
|---|---|
| 客房 ID | 客房名称和房价 ID 不适用于 Vrbo 库存,不应显示。 |
| 房态 | 对于 Vrbo 住宿,始终为 0。请不要使用此字段来表示紧急情况。 |
| 床组 | 不适用于 Vrbo,因为没有可用的选择/偏好。 |
| 促销 ID 和说明 | 不适用于 Vrbo 库存。 |
购物常见问题解答
**问:**Vrbo 住宿的排序依据是什么?
**答:**如果有住客评分得分/评分数量,可以根据这些进行排序。此外,属性 1073745445“高级合作伙伴”可帮助您识别由符合高级房东计划资格的房东管理的房源,您还可以使用该属性来影响房源排序。
**问:**为什么不允许 1 晚住宿?
**答:**由于 VrboCare 仅适用于 2 晚及以上的住宿,我们不建议您允许短时预订,以免给客人带来不良后果。
**问:**为什么不允许较短的预订期限(<72 小时)?
**答:**房东需要时间来处理预订申请、为住客的到来做准备并与住客沟通。为避免客人体验不佳或供应商取消订单,您需要限制 close-in 预订。
**问:**如何才能让住客搜索可带宠物的住宿?
**答:**Rapid 目前不提供按宠物规定筛选的功能,也无法提供含宠物费的房价。您可以根据内容属性识别 pet-friendly 房源,客人可以查看各个宠物政策。房东可以在 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 on Rapid 的价格是否与 Vrbo 和 Expedia Group 网站上的价格一致?
**答:**Rapid 上的 Vrbo 供应价格应与 Expedia Group 旗下品牌网站上显示的价格一致,但可能与 Vrbo 上显示的价格不同。这通常是根据服务费计算的,可能会略高或略低。此外,不同品牌的总住宿费用可能略有不同。
**问:**价格查询时,划线价格是否会像库存状态一样显示?
**答:**不。促销信息可在您致电咨询库存情况时获取,但不会在价格查询回复中提供。
预订和付款
需要了解
- 每次预订时,您必须提供房客的联系方式(姓名、电话和电子邮件),以便房东/房客进行沟通。
- 对于预订时需要州代码和邮政编码的国家/地区,Vrbo 有更严格的要求。请参阅下面的《高级集成指南》了解更多信息。
- 必须在付款页面上显示租房协议(如有相关内容)。请查看上线要求了解详细信息。
- 记账货币是针对 Vrbo 住宿预先定义的,因此应注意虚拟卡信用额度限制。您应该确保虚拟卡反映潜在的汇率差异和国际银行费用,以避免资金不足的入账错误。
- 请注意,目前 Rapid 上的 Vrbo 预订不支持 Expedia 联盟伙伴收款 (EAC)。
- 目前,不会将特殊要求转达给住宿。客人预订后应直接与房东讨论任何特殊住宿要求。
关键主题:付款
验证
- 所有 Vrbo on Rapid 预订均要求使用与账单地址相匹配的有效信用卡。
- 在某些地区,Vrbo 可能会收取 $0 或象征性金额以验证该卡。如果您要发送虚拟信用卡,则必须确保它们配置为接受多笔付款。
- 信用卡验证规则与其他 Rapid 预订不同。请参见附录 4 了解详情。
- Vrbo 定价通常包括由 Vrbo 收取的服务费。服务费的金额因住客所在地而异,因为法律要求对此费用收取增值税。因此,如果预订时提供的银行卡的账单地址与购物时提供的国家/地区不同,则会出现“无效国家/地区代码”的预订错误。您可以限制付款方式,仅允许使用 point-of-sale 中的卡进行支付,以确保不会发生这种不匹配的情况。
**笔记:**您必须在提交预订前发现此不匹配情况,以避免出现此预订错误。在这种情况下,您必须再次向酒店提出购物请求,以根据客人的账单国家/地区请求新的价格。
客户信用卡
- 应告知住客,以其他货币进行的预订可能需要支付国际交易费用,并且任何退款都可能会受到汇率的影响。
合作伙伴信用卡(虚拟卡)
- 您必须确保将以其他货币进行的预订所产生的任何国际交易费用考虑在内。
- 您不应分发提供付款计划(快速购物 API 存款)的房产。
- 合作伙伴卡必须配置为接受多笔付款,以允许任何所需的金额(0 美元或名义金额)pre-authorization.s
- 信用卡账单地址必须与销售点的账单货币一致。
- 合作伙伴卡配置必须允许以多种货币进行收费,或者您应该维护一组卡片以启用收费功能,同时减少银行手续费。
- 为了确保卡片可以扣款,您应该在发送图书请求前几秒钟激活虚拟信用卡 (VCC)。
- 请参阅下方的“高级集成”部分,了解有关带有付款计划的房产的更多信息。
关键主题:住宿损失
可退还押金(RDD)
- 房产所需的 RDD 显示在快速购物 API 中,代表预订时收取的押金。如果住客没有损坏 住宿的物品,则押金将在住客离店后的 2 周内退还。
- 必须使用 Rapid Shopping API 的排除参数,将包含 RDD 的属性作为购物请求的一部分予以抑制。
- 更多详情请参见下方的“高级集成”部分。
Card-on-file
- Card-on-file 表示,如果房客造成财产损失,Vrbo 有权在房客离开房产后,从提供的 信用卡中扣除 Rapid Shopping API 返回的金额。Vrbo 会在提出损坏索赔后向住客发送损坏摘要和发票。如果预订时提供的卡扣款失败,Vrbo 将与住客沟通,要求他们通过 Vrbo 网站提交付款。
- 应告知住客,如果在住客入住期间住宿物品损坏,住宿可能向其收取费用的金额。这将在
card_on_file_limit对象下返回选购响应。 - 可以使用 Rapid Shopping API 的排除参数来抑制 Card-on-file 属性作为商店请求的一部分。
关键主题:Vrbo 预订的货币代码
商店请求中指定的货币不会影响预订的结算货币。
- 无法为 Vrbo 预订指定货币。记账货币将始终与住宿的指定货币保持一致。否则,价格检查响应中返回的货币可能与快速购物 API 中返回的货币不同,并且是支付工具将要收取费用的结算货币。
- 如果您使用虚拟卡进行支付,则必须预留足够的缓冲资金以支付银行收取的国际汇兑费用。
- 应告知客人国际交易可能产生的银行手续费,并且由于汇率波动,取消预订的退款金额可能不等于初始付款金额。
与住宿的主要区别
Vrbo-specific 字段
| 字段 | 说明 |
|---|---|
| 邮政编码 | 要求与其他 Rapid 酒店库存不同。更多详情请参见附录 4。 |
与 Vrbo 房源无关的字段
| 功能 | 说明 |
|---|---|
| 保留/继续 | 目前不兼容 Vrbo on Rapid 预订。 |
| 特殊要求 | 目前无法向住宿提出特殊要求。住客应在预订后与住宿联系以提出特殊要求。 |
| 旅客处理说明 | 目前不支持 Vrbo 预订。 |
预订和付款常见问题
**问:**预订请求需要包含哪些住客信息?
**答:**所有 Vrbo on Rapid 预订都需要提供就住客的邮箱和电话号码,以便与房东进行沟通。
Post-booking 体验
需要了解
通过 Rapid API 完成 Vrbo 预订后,您应该向客人提供有关 post-booking 体验的指导。我们建议探讨以下主题。
需要完成的任务
- 主持人可以通过对话 API 向嘉宾发送消息(请参阅下面的示例主题)。
- 客人应该能够通过“行程”页面上的“对话 API”从预订信息向房东发送消息。
- Check-in 说明应在抵达前 72 小时通过基本住宿内容或通过对话 API 发送的房东消息提供。如果客人抵达后 48 小时内仍未收到,则必须立即联系房东或客服。
- 额外付款请求
- 即使 Rapid API 不支持对 Vrbo 预订进行硬性更改,也可以在 Rapid API 之外更改预订。在这种情况下,快速检索响应将仅包含总价格(不包括每晚或住宿价格)。此外,请注意,由于 Rapid API 生态系统的特性,对于 Vrbo 修改的预订,检索延迟将高于 non-modified 检索。
如何管理预订
- 客人可以通过您的网站,使用 Rapid Cancel API 取消预订。
- 住客可以请求房东进行更改,或者取消并重新预订(推荐)。
- 对于 Vrbo 房源的取消请求,如果在预订创建后 4 小时内提出取消请求,则会有特殊的考虑。请求可能会返回一个
HTTP代码,表示后端需要更多时间进行结算。在这种情况下,请稍等几分钟,然后重试取消(我们建议前 6 次尝试每 10 分钟尝试一次,之后每 30 分钟尝试一次)。如果在创建预订 5 小时后取消尝试仍然失败,请将 Rapid 日志发送给 Expedia Group 支持团队。
如果有问题
- 告知客人联系您的客户支持或 Expedia Group 客户直接支持 (CDS)。
- 建议住客在出现问题时立即联系支持人员,不要等到离店时才提出问题,因为 Vrbo 无法在退房后解决问题。
- 如果住客无法进入住宿,他们应首先尝试联系房东。如果失败,客人应立即与您联系以获得帮助。如果住客自行安排其他住宿,则相关费用将不予报销。
注意: 应向房客提供 Vrbo 确认号码 (HA-########),因为这是房东和 Vrbo 支持人员唯一可用的参考信息。
关键主题:Post-booking 支付
Vrbo 房东可能会在预订完成后或住客入住后要求额外付款。付款请 求可以通过 Vrbo 电子邮件发送给住客,其中包括付款页面的链接(无需登录)。住客应注意,未支付房东要求的任何额外费用可能会导致预订取消。房东要求的所有费用都包含在 Rapid 内容自由文本字段中,如 free_text 住宿描述、租房规定或租房协议。
额外付款请求的示例包括:
- 支付宠物押金
- 如向房东申请延长住宿时间,则需支付额外的住宿费用
- 支付 stay-collected 费用,例如用电费或毛巾使用费。
- 支付对住宿造成损坏的赔偿
请参阅附录 5,了解 stay-collected 费用的示例。
与其他住宿选择的主要区别
Vrbo-specific 字段
| 字段 | 说明 |
|---|---|
| 基本的住宿信息 | 这是 Vrbo 欢迎指南,应在预订创建后立即提供给客人。 >>查看 Vrbo 基本住宿内容了解更多详情 |
与 Vrbo 房源无关的字段
| 字段 | 说明 |
|---|---|
| 取消退款金额 | 不适用于 Vrbo on Rapid 预订。 |
| 软性变更 | Vrbo 预订不支持。住客应直接通过电子邮件或联系支持人员向房东请求更改。 |
| 硬性变更 | Vrbo 预订不支持。住客应直接通过电子邮件或联系支持人员向房东请求更改。 |
Post-booking 常见问题解答
**问:**我的住客将从 Vrbo 收到哪些电子邮件?
**答:**住客不会收到来自 Vrbo 的预订或取消确认邮件。您应该根据快速行程 API 提供这些确认信息。房客只会收到来自 Vrbo 的与追加付款请求相关的电子邮件。
**问:**可以通过 Rapid 取消 API 取消 Vrbo on Rapid 预订吗?
**答:**是的,所有 Vrbo on Rapid 预订都可以使用 Rapid 行程响应上的取消令牌取消。或 者,住客可以通过物业经理或支持客服请求取消。
**问:**Vrbo 在其网站上提供哪些预订后功能?
**答:**无法通过住客的 Vrbo 帐户访问在合作伙伴网站上进行的 Vrbo 预订。
**问:**如何更改 Vrbo 预订?
**答:**建议客人取消预订并重新预订,但客人可以通过与房东沟通或通过支持发起更改请求来请求更改 Vrbo 预订。
**问:**我会收到 Rapid 关于预订更改或取消的通知吗?
**答:**如果您已订阅快速通知服务,则在预订发生变更或取消时,您将收到通知。请注意,目前我们无法确定是谁更改了预订。
**问:**住宿消息中心可以支持与 Vrbo 房东对话吗?
**答:**不。Host-traveler 通信需要使用 Conversation API。
**问:**住客如何接收入住信息?
**答:**您有责任在客人抵达前 72 小时向其发送欢迎指南。此欢迎指南的内容来自 Rapid 行程 API 中的 Rapid 基本住宿内容。请注意,并非所有房东都能使用这一功能。相反,许多房东会通过对话 API 向客人发送欢迎指南消息。必须告知客人,如果在抵达后 48 小时内没有收到抵达说明,请联系您的客户支持部门,以便获得联系房东或寻找其他住宿的帮助。
**问:**Vrbo 预订确认后,住宿方可以取消吗?
**答:**是的,物业经理可以在住客预订后至到店前的任何时间取消 Vrbo 的订单。这通常会发生在创建订单后的一天之内,如物业经理意识到他们的住宿在该日期不可预订。如果这种情况发生在客人抵达之前,VrboCare 将协助客人寻找合适的替代住宿。请参阅 Vrbo on Rapid 支持指南了解更多信息。
**问:**房东会因取消预订而受到惩罚吗?
**答:**是。此外,物业经理取消预订的频率是决定优质房东资格的一个因素,并且会影响房源在搜索结果中的排名,因此物业经理除非必要,否则不会轻易取消预订。利用顶级房东身份将最佳房源展示在搜索结果的顶部,可以帮助您降低这种风险。
高级集成指南
高级方案:可退还的损坏押金(RDD)
部分 Vrbo 住宿要求在抵达前收取损坏押金,并在退房后根据住宿状况提供退款。由于 RDD 金额可能很高,而且您和您的客人都难以接受,我们强烈建议您从搜索结果中屏蔽这些房源。
关于 RDD
- 在假期等需求高峰期间,可能会有更多住宿要求支付 RDD。
- 大约 2% 的住宿需要在抵达前支付可退款的损坏押金。
- RDD 的金额和要求可能因地理位置和季节而异。
必须告知住客
- 损坏押金将在安排的最后一次付款时支付(或者,如果是一次性付款,则在预订时支付)。

- 损坏押金将根据房东的检查情况在退房后 14 天内退还。
- 如果发生损坏,Vrbo 将通过电子邮件向住客发送损坏费用发票。
- 付款时必须显示可退款的损坏押金的金额。
- 快速购物 API 中显示的 RDD 金额为预估值。Rapid 价格检查中的金额是向住客收取的金额,必须在付款时向住客显示。
合作伙伴作为记录商户
- 我们建议您在使用虚拟卡付款时排除 RDD,除非他们能够协助向客人收取和退还损坏押金。
- 您有责任向客人展示金额,并据此收取/退款。
示例:
"rates": [
{
"refundable_damage_deposit": {
"value": "150.00",
"currency": "USD"
}
}
]高级场景:客户信用卡
使用客户信用卡需要额外验证并与住客沟通。
地址验证
由于有些国家不需要邮政编码,而有些国家需要其他详细信息,因此 Vrbo 预订的地址验证要求与其他住宿选择不同。
邮政编码为 的国家/地区

没有邮政编码的国家

有关支持的国家/地区的列表,请参见附录 4。
高级场景:付款安排
Vrbo 住宿有时会根据预先定义的时间表收取付款。这些属性可以通过合作伙伴配置文件启用/禁用。如果存在付款计划,则付款计划将在 Rapid Shopping API 中显示为押金,与 Property Collect 一致。
关于押金(付款安排)
- 约 20% 到 30% 的住宿提供超过 3 个月的较长预订期限的付款安排。
- 不到 15% 的住宿提供 1 个月以内的较短预订期限的付款安排。
必须告知住客
付款计划详情应在 shop/check-out 期间显示,最好以可视化时间线视图的形式显示。
示例:
"deposits": [
{
"value": "412.10",
"due": "2027-05-17",
"currency": "USD"
},
{
"value": "236.17",
"due": "2027-08-24",
"currency": "USD"
}
]
此外,必须告知客人,他们有责任按照提供的时间表在 Vrbo 网站上付款,否则房东可能会取消预订。
Vrbo 将在付款到期日之前、当天和之后发送电子邮件提醒,以确保住客了解付款要求。
加上可退还的损坏押金
当需要 RDD 时,它将作为安排的最后一次付款的一部分收取。如果是一次性付款,则将在预订时收取。
与合作伙伴共同作为备案商户
由于 Vrbo.com 上的手动付款要求,我们不建议将有付款安排的住宿作为合作伙伴记录商户进行预订。
附录 1:房东沟通
您必须集成 Conversation API,以便房东和旅行者之间能够直接沟通。
物业经理通信的示 例包括:
- 欢迎消息及物业经理介绍
- 详细联系信息
- 政策和旅行须知
- 地址和路 线
- 钥匙箱密码
- 付款安排
- 租房协议(可能需要,否则物业经理可能会取消预订)
- 护照照片要求(可能需要,否则物业经理可能会取消预订)
- 房东回复消息
附录 2:Vrbo 沟通
将针对通过 Rapid API 进行的预订禁止发送以下 Vrbo 电子邮件:
- 预订确认
- 旅客取消的预订
- 住宿取消的预订
- 预订退款确认
- 欢迎指南
- 再营销
- 住客点评请求
- 支持体验点评请求
- 取消后客户重新定位
可能发送给住客的其他与 Vrbo 付款相关的电子邮件,包括支付额外的住宿费用(如宠物费)、变更费用(额外住宿)和损坏赔偿:
- 请求额外付款
- 付款确认
- 已收到付款
- 住宿损失报告
根据住客与 Vrbo.com 的互动情况发送额外的电子邮件
- 帐户创建
- 密码重置
- 密码重置确认
- 密码创建
特定于高级集成场景的 Vrbo 电子邮件模板:
- 防欺诈取消
- 损坏押金收取 - 仅适用于有 RDD 的住宿
- 损坏押金收据 - 仅适用于有 RDD 的住宿
- 损坏押金索赔 - 仅适用于有 RDD 的住宿
- 计划付款逾期 - 仅适用于有付款安排的住宿
附录 3:面向客户的品牌
| 销售网站 | 面向客户的品牌 |
|---|---|
| 法国 | Abritel |
| 德国 | Fewo-Direkt |
| 澳大利亚 | Stayz |
| 新西兰 | Bookabach |
| 其他 | Vrbo |
附录 4:地址验证
为了验证地址,以下国家/地区需要邮政编码。
- 阿根廷
- 澳大利亚
- 奥地利
- 巴西
- 加拿大
- 丹麦
- 法国
- 德国
- 英国
- 希腊
- 意大利
- 荷兰
- 挪威
- 波兰
- 葡萄牙
- 西班牙
- 瑞典
- 土耳其
附录 5:Stay-collected 费用示例
物业收取的部分费用可能包括:
- 管理费
- 空调
- 俱乐部
- 电
- 暖气
- 热水浴缸
- 网络
- 洗衣设施
- 床单
- 浴巾
- 停车场
- 泳池
- 住宿服务费
- 水