Vrbo on 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 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 选购中的 merchant_of_record
字段对于 Vrbo on 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 住宿无关的字段:
字段 | 说明 |
---|---|
客房 ID | 客房名称和房价 ID 不适用于 Vrbo 库存,不应显示。 |
房态 | 对于 Vrbo 住宿,始终为 0。请不要使用此字段来表示紧急情况。 |
床组 | 不适用于 Vrbo,因为没有可用的选择/偏好。 |
促销 ID 和说明 | 不适用于 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 on Rapid 的价格是否与 Vrbo 和 Expedia Group 网站上的价格一致?
**答:**Rapid 上的 Vrbo 供应价格应与 Expedia Group 旗下品牌网站上显示的价格一致,但可能与 Vrbo 上显示的价格不同。这通常是根据服务费计算的,可能会略高或略低。此外,不同品牌的总住宿费用可能略有不同。
预订和付款
须知事宜
- 合作伙伴必须在每次预订时提供住客详细联系信息(姓名、电话和邮箱),以便于房东与住客之间进行沟通。
- 对于预订时需要州代码和邮政编码的国家/地区,Vrbo 有更严格的要求。请参阅下面的《高级集成指南》了解更多信息。
- 必须在付款页面上显示租房协议(如有相关内容)。请查看上线要求了解详细信息。
- 通过 Rapid API 进行的 Vrbo 预订需要使用虚拟卡进行付款。希望发送客户信用卡的合作伙伴必须参阅《高级集成指南》。
- 记账货币是针对 Vrbo 住宿预先定义的,因此应注意虚拟卡信用额度限制。合作伙伴应确保虚拟卡能够反映潜在的汇率差异和国际银行收费,避免因资金不足导致的预订错误。
- 请注意,目前 Rapid 上的 Vrbo 预订不支持 Expedia 联盟伙伴收款 (EAC)。需要多次付款的住宿不符合成为合作伙伴记录商户的资格。请参阅《高级集成指南》,了解如何支持这些住宿。
- 目前,不会将特殊要求转达给住宿。住客应在预订后直接与房东讨论住宿方面的任何特殊要求。
关键主题:付款
验证
- 所有 Vrbo on Rapid 预订均要求使用与账单地址相匹配的有效信用卡。
- 在某些地区,Vrbo 可能会收取 $0 或象征性金额以验证该卡。发送虚拟信用卡的合作伙伴必须确保其配置为接受多次收费。
- 信用卡验证规则与其他 Rapid 预订不同。请参见附录 4 了解详情。
- Vrbo 定价通常包括由 Vrbo 收取的服务费。服务费的金额因住客所在地而异,因为法律要求对此费用收取增值税。因此,如果预订时提供的银行卡账单地址与选购时提供的国家/地区不同,则会出现“国家/地区代码无效”的预订错误。
- 合作伙伴必须在提交预订之前发现这种不一致的情况,以避免此类预订错误。在这种情况下,合作伙伴必须根据住客账单地址所在的国家/地区重新选购住宿以申请新的价格。
- 合作伙伴可能会限制从选购的销售网站向卡付款,以确保不会发生这种不匹配的情况。
客户信用卡
- 应告知住客,以其他货币进行的预订可能需要支付国际交易费用,并且任何退款都可能会受到汇率的影响。
合作伙伴信用卡(虚拟卡)
- 合作伙伴还必须确保他们考虑了以其他货币进行的预订所产生的任何国际交易费用。
- 合作伙伴不得分销提供付款安排(Rapid 选购押金)的住宿。
- 合作伙伴卡必须配置为接受多次收费,以允许任何所需的($0 或象征性金额)预验证。
- 合作伙伴卡账单地址必须与其销售网站的记账货币相匹配。
- 合作伙伴卡配置必须允许以多种货币收费,或者合作伙伴应保留一套卡以支持收费,同时减少银行收费。
- 合作伙伴应在发送预订申请前几秒钟激活 VCC,以确保该卡可扣款
- 请参阅下面的高级集成部分,了解有关提供了付款安排的住宿的更多信息
关键主题:住宿损失
可退款的损坏押金 (RDD):
- 住宿要求的 RDD 显示在 Rapid 选购中,代表在预订时收取的押金。如果住客没有损坏住宿的物品,则押金将在住客离店后的 2 周内退还。
- 必须使用 Rapid 选购的排除参数作为 Rapid 选购请求的一部分来排除有 RDD 的住宿。
- 有关更多详细信息,请参阅下面的高级集成部分。
留存卡:
- 留存卡表明,如果住客对住宿造成了损坏,Vrbo 有权在住客退房后从其提供的卡中扣款,扣款金额不超过在 Rapid 选购中退回的金额。Vrbo 会在提出损坏索赔后向住客发送损坏摘要和发票。如果预订时提供的卡扣款失败,Vrbo 将与住客沟通,要求他们通过 Vrbo 网站提交付款。
- 应告知住客,如果在住客入住期间住宿物品损坏,住宿可能向其收取费用的金额。这将在
card_on_file_limit
对象下返回选购响应。 - 可以使用 Rapid 选购的排除参数作为 Rapid 选购请求的一部分来排除留存卡的住宿。
关键主题:Vrbo 预订的货币代码
选购请求中指定的货币不会影响预订的记账货币。
- 无法为 Vrbo 预订指定货币。记账货币将始终与住宿的指定货币保持一致。否则,价格检查响应中返回的货币可能与 Rapid Shop 中返回的货币不同,并且是支付工具收费的计费货币。
- 使用虚拟卡付款的合作伙伴必须预留足够的资金,以支付合作伙伴银行收取的国际兑换费用。
- 应告知住客国际交易可能产生的银行手续费,并且由于汇率波动,因取消预订而获得的退款金额可能与初始付款的金额不相等。
与住宿的主要区别
Vrbo 特定字段:
字段 | 说明 |
---|---|
州/省/自治区/直辖市 | 要求与其他 Rapid 酒店库存不同。请参见以下内容,了解更多详细信息。 |
邮政编码 | 要求与其他 Rapid 酒店库存不同。请参见以下内容,了解更多详细信息。 |
与 Vrbo 住宿无关的字段:
功能 | 说明 |
---|---|
保留/继续 | 目前不兼容 Vrbo on Rapid 预订。 |
特殊要求 | 目前无法向住宿提出特殊要求。住客应在预订后与住宿联系以提出特殊要求。 |
旅客处理说明 | 目前不支持 Vrbo 预订。 |
预订和付款常见问题
**问:**预订请求需要包含哪些住客信息?
**答:**所有 Vrbo on Rapid 预订都需要提供就住客的邮箱和电话号码,以便与房东进行沟通。这一点很重要,因为房东可能会在住客预订后或到店前通过电子邮件提供住宿相关信息,包括协调住客到店后的接待工作或传达门禁密码。
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 分钟尝试 1 次,之后每 30 分钟尝试 1 次)。如果预订创建 5 小时后取消尝试仍然失败,请联系 EPS 支持团队并提供快速日志。
如果有问题
- 告知住客如何联系支持人员(合作伙伴、客户直接支持 (CDS) 或 Vrbo)。
- 建议住客在出现问题时立即联系支持人员,不要等到离店时才提出问题,因为 Vrbo 无法在退房后解决问题。
- 如果住客无法进入住宿,他们应首先尝试联系房东。如果不成功,住客应立即联系合作伙伴寻求支持。如果住客自行安排其他住宿,则相关费用将不予报销。
**注意:**Vrbo 确认代码 (HA-########) 应提供给住客,因为它是房东和 Vrbo 支持人员可用的唯一参考,并且在所有 Vrbo 电子邮件中都会提及。
关键主题:Post-booking 付款
Vrbo 房东可能会在预订完成后或住客入住后要求额外付款。付款请求可以通过 Vrbo 电子邮件发送给住客,其中包括付款页面的链接(无需登录)。住客应注意,未支付房东要求的任何额外费用可能会导致预订取消。房东要求的所有费用都包含在 Rapid 内容自由文本字段中,如 free_text 住宿描述、租房规定或租房协议。
额外付款请求的示例包括:
- 支付宠物押金
- 如向房东申请延长住宿时间,则需支付额外的住宿费用
- 支付住宿收取的费用,例如电费或毛巾使用费。
- 支付对住宿造成损坏的赔偿
请参阅附录 5 中 stay-collected 费用的示例
与其他住宿选择的主要区别
Vrbo 特定字段:
字段 | 说明 |
---|---|
基本的住宿信息 | 代表 Vrbo 欢迎指南,应在预订创建后立即提供给住客。请参阅 Vrbo 基本住宿内容了解更多信息。 |
与 Vrbo 住宿无关的字段:
字段 | 说明 |
---|---|
取消退款金额 | 不适用于 Vrbo on Rapid 预订。 |
对话令牌 | 不适用于 Vrbo on Rapid 预订。 |
软性变更 | Vrbo 预订不支持。住客应直接通过电子邮件或联系支持人员向房东请求更改。 |
硬性变更 | Vrbo 预订不支持。住客应直接通过电子邮件或联系支持人员向房东请求更改。 |
Post-booking 常见问题解答
**问:**我的住客将从 Vrbo 收到哪些电子邮件?
**答:**住客不会收到来自 Vrbo 的预订或取消确认邮件。合作伙伴可以根据 Rapid 行程 API 提供这些确认邮件。
**问:**我的住客将通过 Vrbo 收到哪些来自房东的电子邮件?
**答:**住客将使用创建预订时发送的住客邮箱地址接收来自房东的对话消息。对话消息可能包括对住客抵达和酒店体验至关重要的信息,也可作为住宿期间的沟通渠道。这些电子邮件可能由 Vrbo 提供,也可能直接来自房东。房东也可通过短信或 WhatsApp 等其他方式联系。
**问:**可以通过 Rapid 取消 API 取消 Vrbo on Rapid 预订吗?
**答:**是的,所有 Vrbo on Rapid 预订都可以使用 Rapid 行程响应上的取消令牌取消。或者,住客可以通过物业经理或支持客服请求取消。
**问:**Vrbo 在其网站上提供哪些预订后功能?
**答:**无法通过住客的 Vrbo 帐户访问在合作伙伴网站上进行的 Vrbo 预订。住客只能使用 Vrbo 收件箱,其中包括住客和房东之间的对话。
**问:**如何更改 Vrbo 预订?
**答:**建议住客取消并重新预订,但是住客可以通过与房东沟通或通过支持客服发起变更请求来请求变更 Vrbo 预订。
**问:**我会收到 Rapid 关于预订更改或取消的通知吗?
**答:**订阅快速通知的合作伙伴将在预订发生变更或取消时收到通知。请注意,我们目前无法确定是谁更改了预订。
**问:**住宿消息中心可以支持与 Vrbo 房东对话吗?
**答:**暂时不能。
**问:**住客如何接收入住信息?
**答:**合作伙伴负责在住客到达前 72 小时向住客发送欢迎指南。此欢迎指南的内容来自 Rapid 行程 API 中的 Rapid 基本住宿内容。请注意,并非所有房东都能使用这一功能。相反,许多房东会将欢迎指南作为对话电子邮件发送给住客。如果住客在到达前 48 小时内未收到到店说明,请务必联系合作伙伴支持客服,以便协助联系房东或找到其他住宿。请参阅 Rapid 基本住宿内容了解更多信息。
**问:**Vrbo 预订确认后,住宿方可以取消吗?
**答:**是的,物业经理可以在住客预订后至到店前的任何时间取消 Vrbo 的订单。这通常会发生在创建订单后的一天之内,如物业经理意识到他们的住宿在该日期不可预订。如果这种情况发生在客人抵达之前,VrboCare 将协助客人寻找合适的替代住宿。请参阅 Vrbo on 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 选购中,与 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 上的手动付款要求,我们不建议将有付款安排的住宿作为合作伙伴记录商户进行预订。
附录 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 费用示例
酒店收取的费用可能包括:
- 管理费
- 空调
- 俱乐部
- 电
- 暖气
- 热水浴缸
- 网络
- 洗衣设施
- 床单
- 浴巾
- 停车场
- 泳池
- 住宿服务费
- 水