住宿 API 上线要求
立即开始使用 Rapid Lodging API
快速住宿 API 的启动要求包括适用于任何实现的要求（无论受众如何），以及 business-to-business（B2B）或 business-to-consumer（B2C）使用的具体要求。请仔细阅读这些要求，因为它们可能与您之前整合的任何其他房价类型/预订流程的要求不同。
**注：**以下列出的每项要求都包含一个参考代码，以便我们的客户服务团队能够为您提供帮助。
要求
以下要求适用于任何住宿 API 实现。
GR1：使用我们的名称和标识
未经我们事先明确的书面批准，不得在 traveler-facing 或 agent-facing 网站上使用我们的名称和徽标。
用户界面示例
GR2：指向我们的条款和条件网址的链接（将显示）
在您的网站条款和条件文本中提供指向我们条款和条件的链接，或者直接从您的预订页面提供指向条款的链接。这些条款详细说明了管理预订的政策。将以下链接放置在 easy-to-find 位置，链接文字为“供应商条款和条件”。
您可以在此Rapid API 条款和条件页面获取我们支持的每种语言的条款和条件版本。
用户界面示例 - B2B
用户界面示例 - B2C
GR4：当 Expedia Group 为记录 (MOR) 的 Merchant 时，正确使用和展示信用卡法规
凡您获取、使用、传输、存储或处理旅行者持卡人数据的地方，您都必须遵守支付卡行业（PCI）安全标准委员会发布的支付卡行业（PCI）数据安全标准。有关这些法规的完整参考资料可在 PCI 安全标准委员会官方网站上找到。
GR5：使用属性收集或 Expedia Group 为 MOR 时，请提供 PCI 合规性证明（仅限适用合作伙伴）
无论 Expedia Group 是 MOR 还是该物业是 MOR，都必须提供合规性证明 (AOC) 作为 PCI 合规性的证据。
您可以在官方的PCI 安全标准委员会网站上找到有关 PCI 合规性的建议。
SP1：在允许预订中包含儿童的情况下，正确传达和输入儿童年龄信息。
如果您的集成允许儿童旅客，则必须提供在办理入住时指定每位儿童旅客年龄的功能。此信息通过 occupancy对象提供（见下方示例）。
当旅客指定儿童旅客时，API 响应可能包含年龄限制和/或额外入住费用或婴儿床费用，这可能会影响预订的成本或资格。
各个酒店会界定儿童的年龄范围。通常情况下，年龄不超过 17 岁的个人被视为儿童。某些住宿不接待未满 18 岁的住客。
示例 API 请求
https://api.ean.com/2.4/properties/availability?checkin=2020-09-11
&checkout=2020-09-14
¤cy=USD&language=en-US& occupancy=2-9,4 &property_id=XXXX
&country_code=XX&sales_channel=XXXX
&sales_environment=XXXX&filter=XXXX&rate_plan_count=XXXX
&rate_option=XXXX&billing_terms=XXXX&payment_terms=XXXX
&partner_point_of_sale=XXXX&platform_name=XXXXAPI 响应示例
"occupancies": {
"2-9,4" : {
"nightly": [
[用户界面示例： 1 间客房，2 位成人和 3 位儿童，年龄分别为 17 岁、2 岁和 1 岁以下。
AP1：每间客房均附有床型说明
购物响应可能返回包含单个值或多个选项的 bed_groups数组。显示配置数组中包含的值，以描述旅客的床位选择。
当 bed_groups数组返回多个选项时，显示购物响应提供的每种床型的 price_check链接，以便旅行者进行选择。
必须向旅客显示一条消息，指明选择同一客房中的多个床型仅为请求，如果房态不允许，酒店可能并不会满足这些请求。
房间名称以 room_name的形式返回在 Shopping 响应的 rooms 数组中。
API 响应示例
"property_id": "11775754",
"rooms": [
{
"id": "230434524",
"room_name": "Superior double room" ,
"rates": [
{
...
"bed_groups": {
"133243": {
"id": "133243",
"description": "Double bed" ,
"links": {...},
"configuration": [...]
},
"133242": {
"id": "133242",
"description": "2 single beds" ,
"links": {...},
"configuration": [...]
}
},用户界面示例 - B2B
用户界面示例 - B2C
AP2：Non-refundable 标志清晰可见
Non-refundable 的可用性由 refundable=false在 购物 API 可用性响应中指示。当可用性响应中返回 refundable=false时，请明确标记适用的房间。该值的优先级始终高于其他政策数据。在任何情况下，住宿接待方均不退还这些预订的费用。
API 响应示例
"property_id": "XXXX",
"rooms":
"id": "XXXX",
"room_name": "Fairmont King",
"rates":
"id": "XXXX",
"status": "available",
"available_rooms": 4999,
"refundable": false ,
"deposit_required": false,
"merchant_of_record": "expedia",用户界面示例 - B2B
用户界面示例 - B2C
AP3：Check-in 和特殊说明
必须显示 checkin、checkout、fees 和 policies对象的内容，这些内容在 内容 API 属性定义中返回。此信息必须显示在您的可用性页面上，以确保旅客了解办理入住时可能产生的任何费用或特殊访问说明。
特殊字段 check-in 可能包含对 check-in 至关重要但未包含在其中的信息。checkin对象的说明字段，例如要求通知物业预计到达时间，check-in 在与客人建筑不同的位置，或者提醒预期会通过电子邮件收到物业的特殊 check-in 说明。
确保在同一区域内向旅客显示 instructions 和 special_instructions。
API 响应示例
"11775754": {
"property_id": "11775754",
"checkin": {
"begin_time": "16:00 PM",
"end_time": "4:00 AM",
"instructions": "Minimum age to check in is 18 years old.
<br />Extra-person charges may apply and vary depending on property policy.
<br />Government-issued photo identification and a credit card may be required at
check- in for incidental charges.
<br />Special requests are subject to availability upon check-in and
may incur additional charges. Special requests cannot be guaranteed. <ul>. ",
"special_instructions": "Front desk staff will greet guests on arrival. For more details,
please contact the property using the information on the booking confirmation.",
"min_age": 18
"checkout": {
"time": "11:00 AM"
"fees": {
"mandatory": "<p>You'll be asked to pay the following charges at the property:</p>
<ul><li>Deposit: USD 50 per day</li>
<li>Resort fee: USD 28.25 per accommodation,
per night</li></ul> The resort fee includes:<ul
><li>Pool access</li><li>Fitness center access</li><li>Fitness/yoga classes</li>
<li>Airport shuttle</li><li>Phone calls</li><li>In-room safe</li><li>Self parking</li>
<li>Valet parking</li><li>Parking</li></ul> <p>We have included all charges provided to us by the property.
However, charges can vary, for example, based on length of stay or the room you book. </p>",
"optional": "<p>The following fees and deposits are charged by the property at time of service,
check-in, or check-out. </p> <ul> <li>Breakfast fee: between USD 6 and USD 25 per person
(approximately)</li> <li>Late check-out is available for a fee (subject to availability)</li>
<li>Rollaway bed fee: USD 20.0 per night</li>
</ul> <p>The above list may not be comprehensive. Fees and deposits may not include tax
and are subject to change. </p>"
"policies": {
"know_before_you_go": "<ul> <li>Up to 2 children 12 years old and younger stay free when
occupying the parent or guardian's room, using existing bedding. </li>
<li>The property has connecting/adjoining rooms, which are subject to availability
and can be requested by contacting the property using the number on the booking
confirmation. </li> </ul>"用户界面示例
BP1：个人数据采用 SSL 加密
发送或传输个人数据时，您必须使用 SSL 加密来保护客户端浏览器/App 与您的站点之间的连接，以及与相关系统的网络通信。个人数据包括住客姓名、电话号码或电子邮件、付款卡详细信息以及预订/行程收据和确认页面。当连接不安全时停止或重定向连接。
BP2：Check-in 和特殊说明
内容checkin，checkout，fees，和policies必须按返回的顺序，在每个房间中显示物品。内容属性定义。必须显示此信息，以确保旅客在最终预订之前了解 check-in 的任何潜在费用或特殊访问说明。
特殊字段 check-in 可能包含对 check-in 至关重要但未包含在其中的信息。checkin对象的说明字 段，例如要求通知物业预计到达时间，check-in 在与客房不同的位置，或者提醒预期会通过电子邮件收到物业的特殊 check-in 说明。
确保在同一区域内向旅客显示 instructions 和 special_instructions。
BP3：取消政策和 non-refundable 标签清晰显示
在允许旅客在最终预订页面确认购买之前，您必须提供所选房间的取消政策或 non-refundable 标签。每种价格的取消政策均在条款中列明。cancel_penalties Rapid Shopping Availability API 中的对象。
对于可退款价格，响应中包含一系列取消政策详情。详情包括：指定手续费的开始日期和结束日期、手续费类型和金额，及任何适用的例外预订日期。手续费类型包括：固定金额手续费、按住宿晚数计算的手续费以及按总费用百分比计算的手续费。
| 响应 | 含义 |
|---|---|
refundable=true | 此价格可全额退款。 |
refundable=true + cancel_penalties | • 此价格可在取消期限内退款。 • 最早 cancel_penalties.[].start如果是未来的某个时间点，则为免费取消截止日期。• 最新数据显示，比率为 100% non-refundable cancel_penalties.[].end |
refundable=false | • 该利率为 non-refundable。 • 没有返回取消手续费适用期限。 |
refundable=false + cancel_penalties | • 该费用可部分退款。 • cancel_penalties应与……一起展示nonrefundable_date_ranges预订创建后，将显示此范围内的入住日期为 non-refundable。 |
了解更多如何制定取消政策。
参考：
refundable=false
- 一旦创建预订，将立即生成不可退款的金额。
cancel_penalties和nonrefundable_date_ranges将提供更多详细信息。
nonrefundable_date_ranges
- 一旦创建预订，此范围内的住宿日期不可退款。
cancel_penalties
- 适用于
nonrefundable_date_ranges中未涉及的入住日期。 - 当
cancel_penalties为空或未返回时，价格为 100% 不可退款。 - 在
cancel_penalties时间范围内取消将产生手续费。 - 最早
cancel_penalties.[].start如果是未来的某个时间点，则为免费取消截止日期。 - 最新数据显示，利率为 100% non-refundable
cancel_penalties.[].end。
API 响应示例：取消政策和 non-refundable 标志
"property_id": "11775754",
"rooms": [
{
"id": "230434524",
"room_name": "Traditional Room (Partner:Connect Test)",
"rates":
"id": "276321199",
"status": "available",
"available_rooms": 4999,
"refundable": true,
"cancel_penalties": [
{
"start": "2020-09-10T18:00:00.000-07:00",
"end": "2020-09-11T18:00:00.000-07:00",
"amount": "76.00",
"currency": "USD"用户界面示例
BP4：价格明细中显示的物业另行收取的费用
当收费在费用数组内返回时，将每个数值单独显示为住宿的应收费用（入住或退房）。向旅行者出示当地货币并索要兑换金额。这些费用由物业直接收取（不是由我们或地方政府收取），并且不属于税费项下的标准税收回收费用、税款或收费。
API 响应示例：费用数组
"fees" : {
"resort_fee": {
"request_currency": {
"value": "74.97",
"currency": "USD"
},
"billable_currency": {
"value": "74.97",
"currency": "USD"
},
"scope": "per_accommodation",
"frequency": "per_night"
}
},用户界面示例
BP5：价格显示必须包含总价以及税费明细。
A) 总价
必须在付款页面上向旅客显示预订总价。总价应与 API 响应相符，不允许四舍五入或换算货币。最终明细必须包括房间价格（总计或每晚）、任何额外的每晚费用（除以下property_fee字段中描述的费用外）、所有住宿费用和税费、应收费总额，并列明现在支付的费用和稍后在酒店支付的费用。
**注意：**对于B2B或B2C套餐费率和公开套餐费率的实施，有额外的价格显示要求。
B) 税款明细
价格显示必须包含tax_and_service_fee和property_fee的总和， 作为标题为“税费”的一行。根据法律规定，在价格明细中提及任何税费总额时，必须显示以下原文。这可以显示为 pop-up、纯文本、模态框或其他实现方式。房产费用不应在结账页面单独显示。
_“这些税款是支付给供应商（e.g. 酒店）的税收回收费用；详情请参阅我们的使用条款。服务费是为您提供预订服务的补偿，其中可能包括供应商收取的费用。_翻译内容可在 Expedia 合作伙伴解决方案中找到。
tax_and_service_fee返回的值仅包含税务管辖区规定的税费。
C) 合作伙伴服务费用和预订费用
如果 Expedia Group 允许支付额外的服务费或预订费，则必须明确区分。如果您的组织收取服务费并添加到预订中，则必须向旅行者明确说明该费用是由您收取的，而不是由 Expedia Group 收取的单独服务费（即，不是为提供住宿而额外收取的费用）。费用可能不会包含在现有的税费项目中。请勿使用“费用”一词来描述您的物业收取的任何费用。或者，您可以使用“联盟预订费”或“联盟服务费”。
**注意：**对于B2B或B2C属性收集和公开套餐费率的实施，有额外的要求。
BP7：重申儿童年龄（如适用）
如果您的集成允许儿童旅客和旅客在选择房间时指定儿童旅客，则必须在预订页面上明确确认儿童旅客的人数及其年龄。此信息通过 child_ages对象提供。
用户界面示例
BP8：向最终旅行者收取款项的声明（对于到付或当 Expedia Group 为 MOR 时）
如果 Expeda Group 是 MOR，请说明提供的信用卡将立即收取预订的全额费用。
如为住宿收款，则说明住宿接待方将在入住或退房时向旅客提供的信用卡收取费用。如果酒店按 non-refundable post-pay 价格收费，则应说明酒店可能会在旅客完成预订后不久向其 收费。
BP9：符合 SCA 法规
监管机构和卡组织正在推出新的要求，以加强在线支付的安全性，保护消费者免受欺诈。这些法规中有很多都要求对在线支付使用强客户认证 (SCA)。
BP10：当 Expedia Group 为 MOR 时，check-out 页面上显示的支付处理地点
如果 Expedia Group 是 MOR，则付款处理所在国家/地区必须在 check-out 页面上的显眼位置显示。在国家名称之前必须插入短语“此付款将在”进行处理。
使用选购 API 的付款方式功能可以检索此信息。
支付选项的示例 API 请求
https://api.ean.com/<payment-options link from previous availability request>
API 响应示例
"credit_card": {
"name": "Credit Card",
"card_options": [
"name": "MasterCard",
"processing_country": "US"
"name": "Visa",
"processing_country": "US"用户界面示例
B2B 实施细节
您可以找到一份清单来帮助您进行开发或提供有关需求的反馈。 如果您为网站审核提供了屏幕截图，您还应该将屏幕截图和相应的日志添加到检查清单中，以帮助我们完成审核。
GR3：下游代理商必须同意我们的代理商条款和条件才能访问我们的库存。
代表旅客进行预订的代理商必须同意我们的下游代理商协议。应向下游代理提供链接协议，供代理在预订前查看和接受。还有其他版本可供选择Expedia 合作伙伴解决方案。
用户界面示例
附加套餐价格要求
除了上述常见要求外，如果您在实施方案中包含套餐费率要素，则还必须满足以下要求。
AP4：使用唯一标签或标识符显示包裹价格
您必须明确标明 Expedia Group 套餐价格为房间级别的套餐价格（而非单独项目）。
用户界面示例
BP5：价格显示必须包含总价以及税费明细。
套餐价格的总价要求与上述一般要求不同。
A) 总价
套餐价格必须与交通部分的价格组合显示为总套餐价格。这通常是通过显示房产加上交通费用的 per-person 成本来实现的。
必须在付款页面上向旅客显示预订总价。总价应与 API 响应相符，不允许四舍五入或换算货币。
用户界面示例
BP11：要求代理商接受套餐价格规则
在您的付款页面上提供一个复选框，供代理确认他们将此房价与批准的交通部分一起销售。
用户界面示例
其他财产收集要求
除了上面列出的常见要求外，如果您在实施过程中加入了财产收集功能，则还必须满足以下要求。
B2C 实施细节
我们创建了一个检查清单，以帮助您进行开发或提供有关需求的反馈。如果您为网站审核提供了屏幕截图，您还应该将屏幕截图和相应的日志添加到检查清单中，以帮助我们完成审核。
GR10：提供适当的 member-only 交易访问权限
Member-only 交易只能在 closed-user 环境中销售（例如，通过登录网站、移动应用程序或代理工具）。
用户界面示例
附加套餐费率要求
除了上述常见要求外，如果您在实施方案中包含套餐费率要素，则还必须满足以下要求。
BP5：套餐价格显示必须包含总价以及税费明细。
套餐价格的总价要求与上述一般要求不同。
A) 总价
套餐价格必须与交通部分的价格组合显示为总套餐价格。这通常是通过显示房产加上交通费用的 per-person 成本来实现的。
必须在付款页面上向旅客显示预订总价。总价应与 API 响应相符，不允许四舍五入或换算货币。
用户界面示例
额外的公开包装费率要求
除了上述常见要求外，如果您在实施过程中包含公开的包费率元素，则还必须满足以下要求。
其他财产收集要求
除了上述常见要求外，如果您在实施过程中包含公开的包费率元素，则还必须满足以下要求。