B2C 单独预订上线要求
如果您采用 business-to-consumer (B2C) 集成模型，旅行者直接与您的集成进行交互，则适用这些启动要求。
概述
这些要求分为两类：
- **B2C SA 要求：**这些是该预订流程的特定要求。请仔细阅读这些要求，因为它们可能与您之前整合的任何其他房价类型/预订流程的要求不同。
- **通用要求：**这些是所有预订流程的通用要求。请务必满足适用于所有流程的所有通用要求。
核对清单
我们创建了一个检查清单，以帮助您进行开发或提供有关需求的反馈。如果您打算提供截图用于网站审核，请在核对清单中添加截图和相应日志，这将帮助我们完成审核。
B2C 单独预订要求
通用要求
以下上线要求适用于所有预订流程。每个房价要求列表中提供了每种房价类型的特定附加要求，包括价格显示的详细说明。
GR1：禁止使用 Expedia Group 名称和徽标。
未经我们事先明确的书面批准，不得在 traveler-facing 或 agent-facing 网站上使用我们的名称和徽标。
示例：
GR2：显示我们的条款和条件网址的链接。
在您的网站条款和条件文本中提供指向我们条款和条件的链接，或者直接从您的预订页面提供指向条款的链接。这些条款详细说明了管理预订的政策。将以下链接放置在显眼的位置，并使用“提供商条款和条件”作为链接描述。
你可以找到英文版和其他版本已列入 Expedia 合作伙伴解决方案。
示例：
GR4：Expedia Group 是记录商户 (MoR)：正确使用和展示信用卡法规。
无论何时，只要您获取、使用、传输、存储或处理旅行者的持卡人数据，您都应遵守支付卡行业数据安全标准（PCI DSS），该标准由支付卡行业安全标准委员会发布。这些规定的完整参考资料可在官方网站上查阅。 PCI 安全标准网站。
GR5：Expedia Group 是 MoR 或 Property Collect：在适用情况下提供 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：每间客房均提供床型说明。
购物回应可能会返回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 的可用性由以下方式指示：refundable=false在购物可用性响应。什么时候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：显示入住和特别入住说明。
内容checkin，checkout，fees，和policies必须按返回的顺序，在每个房间中显示物品。内容属性定义。此信息必须显示在您的可用性页面上，以确保旅行者了解 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：显示入住和特别入住说明。
对于每个房间，必须显示 checkin、checkout、fees 和 policies对象的内容，这些内容在 Content 属性定义中返回。必须显示此信息，以确保旅客在最终预订之前了解 check-in 的任何潜在费用或特殊访问说明。
special_instructions字段可能包含对 check-in 至关重要的信息，而这些信息并未包含在 checkin对象的 instructions字段中，例如需要通知酒店预计到达时间、check-in 位于与客房不同的位置，或者提醒酒店通过电子邮件发送特殊的 check-in 指示。
确保在同一区域内向旅客显示 instructions 和 special_instructions。
BP3：清晰显示取消政策和不可退款标记。
在允许旅客在最终预订页面确认购买之前，您必须提供所选房间的取消政策或 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： - 一旦创建预订，将立即生成不可退款的金额。cancel_penalties和nonrefundable_date_ranges将提供更多详细信息。nonrefundable_date_ranges： - 一旦创建预订，此范围内的住宿日期不可退款。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：遵守欧洲经济区法规：支付服务指令 2 (PSD2)。
如果您打算与欧洲经济区 (EEA) 的旅客进行交易，则必须遵守 PSD2 法规。
Expedia Group 是 MoR 或 Property Collect。
如果 Expedia Group 是 MoR，或者对欧洲旅行者使用 Property Collect，则预订路径必须包括采用 Rapid 的 API 进行 two-factor 身份验证。
附属机构 MoR - 通用。
当与旅客进行的交易属于 PSD2 法规的适用范围时，您必须遵守 PSD2 法规中的强客户认证 (SCA) 要求。可在欧盟委员会查看该指令的全文。有关可用合规标准的更多信息，请查看 EMVCo 的“3D 安全协议和核心功能规范”。
附属 MoR - 公司卡或虚拟卡。
如果您使用在欧洲经济区 (EEA) 国家/地区发行的银行卡向我们付款，则您必须遵守 PSD2 法规的要求。为了减少对 PSD2 2FA 的需求，您可以使用符合 B2B 支付标准且免于 2FA（two-factor 身份验证）的卡。
合规支付方式包括：
- 一次性虚拟信用卡。
- 企业（非个人）注册的多用途公司卡。需要特殊配置文件。
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"
}
]
}用户界面示例：
