B2C 单独预订上线要求
以下上线要求适用于使用企业对消费者 (B2C) 集成模型的所有 EPS 合作伙伴，其中最终客户可直接与您的集成互动。
概述
为了给您的集成体验提供最佳支持，我们将这些要求分为了两类：
- **B2C SA 要求：**这些是该预订流程的特定要求。请仔细阅读这些要求，因为它们可能与您之前整合的任何其他房价类型/预订流程的要求不同。
- **通用要求：**这些是所有预订流程的通用要求。请务必满足适用于所有流程的所有通用要求。
核对清单
您可以点击此链接获取核对清单，为您的开发提供支持和帮助，或者提交关于这些要求的反馈。如果您打算提供截图用于网站审核，请在核对清单中添加截图和相应日志，这将帮助我们完成审核。
B2C 单独预订要求
通用要求
以下上线要求适用于所有预订流程中的所有 EPS 合作伙伴。每个房价要求列表中提供了每种房价类型的特定附加要求，包括价格显示的详细说明。
GR1：禁止使用 Expedia Group 或 EPS 名称和徽标。
禁止出于任何目的将 Expedia Group 或 EPS 的名称或徽标用于任何面向客户的合作伙伴网站。任何例外情况（如住客点评）均必须事先经过 EPS 的批准和明确书面同意。
示例：
GR2：显示指向 EPS 条款和条件的 URL 链接。
在您的网站条款和条件文本中提供指向 EPS 条款和条件的链接，或者从预订页面直接链接至相应条款。这些条款详细说明了管理预订的政策。将以下链接放置在显眼的位置，并使用“提供商条款和条件”作为链接描述。
点击此处可获取英文版。
其他版本，均发布于此处。
示例：
GR4：EPS MOR - 合理使用和显示相关信用卡规定。
如需获取、使用、传输、存储或处理最终客户的持卡人数据，您应遵守 PCI 安全标准委员会发布的 PCI DSS。这些法规的完整版在 PCI 安全标准官方网站上提供。
GR5：EPS MOR 或住宿收款 - 提供给适用合作伙伴的 PCI 合规证据。
如果 EPS 或住宿是记录商户 (MoR)，则必须提供合规证明 (AOC) 作为 PCI 合规证据。EPS 合作伙伴必须使用 PCI 安全标准委员会的自我评估问卷文件“SAQ D - Merchants”生成适当的 AOC。
您可以在 PCI 安全标准官方文档库中查看 SAQ 说明和准则，并找到“SAQ D - Merchants”文件，也可以将“SAQ D - Merchants”文件直接下载为 PDF 或 Word 文档。
SP1：联盟伙伴允许在预订中包含儿童时，需提供适当的消息并要求输入儿童年龄。
如果您的集成允许儿童旅客，则必须提供指定每位儿童旅客年龄的功能。此信息通过 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": [
[示例：1 间客房，2 位成人和 2 名儿童（9 岁和 4 岁）
AP1：每间客房均提供床型说明。
购物响应可能会返回 bed_groups 数组以及一个值或多个选项。显示配置数组中包含的值，用于描述客户的床型选择。
当 bed_groups 数组返回多个选项时，会显示选购响应针对每种床型提供的 price_check 链接，以允许客户进行选择。
必须向旅客显示一条消息，指明选择同一客房中的多个床型仅为请求，如果房态不允许，酒店可能并不会满足这些请求。
客房名称会在购物响应的客房数组内作为 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：清晰显示不可退款标记。
不可退款价格应在房态页面内明确显示。当 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",不可退款标记 UI 示例：
AP3：显示入住和特别入住说明。
针对每间客房显示的checkin、checkout、fees和policies对象的内容必须与住宿内容定义中返回的一样。该信息必须显示在房态页面上，以确保客户可以在入住说明或特别进屋指南中了解任何潜在费用。
special_instructions 字段可能包含未包含在 checkin 对象 instructions 字段中的入住相关重要信息，例如需要向住宿接待方通知预计到达时间、在其他地点办理入住或者通过电子邮件提醒住宿接待方的特别入住说明。
确保在同一区域内向旅客显示 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对象的内容必须与住宿内容定义中返回的一样。该信息必须显示，以确保客户在完成预订之前，可以在入住说明或特别进屋指南中了解任何潜在费用。
special_instructions 字段可能包含未包含在 checkin 对象 instructions 字段中的入住相关重要信息，例如需要向住宿接待方通知预计到达时间、在其他地点办理入住或者通过电子邮件提醒住宿接待方的特别入住说明。
确保在同一区域内向旅客显示 instructions 和 special_instructions。
BP3：清晰显示取消政策和不可退款标记。
允许客户在您的最终预订页面上确认购买前，您必须针对所选客房提供取消政策/不可退款标记。Rapid 选购房态 API 的 cancel_penalties 对象中提供了针对每种价格的取消政策。
对于可退款价格，响应中包含一系列取消政策详情。详情包括：指定手续费的开始日期和结束日期、手续费类型和金额，及任何适用的例外预订日期。手续费类型包括：固定金额手续费、按住宿晚数计算的手续费以及按总费用百分比计算的手续费。
时间：
refundable=true：- 此价格可全额退款。
refundable=true+cancel_penalties：- 此价格在取消时间范围内可退款。
- 最早的
cancel_penalties.[].start是免费取消的截止日期，如果是未来的时间线，最迟cancel_penalties.[].end之后的价格是 100% 不可退款的。
refundable=false：- 此价格不可退款。
- 没有返回取消手续费适用期限。
refundable=false+cancel_penalties：- 价格可部分退款。
cancel_penalties应与nonrefundable_date_ranges一起显示，后者将显示创建预订后不可退款的范围内的住宿日期。
有关如何构建取消政策的更多信息，请见此处。
参考：
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 数组内返回时，将每个数值单独显示为住宿的应收费用（入住或退房）。这些费用由住宿（而非 EPS 或地方政府）直接收取，且不属于“税费”行中的标准代缴税款、税款或费用。
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：如果适用，必须重申儿童年龄。
如果您的集成允许儿童旅客，并且客户在客房选择中指定了儿童旅客，则您必须在预订页面中明确确认儿童旅客的人数及其年龄。此信息通过 occupancy 元素提供。
BP8：EPS MOR 或住宿收款：说明最终旅客何时付款。
如为 EPS MOR，则说明系统将向旅客提供的信用卡立即收取预订全款。
如为住宿收款，则说明住宿接待方将在入住或退房时向旅客提供的信用卡收取费用。如果住宿接待方提供不可退款的后付费房价，则说明住宿接待方在客户完成预订后很快便会向其收取费用。
BP9：遵守欧洲经济区法规：支付服务指令 2 (PSD2)。
计划与欧洲经济区 (EEA) 内客户交易的任何合作伙伴都必须遵守 PSD2。在此处了解更多。
EPS MOR 或住宿收款。
如果 EPS 为记录商户或欧洲客户使用住宿收款，则预订过程中必须采用 Rapid 的双重身份验证 API。
联盟伙伴 MOR - 一般要求。
如果客户交易属于 PSD2 法规范围，合作伙伴必须遵循该法规的强客户身份验证 (SCA) 要求。可在欧盟委员会查看该指令的全文。有关可用合规标准的更多信息，请查看 EMVCo 的“3D 安全协议和核心功能规范”。
联盟伙伴 MOR - 公司卡或虚拟信用卡。
如果合作伙伴使用 EEA 内某国家/地区发行的合作伙伴专属卡向 EPS 付款，则必须遵守 PSD2 法规的要求。为了减轻对 PSD2 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：EPS MOR 或住宿收款 Premium – 在付款页面上显示处理付款的位置信息。
如果 EPS 或住宿为记录商户，则必须在付款页面中的显著位置显示付款将在哪个国家/地区得到处理。必须在国家/地区名称前插入语句“该付款将在以下国家/地区处理：”。
使用选购 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"
}
]
}示例：
