Vrbo 上线要求
合作伙伴必须遵循上线要求,通过 Rapid API 集成 Vrbo 住宿。
概述
合作伙伴必须遵循这些上线要求,通过 Rapid API 集成 Vrbo 住宿。访问此处可下载要求清单。
同时必须遵守必要的入住流程,具体可访问此处获取。
Vrbo 和其他品牌的徽标可在此处下载。
注意:使用下面的箭头展开每个上线要求,查看更多详细信息。
搜索页面
搜索页面 1:限制住宿天数小于等于 2 晚的搜索
对于 Vrbo 房东来说,较短的预订期限可能具有挑战性,并会导致较高的取消率。此外,Vrbo 的放心订保障不会为 1 晚住宿提供挪房支持。合作伙伴必须限制 1 晚住宿对 Rapid 选购的调用。
搜索页面 2:将搜索限制为到达时间距离搜索时间大于等于 72 小时
Vrbo 房东通常需要额外的通知以便在住客抵达前做好准备,因此更有可能取消住客在抵达前 72 小时内进行的预订。这一限制有助于减少提供商取消和挪房的情况。合作伙伴必须限制 72 小时内的住宿对 Rapid 选购的调用。
搜索页面 3:限制需要可退款的损坏押金的住宿
适用于:向客户发送卡且不包含有可退款的损坏押金的住宿的合作伙伴。对于要求预付可退款的损坏押金的住宿,必须限制其展示和预订,因为这笔费用的金额通常很高,与合作伙伴记录商户不兼容,而且退款困难。
exclusion=refundable_damage_deposit
展示页面
展示页面 1:在展示内容旁显示 Vrbo(或本地对应品牌)徽标或文本名称(仅适用于欧盟/英国)
仅适用于欧盟/英国销售网站
Vrbo 住宿将仅在 Vrbo 个人资料上显示,您需要在内容 API 调用中发送 supply_source=VRBO
以识别 Vrbo 住宿。
API 示例:
对象 | 格式 | 说明 |
---|---|---|
supply_source | 字符串 | 住宿的供应源。 |
展示页面 2:在搜索结果中显示住宿管理类型(仅适用于欧盟/英国)
仅适用于欧盟/英国销售网站
当住宿由私人房东打理时,根据销售网站显示正确的消息。
- 欧盟/英国 POSa -“Private host”
- 法国 POSa -“Annonce d'un particulier”
- 其他 POSa - 不需要
API 示例:
"vacation_rental_details": {
"private_host": true,
"property_manager":
"name":
}
对象 | 格式 | 说明 |
---|---|---|
private_host | 布尔型 | 表明住宿是否由私人房东打理。 |
住宿详细信息页面/房态页面
房态页面 1:显示 Vrbo(或本地对应品牌)徽标或文本名称(仅适用于欧盟/英国)
仅适用于欧盟/英国销售网站
API 示例:
对象 | 格式 | 说明 |
---|---|---|
supply_source | 字符串 | 住宿的供应源。 |
房态页面 2:在住宿详细信息页面上显示住宿管理类型(仅适用于欧盟/英国)
仅适用于欧盟/英国销售网站
私人房东住宿
当表明一个住宿由私人房东打理时,根据销售网站显示正确的消息。
- 欧盟/英国 POSa:“This property is managed by a private host. Private hosts do not rent properties as a trade, business, or profession. EU/UK consumer law relating to professional hosts may not apply, however the Book with Confidence Guarantee and the cancellation policy set by the private host will cover your booking.”
- 法国 POSa:“Cette propriété est celle d'un particulier. La fourniture de logements n’est pas liée à son commerce, entreprise ou profession. Le droit de la consommation de l'Union Européenne peut ne pas s'appliquer, toutefois la Garantie Réservation en tout Confiance et les conditions d'annulation définies par l'hôte particulier couvriront votre réservation."
上述粗体文本为可选项。如果合作伙伴在付款时提供指向 Vrbo 放心预订保证的链接,他们可能会在住宿详细信息页面上提供此处的一个引用。
专业房东住宿
当表明一个住宿由专业房东管理时,根据销售网站显示正确的消息。
- 欧盟/英国 POSa:“Information about cancellation rights. If you cancel your booking, you'll be subject to the host's cancellation policy. In accordance with EU/UK regulations about consumer rights, property booking services are not subject to the right of withdrawal.”
- 法国 POSa:“Informations sur le droit de rétractation. Informations sur le droit de rétractation - Bien que les vacanciers réservant auprès d’un consommateur ou d’un non professionnel ne disposent pas du droit de rétractation, au sens de l’article L. 221-18 du Code de la consommation, ils peuvent bénéficier de la politique d’annulation du propriétaire. Les vacanciers et propriétaires sont soumis au droit des obligations et de responsabilité civile applicables à la relation contractuelle, prévues aux articles 1100 à 1386-1 du code civil.”
如何识别住宿管理类型
"vacation_rental_details": {
"private_host": true,
"property_manager":
"name":
}
对象 | 格式 | 说明 |
---|---|---|
private_host | 布尔型 | 表明住宿是否由私人房东打理。 |
房态页面 3:显示自由文本住宿介绍
房东通常会详细描述住宿、服务设施和周边地区。确保在 API 返回时显示自由文本介绍。
示例:
"free_text": "City ID#1837<br><br>If you want ELEGANCE, the Dream Home is for YOU! YOU will create MEMORIES that will last a LIFETIME and experience the history of Palm Springs, all in this 800 sq. ft STUNNING home with clerestory windows, exposed-beam ceilings, the latest home TECHNOLOGY, a large kitchenette, granite counters, full walk-in shower, and a PRIVATE POOL & SPA! This home is UNBELIEVABLY GORGEOUS, with a privacy fence, gated parking, a barbecue area, BREATHTAKING MOUNTAIN VIEWS! You simply DESERVE IT! You will be AMAZED at this home so close to downtown! You will never want to leave this stunning piece of Palm Springs!<br><br>You will also have your very own remote control gate to park your car next to your home behind a self-closing gate. You are welcome to invite friends over for a small party or cookout on your grill. All the kitchen utensils are provided. You just bring the food and start grilling!<br><br>The home is FULL of TECHNOLOGY from Alexa, to a Nest thermostat and even control the temperature of the spa directly from a wireless tablet in the home!<br><br>The home has amazing ambiance overlooking a heated pool and spa.<br><br>The home has a queen bed with a memory foam mattress and bamboo pillows. It also has a couch in the same room that could be used for a child or an adult. The home is full of beautiful MODERN furniture to give you the true Palm Springs Experience. The Dream Home is completely surrounded by a privacy fence which gives you complete privacy during stay! <br><br>**Pool heating is charged during the months of November - December - January - February - March - April and May 15 (see ADDITIONAL RULES for details). Payment request is sent at least 2 weeks in advance.<br><br>POOL HEAT FEES <br>There is a $50 per day pool charge for the following months;<br>(Aug 15 - November - December - January - February - March-April-May 15) to 80 degrees the following fee will be applied;<br>* Pool Heat Charges tracked by Pentair Software program during your stay.<br>* Pool heat invoice charges will be emailed the week before check-in.<br>* Payment must be made before check-in."
},
房态页面 4:显示价格明细的所有元素
每当列出房价详细信息明细时,都会显示旅客服务费和房东费用。
a) 旅客服务费
您必须逐字显示示例文本:
所有欧盟/英国销售网站均要求使用“含增值税”字样。 在向住客显示时必须解释旅客服务费(可以采用鼠标悬停/点击旅客服务费名称的方式)。
示例:
旅客服务费说明:旅客服务费(含增值税):33.32 欧元
合作伙伴可以在说明中使用“traveler service fee”或仅“service fee”字样。
- “[品牌] 对使用其平台上提供的在线工具、服务和功能收取服务费,使住客能够与展示住宿的房东互动。”
您可在本页面底部找到 Vrbo 品牌对照列表。
b) 房东费用
每当根据 Rapid 选购定价明细中的 property_fee 列出价格明细时,都会显示房东费用。
(可选)包括鼠标悬停说明,例如,“房东费用包括:清洁费、加人费、管理费和其他费用。”
示例:
房东费用:$4.00
"occupancy_pricing": {
"2": {
"nightly": [
[
{
"type": "tax_and_service_fee",
"value": "13.64",
"currency": "USD"
},
{
"type": "property_fee",
"value": "4.00",
"currency": "USD"
},
{
"type": "traveler_service_fee",
"value": "13.20",
"currency": "USD"
},
{
"type": "base_rate",
"value": "99.00",
"currency": "USD"
}
],
房态页面 5:显示优化的租房规定
优化的租房规定的完整内容必须包含在住宿详细信息页面上(例如禁止举办派对、吸烟规定)。显示从 API 返回的 additional_information
对象的完整内容。
租房规定可确保旅客在完成预订前了解房东的所有要求。该对象中返回的值特定于 Vrbo 住宿,并且比 API 内容文件中返回的值更重要。
UI 示例:
API 示例:
"enhanced_house_rules":
"Children": {
"rule": "Children allowed",
"additional_information": [
"Children allowed ages 13-17",
"Three children are possible if one is in a cot",
]
},
"Pets": {
"rule": "Pets allowed",
"additional_information": [
"Pets must be no larger than 1lbs.",
]
}
房态页面 6:显示住宿登记号。
可以在 Rapid 内容响应中找到住宿登记号。
只要内容中出现价值,就应在合作伙伴的 PDP 网站上显示。
UI 示例:
许可证号:RHL-0000954
API 示例:
"vacation_rental_details": {
"registry_number": "RHL-0000954",
"private_host": true
}
房态页面 7:显示单元配置
包含卧室和浴室的数量。客房面积详细信息为选填内容。该信息可以在 statistics
数组中找到。
UI 示例:
API 示例:
"statistics": {
"1073743380": {
"id": "1073743380",
"name": "Max occupancy - 5",
"value": "5"
},
"1073743378": {
"id": "1073743378",
"name": "Nunmber of bedrooms - 1",
"value": "1"
},
"1073743379": {
"id": "1073743379",
"name": "Number of bathrooms - 1",
"value": "1"
},
"52": {
"id": "52",
"name": "Total number of rooms - 1",
"value": "1"
},
"1073743538": {
"id": "1073743538",
"name": "Property floor area (square meters) - 75",
"value": "75"
},
"1073743537": {
"id": "1073743537",
"name": "Property floor area (square feet) - 807",
"value": "807"
}
房态页面 8:显示物业经理信息。
包括房东姓名。
可选:包括使用的语言和图像。
API 示例:
"vacation_rental_details": {
"registry_number": "Property Registration Number SCIA 19367",
"private_host": true,
"property_manager": {
"name": "Rent Home in Rome, It"
},
"spoken_languages": {
"de": {
"id": "de",
"name": "German"
},
"en": {
"id": "en",
"name": "English"
},
"nl": {
"id": "nl",
"name": "Dutch"
}
}
付款页面/预订页面
预订页面 1:显示留存卡限制的金额和说明。
- 这需要用 Rapid 房态 API 响应提供的数值填充(如果显示)。
- 示例文本:“如果您对住宿造成损坏或产生杂费,可能会从您的卡中收取不超过 $x 的费用。”
当您使用虚拟信用卡时,合作伙伴负责收取由住客造成的损失费用,这些费用将从合作伙伴的虚拟信用卡中扣除。
预订页面 2:显示相关的 Vrbo 条款和条件链接
在付款页面上包含住客 POSa 的相关条款和条件链接。可以在[此处]找到条款和条件链接。(https://www.vrbo.com/lp/b/terms-of-service)
预订页面 3:显示商户向客户卡收费的详细信息
当通过客户信用卡或合作伙伴虚拟卡付款时:
- “您选择的住宿是通过我们的合作伙伴 [品牌] 预订的,他们将向您发送一封电子邮件,内含重要信息,包括详细付款信息和创建帐户的链接,您可以通过该链接管理您的预订。”
当通过客户信用卡付款时:
在付款页面上包含以下豁免信息(或类似内容):
- “支付给房东的服务费和预订金额将在您的信用卡账单上显示为一笔款项(如果启用了软描述符,则为合作伙伴名称;如果没有,则为 Vrbo/Homeaway)。您的银行可能会根据处理付款的地点,收取外币交易费。”
高级:分销 IPM 供应产品的合作伙伴还必须告知住客 IPM 在向客户卡收费方面的作用:
- “这笔费用将在您的信用卡对帐单上显示为支付给 [IPM 名称] 的费用。”
您可在本页面底部找到 Vrbo 品牌对照列表。
预订页面 4:显示说明预订后流程的文本。
合作伙伴应让住客获得积极的体验,包括设定预订后的期望。住客应了解以下内容:
住客可能会收到 Vrbo 有关预订的通知,其中可能包括重要说明
合作伙伴、Vrbo 和/或房东将在住客抵达前 72 小时发送入住说明
如果住客在抵达前 48 小时未收到入住说明,请联系房东和/或合作伙伴支持人员
示例:
- “我们已与 [品牌] 合作,您应该会收到来自 [品牌] 和住宿房东的电子邮件。如果您对该住宿或入住有任何疑问,请回复这些电子邮件与房东沟通。如果您在抵达前 72 小时没有收到相关说明,请联系 [合作伙伴支持渠道]。如果房东没有回复,或者您在抵达前 48 小时内没有收到相关说明,或者您在入住时间内抵达了住宿场所但无法进入,请立即联系 [合作伙伴支持渠道],寻求房东帮助或挪房协助。”
您可在本页面底部找到 Vrbo 品牌对照列表。
预订页面 5:每当列出房价详细信息明细时,都会显示旅客服务费和房东费用。
a) 旅客服务费
您必须逐字显示示例文本:
- 所有欧盟/英国销售网站均要求使用“含增值税”字样。
- 在向住客显示时必须解释旅客服务费(可以采用鼠标悬停或点击旅客服务费名称的方式)。
示例:
- 旅客服务费说明:旅客服务费(含增值税):33.32 欧元。
合作伙伴可以在说明中使用“traveler service fee”或仅“service fee”字样。
- “[品牌] 对使用其平台上提供的在线工具、服务和功能收取服务费,使住客能够与展示住宿的房东互动。”
您可在本页面底部找到 Vrbo 品牌对照列表。
b) 房东费用
每当根据 Rapid 选购定价明细中的 property_fee 列出价格明细时,都会显示房东费用。
(可选)包括鼠标悬停说明,例如,“房东费用包括:清洁费、加人费、管理费和其他费用。”
示例:
房东费用:$4.00
"occupancy_pricing": {
"2": {
"nightly": [
[
{
"type": "tax_and_service_fee",
"value": "13.64",
"currency": "USD"
},
{
"type": "property_fee",
"value": "4.00",
"currency": "USD"
},
{
"type": "traveler_service_fee",
"value": "13.20",
"currency": "USD"
},
{
"type": "base_rate",
"value": "99.00",
"currency": "USD"
}
],
预订页面 6:显示住宿租房协议
可以在 Rapid 内容 API 响应(如果可用)中找到租房协议链接。
"vacation_rental_details": {
"rental_agreement": {
"links": {
"rental_agreement": {
"method": "GET",
"href": "<https://www.leisure-group.net/eris/pdf/hrvw-bvag-bv-en.pdf">
}
}
},
预订页面 7:显示完整的取消政策级别详细信息。
许多度假短租住宿都提供多个可退款级别。强烈建议采用图形显示方法,以清楚地显示选购、当前日期和住客到店对应的不同退款政策。
明确告知住客,仅当预订为 100% 可退款时服务费才可退款。这必须在取消政策说明和/或预订条款部分中显示。一旦预订处于部分或全部不可退款时期,服务费将不可退款。
示例说明:
“仅当您的整个预订可全额退款时,服务费才可退款。”
UI 示例:
条款示例:
预订页面 8:将 Expedia Group 显示为交易商(仅限欧盟/英国销售网站)
此文本需要在付款页面和预订后通信中向 Vrbo 库存的交易商显示。
Expedia Group Vacation Rental (Ireland) Ltd
25 St. Stephen's Green, 4th floor, Dublin 2, D02 XF99, Ireland
+353 15621133
support@chat.travelnow.com
预订页面 9:显示交易商信息、条款和条件以及联系信息(仅限欧盟/英国销售网站)
当 API 提供 trader_information
、terms_and_conditions
和 contact_message
字段时,需要在付款页面和预订后通信中提供这些信息。
API 示例:
"trader_information": {
"traders": [
{
"name": "Expedia",
"address": {
"line_1": "555 1st St",
"line_2": "10th Floor",
"line_3": "Unit 12",
"city": "Seattle",
"state_province_code": "WA",
"postal_code": "98121",
"country_code": "US"
},
"email": "travel@support.expedia.com",
"phone": "0330-123-1235",
"contact_message": "This property is managed by a professional host. The provision of housing is linked to trade, business, or profession."
}
],
"terms_and_conditions": "https://www.expedia.com/terms_and_conditions"
}
预订后要求
预订后 1:基本住宿信息
生成一封预订后电子邮件,其中包含 API 返回的所有基本住宿信息,以及合作伙伴、Expedia 和提供商确认代码。
有一些与度假短租住宿相关的关键信息,可能不会很醒目地显示在住宿内容中。
例如:
- 泳池清洁人员每周二下午 2 点至 4 点来住宿,并可进入院子。
- 要使用壁炉,您必须从后门外的储物箱中取用木材。
- 使用桑拿浴室/热水浴缸需支付每小时 10 美元的额外费用。
- 恒温器不得设置在 72F 以上。
您可以在此处查看更多详细信息
预订后 2:发送到达前电子邮件,其中包含基本住宿信息
Vrbo 度假短租房东必须在住客到达前至少 72 小时向住客提供与到达和住宿相关的信息。合作伙伴必须至少显示住宿地址和房东的联系信息。
房东可以选择提供这些信息的方式,可能会通过电子邮件或其他通信方式提供这些信息。Vrbo 建议房东在 Vrbo 系统中预先配置与住宿相关的常用信息,这些信息只有在预订后才能访问。因此,必须让住客知道,有些房东会通过电子邮件或电话与他们联系,提供与其住宿相关的重要信息。
合作伙伴必须在住客入住前至少 72 小时将 Rapid 基本住宿内容中包含的所有信息发送给住客。
合作伙伴必须明确告知住客如何获得预订支持。如果出现问题,应建议住客:
- 直接与作为第一线支持的房东进行讨论
- 立即联系合作伙伴以获取支持
示例:
- “入住期间,如果您对住宿有任何问题或疑虑,请在预订完成后使用提供的邮箱地址与房东联系,或回复房东的通信消息,先进行讨论。如果无法通过房东解决问题,请立即联系 [合作伙伴支持渠道] 请求帮助。如果未在发现问题后的 24 小时内提出请求,我们可能无法提供帮助。入住期间遇到的任何问题都必须在入住期间报告。”
合作伙伴应在预订管理页面上显示相同信息,以确保住客了解支持指南。
技术
技术 1:旅客服务费和账单国家/地区详细信息
用于支付预订费用的信用卡的账单国家/地区必须与选购请求中提供的 POSa 国家/地区代码一致。
Expedia Group 负责收取每个预订的旅客服务费 (TSF) 部分,所以需要客户的账单国家/地区信息来确定正确的价格。因此,如果选购请求中使用的国家/地区与账单地址中指明的国家/地区不同,预订将失败并显示“国家/地区代码无效”。
示例:country_code=US
用于选购请求,为美国住客提供价格信息(旅客服务费无增值税)。如果预订请求中提供的是英国发行的信用卡,那么我们需要收取 20% 的增值税。
技术 2:在每个预订请求中提供准确的旅客数据
需要提供住客联系信息,以便房东和住客在入住前和入住期间进行沟通,从而带来积极的住客体验。
预订请求必须包括:
- 住客姓名
- 住客电话
- 住客邮箱
技术 3:度假短租错误处理建议
请确认您已查看我们的 Rapid 错误处理建议和度假短租特定错误处理建议(详见《Vrbo 集成指南》),并实施了相应的处理措施。
高级部分
**注意:**仅适用于使用高级集成选项的合作伙伴。关于其中任何一项是否适用于您的认证,您的集成团队将提供建议。
场景 1:可退款的损坏押金
高级 1.1:显示可退款损坏押金的金额和说明。
- 这需要用 Rapid 房态 API 响应提供的数值填充(如果显示)。
- 示例文本:“此住宿还需要支付“£X”的可退款损坏押金。”
- Vrbo 将在最后一次安排付款时收取可退款的损坏押金。如果没有付款安排,损坏押金将在第一次收费时收取。
此外,当通过合作伙伴虚拟信用卡付款时,合作伙伴负责向住客收取押金,并在入住后将剩余部分返还给住客。
场景 2:客户信用卡
高级 2.1 - 显示卡豁免信息
在付款页面上包含以下豁免信息(或类似内容):
“支付给房东的服务费和预订金额将在您的信用卡账单上显示为支付给 [品牌] 的款项。您的银行可能会根据处理付款的地点,收取外币交易费。”
高级 2.2:旅客服务费和账单国家/地区详细信息。
Expedia Group 负责收取每个预订的旅客服务费 (TSF) 部分,所以需要客户的账单国家/地区信息来确定正确的价格。因此,如果选购请求中使用的国家/地区与住客在账单地址中指明的国家/地区不同,预订将失败并显示“国家/地区代码无效”。
示例:country_code=US
用于选购请求,为美国住客提供价格信息(旅客服务费无增值税)。如果住客随后提供英国信用卡,Expedia Group 需要收取金额 20% 的增值税。如果英国住客要求按美国房价预订,预订将失败。
**解决办法:**如果住客在付款页面账单地址字段中指明的国家/地区与用于选购的国家/地区不同,合作伙伴应使用更新后的国家/地区代码重新选购该住宿以获得正确的价格。在发送预订请求之前,应向住客显示新价格以供确认。
开票信息
Vrbo 住宿需要准确的地址信息。如果住客的账单地址信息不匹配,可能会出现预订错误。
如果没有此信息,Vrbo 住宿的预订可能会失败,但当前在 Rapid 上可成功预订常规住宿(例如酒店)。
**A:**账单国家/地区 - 账单国家/地区必须与选购的国家/地区一致。
**B:**账单邮政编码 - 大多数国家/地区都需要邮政编码。也可提供其他信息。可以在 Vrbo 集成指南中找到更多详细信息。
**C:**账单州代码 - 美国销售网站需要州代码。
调用付款方式链接以获取可接受的卡类型。
Vrbo 住宿支持的信用卡种类少于常规住宿。调用付款方式链接以查看接受的卡类型,在付款页面上显示此信息。
**注意:**无法指定 Vrbo 库存记账货币,因为合作伙伴可能习惯于使用核心库存。相反,Rapid 选购将使用正确的预订记账货币进行响应。您应该告知住客国际交易可能会产生相应的银行费用。
场景 3:付款安排
高级 3.1:告知住客付款安排
当 Rapid 选购/价格检查 API 返回说明多次付款的订金政策时,向住客清楚地展示该政策并告知住客他们有责任在 Vrbo 网站上指定的到期日之前完成付款。Vrbo 和/或房东将提前一周发送提醒,如果未完成付款,预订可能会被取消。
在您的付款页面上添加以下语言:
“房东今天只收取部分款项。Vrbo 或房东将通过电子邮件向您发送详细信息,内含下次付款到期时的提醒。”
"deposits": [
{
"value": "412.10",
"due": "2023-05-17",
"currency": "USD"
},
{
"value": "236.17",
"due": "2023-08-24",
"currency": "USD"
}
]
其他参考信息
Vrbo 品牌对照表:
POSa 国家/地区 | Vrbo 品牌 |
---|---|
德国 | Fewo-direkt.de |
法国 | Abritel.fr |
澳大利亚 | Stayz.com.au |
新西兰 | Bookabach.co.nz |
世界其他地区 | Vrbo.com |