快速住宿 API：B2C 独立发布要求
如果您采用 business-to-consumer (B2C) 集成模型，旅行者直接与您的集成进行交互，则适用这些启动要求。
概述
这些要求分为两类：
独立要求： 这些是此预订流程特有的要求。请仔细阅读这些要求，因为它们可能与您之前整合的任何其他房价类型/预订流程的要求不同。
**通用要求：**这些是所有预订流程的通用要求。请务必满足适用于所有流程的所有通用要求。
**注：**以下列出的每项要求都包含一个参考代码，以便我们的客户服务团队能够为您提供帮助。
核对清单
我们创建了一个检查清单，以帮助您进行开发或提供有关需求的反馈。如果您打算提供截图用于网站审核，请在核对清单中添加截图和相应日志，这将帮助我们完成审核。
B2C 实施
通用要求
以下上线要求适用于所有预订流程。每个房价要求列表中提供了每种房价类型的特定附加要求，包括价格显示的详细说明。
GR1：禁止使用 Expedia Group 的名称和徽标
未经我们事先明确的书面批准，不得在 traveler-facing 或 agent-facing 网站上使用我们的名称和徽标。
示例：
GR2：显示我们的条款和条件网址
在您的网站条款和条件文本中提供指向我们条款和条件的链接，或者直接从您的预订页面提供指向条款的链接。这些条款详细说明了管理预订的政策。将以下链接放置在 easy-to-find 位置，链接文字为“供应商条款和条件”。
您可以从这里获取我们支持的每种语言版本的条款和条件。 Rapid API 条款和条件页面。
示例：
GR4：当 Expedia Group 为登记商户 (MoR) 时，正确使用和展示信用卡法规
无论何时，只要您获取、使用、传输、存储或处理旅行者的持卡人数据，您都应遵守支付卡行业数据安全标准（PCI DSS），该标准由支付卡行业安全标准委员会发布。这些规定的完整参考资料可在官方网站上查阅。 PCI 安全标准网站。
GR5：提供财产收集或 Expedia Group 为 MoR 时（如适用）的 PCI 合规性证明
如果 Expedia Group 或该属性为 MoR，则必须提供合规性证明 (AOC) 作为 PCI 合规性的证据。您可以在官方网站上找到有关 PCI 合规性的建议。 PCI 安全标准网站。
SP1：如果预订中包含儿童，则需正确显示儿童年龄信息并进行录入。
如果您的集成允许儿童旅客，则必须提供在 check-in 时指定每个儿童旅客年龄的功能。此信息通过 occupancy 元素提供（请参见下面的代码示例）。
当旅客指定儿童旅客时，API 响应可能包含年龄限制和/或额外入住费用或婴儿床费用，这可能会影响预订的成本或资格。
各个酒店会界定儿童的年龄范围。通常情况下，年龄 17 岁及以下的个人被视为儿童。某些住宿不接待未满 18 岁的住客。
API 请求示例：
https://api.ean.com/v3/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": [
[**用户界面示例：**一间房，住 2 位成人和 2 位儿童，儿童分别 9 岁和 4 岁。
AP1：显示每个房间的床型描述
购物 API 响应可能会返回bed_groups包含单个值或多个选项的数组。显示配置数组中包含的值，以描述旅行者的床位选择。
当bed_groups返回包含多个选项的数组，显示这些选项。price_check购物响应中提供了每种床型的链接，以便旅行者进行选择。
必须向旅客显示一条消息，指明选择同一客房中的多个床型仅为请求，如果房态不允许，酒店可能并不会满足这些请求。
房间名称会作为购物响应的 rooms 数组返回。room_name。
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": [...]
}
},用户界面示例：
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",用户界面示例：
AP3：显示 check-in 和特殊说明
必须显示每个房间中 checkin、checkout、fees 和 policies对象的内容，这些内容在 Content 属性定义中返回。此信息必须显示在您的可用性页面上，以确保旅行者了解 check-in 的任何潜在费用或特殊访问说明。
special_instructions字段可能包含对 check-in 至关重要的信息，而这些信息并未包含在 checkin对象的 instructions字段中，例如需要通知酒店预计到达时间、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.
Extra-person charges may apply and vary depending on property policy.
Government-issued photo identification and a credit card may be required at
check-in for incidental charges.
Special requests are subject to availability upon check-in and
may incur additional charges. Special requests cannot be guaranteed.",
"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": "You'll be asked to pay the following charges at the property:
Deposit: USD 50 per day
Resort fee: USD 28.25 per accommodation, per night The resort fee includes: Pool access, Fitness center access, Fitness/yoga classes, Airport shuttle, Phone calls, In-room safe, Self parking, Valet parking, Parking. 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.",
"optional": "The following fees and deposits are charged by the property at time of service,
check-in, or check-out. Breakfast fee: between USD 6 and USD 25 per person
(approximately), Late check-out is available for a fee (subject to availability)Rollaway bed fee: USD 20.0 per night.
The above list may not be comprehensive. Fees and deposits may not include tax and are subject to change."
"policies": {
"know_before_you_go": "Up to 2 children 12 years old and younger stay free when
occupying the parent or guardian's room, using existing bedding.
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."用户界面示例：
BP1：对个人数据使用 SSL 加密
发送或传输个人数据时，您必须使用 SSL 加密来保护客户端浏览器/App 与您的站点之间的连接，以及与相关系统的网络通信。个人数据包括住客姓名、电话号码或电子邮件、付款卡详细信息、预订/行程收据和确认页面。当连接不安全时停止或重定向连接。
BP2：显示 check-in 和特殊说明
必须为每个房间显示 checkin、checkout、fees 和 policies对象的内容，这些内容在 Content 属性定义中返回。必须显示此信息，以确保旅客在最终预订之前了解 check-in 的任何潜在费用或特殊访问说明。
special_instructions字段可能包含对 check-in 至关重要的信息，而这些信息并未包含在 checkin对象的 instructions字段中，例如需要通知酒店预计到达时间、check-in 位于与客房不同的位置，或者提醒酒店通过电子邮件发送特殊的 check-in 指示。
确保在同一区域内向旅客显示 instructions 和 special_instructions。
BP3：清晰显示取消政策和 non-refundable 标签
在允许旅客在最终预订页面确认购买之前，您必须提供所选房间的取消政策或 non-refundable 标签。Rapid Shopping Availability API 中的 cancel_penalties对象提供了每种价格的取消政策。
对于可退款价格，响应中包含一系列取消政策详情。详情包括：指定手续费的开始日期和结束日期、手续费类型和金额，及任何适用的例外预订日期。手续费类型包括：固定金额手续费、按住宿晚数计算的手续费以及按总费用百分比计算的手续费。
| 响应 | 含义 |
|---|---|
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预订创建后，将立即产生 non-refundable 金额。cancel_penalties 和 nonrefundable_date_ranges将提供更多详细信息。
nonrefundable_date_ranges：一旦创建预订，此范围内的入住日期将为 non-refundable。
cancel_penalties：
- 适用于
nonrefundable_date_ranges中未涉及的入住日期。 - 当
cancel_penalties为空或未返回时，价格为 100% 不可退款。 - 在
cancel_penalties时间范围内取消将产生手续费。 - 最早的
cancel_penalties.[].start是免费取消的截止日期，如果是未来的时间线，最迟cancel_penalties.[].end之后的价格是 100% 不可退款的。
API 响应示例：
可全额退款：
"property_id": "XXXX",
"rooms": [
{
"id": "XXXX",
"room_name": "Traditional Room",
"rates":
"id": "XXXX",
"status": "available",
"available_rooms": 4999,
"refundable": true,
"cancel_penalties": [
{
"start": "2021-05-27T18:00:00.000-07:00",
"end": "2021-05-28T18:00:00.000-07:00",
"amount": "76.00",
"currency": "USD"不可退款：
"property_id": "XXXX",
"rooms":
"id": "XXXX",
"room_name": "Traditional Room",
"rates":
"id": "XXXX",
"status": "available",
"available_rooms": 4999,
"refundable": false ,
"deposit_required": false,
"merchant_of_record": "expedia",可部分退款：
"property_id": "XXXX",
"rooms": [
{
"id": "XXXX",
"room_name": "Traditional Room",
"rates":
"id": "XXXXXXXX",
"status": "available",
"available_rooms": 4999,
"refundable": false,
"cancel_penalties": [
{
"start": "2023-09-03T13:59:00.000+02:00",
"end": "2023-09-04T13:59:00.000+02:00",
"nights": "1",
"currency": "USD"
}
],
"nonrefundable_date_ranges": [
{
"start": "2023-09-08",
"end": "2023-09-13"
}
],用户界面示例：
BP4：展示费用需在价格明细中另行支付。
当收费在 fees 数组内返回时，将每个数值单独显示为住宿的应收费用（入住或退房）。向旅行者出示当地货币并索要兑换金额。这些费用由物业直接收取（不是由我们或地方政府收取），并且不属于税费项下的标准税收回收费用、税款或收费。
API 响应示例：
"fees" : {
"resort_fee": {
"request_currency": {
"value": "74.97",
"currency": "USD"
},
"billable_currency": {
"value": "74.97",
"currency": "USD"
},
"scope": "per_accommodation",
"frequency": "per_night"
}
},用户界面示例：
BP7：重申儿童年龄（如适用）
如果您的集成允许儿童旅客和旅客在选择房间时指定儿童旅客，则必须在预订页面上明确确认儿童旅客的人数及其年龄。此信息通过 child_ages 元素提供。
BP8：说明何时向最终旅行者收取费用（如果是物业代收或当 Expedia Group 为 MoR 时）
如果 Expedia Group 是 MoR，则说明提供的信用卡将立即收取预订的全额款项。
如为住宿收款，则说明住宿接待方将在入住或退房时向旅客提供的信用卡收取费用。如果酒店按 non-refundable post-pay 价格收费，则应说明酒店可能会在旅客完成预订后不久向其收费。
BP9：符合欧洲经济区法规。
如果您打算与欧洲经济区 (EEA) 的旅客进行交易，则需要遵守强客户认证 (SCA) 规定。
Expedia Group 是 MoR 或 Property Collect
如果 Expedia Group 是 MoR，或者对欧洲经济区 (EEA) 或日本的旅客使用 Property Collect，则预订路径必须包括采用 Rapid 的 API 进行 two-factor 身份验证。
附属机构 MoR - 总则
你必须遵守SCA 要求当与旅客的交易在法规范围内时。修订后的支付服务指令（PSD2）全文可在以下网址获取：欧盟委员会。有关可采用的合规标准的更多信息，请参阅 EMVCo 的相关资料。 3D 安全协议和核心功能规范。
附属 MoR - 公司卡或虚拟卡
如果您使用在欧洲经济区或日本发行的银行卡付款，则必须遵守以下规定： SCA 要求。为了减少对 two-factor 身份验证 (2FA) 的需求，您可以使用符合 B2B 支付标准且无需 2FA 的卡。
合规支付方式包括：
- 一次性虚拟信用卡。
- 企业（非个人）注册的多用途公司卡。需要特殊配置文件。
API 请求示例：
https://api.ean.com<Price Check link from previous availability request>API 响应示例：
{
"status": "available",
"occupancy_pricing": {... },
"links": {
"payment_session": {
"method": "POST",
"href": "/v3/payment-sessions?token=XXXX"
}
}
}BP10：当 Expedia Group 为 MoR 时，在结账页面上显示支付处理地点
如果 Expedia Group 是 MoR，则必须在结账页面的显眼位置显示付款处理所在国家/地区。必须在国家/地区名称前插入语句“该付款将在以下国家/地区处理”。
使用选购 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"
}
]
}用户界面示例：
