B2B 단독 출시 요구 사항
이러한 출시 요건은 최종 고객이 여행사 중 한 곳과 상호작용하는 B2B(기업 간) 통합 모델을 사용하는 모든 파트너에게 적용됩니다.
개요
B2B 출시 요구 사항은 두 가지 섹션으로 분류됩니다:
B2B SA 요구 사항 - 이 예약 흐름에만 해당되는 사항입니다. 앞서 통합한 다른 요금 유형/예약 흐름과는 차이가 있을 수 있으므로, 이 요구 사항을 자세히 읽어보시기 바랍니다.
공통 요구 사항 - 이러한 요구 사항은 모든 예약 흐름에 공통적으로 적용됩니다. 모든 흐름에서 이 요구 사항을 충족하는지 확인해 주세요.
체크리스트
여기에서 개발을 지원하거나 요구 사항에 대한 피드백을 제공하는 데 도움이 되는 체크리스트( )를 확인할 수 있습니다. 사이트 이용 후기 스크린샷을 제공하려는 경우 체크리스트에 스크린샷과 해당 로그를 추가해 주세요. 그러면 심사를 완료하는 데 도움이 됩니다.
B2B SA 관련 요구 사항
일반적인 출시 요구 사항
아래 출시 요건은 모든 예약 흐름에 걸쳐 모든 익스피디아 그룹 파트너에게 적용됩니다. 요금 표시에 대한 자세한 설명을 포함하여 각 요금 유형과 관련된 추가 요구 사항은 각 요금 요구 사항 목록에 나와 있습니다.
GR1: 익스피디아 그룹 이름 및 로고 사용
익스피디아 그룹 이름과 로고의 사용은 예외적으로 익스피디아 그룹의 사전 서면 승인을 받은 고객 또는 에이전트 대면 사이트에서만 사용할 수 있습니다.
예시:
GR2: 표시할 익스피디아 그룹 이용 약관 URL 링크
사이트의 자체 이용약관 텍스트에 익스피디아 그룹 이용약관 링크를 제공하거나 예약 페이지에서 직접 약관에 연결할 수 있습니다. 이 이용약관에서는 예약과 관련된 정책을 자세히 설명합니다. '공급업체 이용약관'이라는 링크를 사용하여 찾기 쉬운 위치에 다음의 링크를 배치합니다. 영어 버전은 여기 다른 버전은 여기 에서 확인할 수 있습니다.
예시:
GR4: Expedia 그룹 규정: 신용카드 규정 관련 적절한 사용 및 표시
최종 고객의 카드 소지자 데이터를 획득, 사용, 전송, 저장 또는 처리하는 경우, 귀하는 PCI 보안 표준 위원회 에서 발행한 PCI DSS를 준수해야 합니다. 이러한 규정에 대한 전체 참조는 공식 PCI 보안 표준 위원회 웹사이트에서 확인할 수 있습니다.
GR5: 익스피디아 그룹 MoR 또는 자산 수집: 해당 파트너를 위해 제공된 PCI 규정 준수 증명 자료
익스피디아 그룹 또는 숙박시설이 MoR인 경우 PCI 규정 준수에 대한 증거로 규정 준수 증명(AOC)을 제출해야 합니다.
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명, 어린이 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=falseShop 예약 가능 여부 응답에 으로 표시됩니다. 예약 가능 여부 응답으로 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 필드에는 checkin개체의 지침 필드에 포함되지 않은 check-in 에 중요한 정보(예: 숙박 시설에 예상 도착 시간, 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 암호화를 사용하여 클라이언트 브라우저/앱과 사이트 간의 연결 및 종속 시스템과의 네트워크 통신을 보호해야 합니다. 개인정보에는 고객 이름, 전화번호 또는 이메일, 결제 카드 세부 정보, 예약/일정 영수증 및 확인 페이지가 포함됩니다. 보안 상태가 아닌 경우 연결을 중지하거나 리디렉션합니다.
BP2: check-in 및 특별 check-in 지침 표시
checkin, checkout, fees, policies객체의 콘텐츠는 숙박 시설에서 반환된 대로 각 객실에 대해 표시되어야 합니다. 콘텐츠 정의. 고객이 예약을 확정하기 전에 체크인 또는 특별 이용 방법에서 잠재적 수수료를 확인할 수 있도록 이 정보를 표시해야 합니다.
특별 check-in 필드에는 checkin개체의 지침 필드에 포함되지 않은 check-in 에 중요한 정보(예: 숙박 시설에 예상 도착 시간, check-in 게스트 건물과 다른 위치, 또는 숙박 시설에서 이메일을 통해 특별 check-in 지침을 기대하라는 알림)를 포함할 수 있습니다.
동일한 영역에서 instructions 및 special_instructions를 여행객에게 표시해야 합니다.
BP3: 취소 정책 및 non-refundable 태그가 명확하게 표시됨
최종 예약 페이지에서 고객의 구매 확인을 허용하기 전에 선택한 객실에 대한 취소 정책/환불 불가 태그를 제공해야 합니다. 각 요금에 대한 취소 정책은 Rapid 예약 가능 여부 조회 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항목이 비어 있거나 반환되지 않은 경우 해당 요금은 전액 환불 불가 요금입니다.cancel_penalties기간에 취소하는 경우 위약금이 발생합니다.- 가장 빠른
cancel_penalties.[].start이 무료 취소 기한(향후 일정인 경우)입니다. - 요금은 최신
cancel_penalties.[].end이후 100% non-refundable 입니다.
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: 가격 내역 내에 숙박 시설에 부과되는 요금을 별도로 표시합니다.
수수료 배열에서 요금이 반환되면 숙박 시설에서 체크인 또는 체크아웃 시 지불해야 할 요금으로 각 값을 개별 표시해야 합니다. 여행자에게 현지 통화를 제시하고 환전을 요청하세요. 이러한 요금은 bt Expedia Group 또는 지방 정부가 아닌 숙박 시설에서 직접 징수하며 세금 및 수수료 항목에 포함된 표준 세금 회수 비용, 세금 또는 수수료의 일부가 아닙니다.
API 응답 예시: 수수료 배열
"fees" : {
"resort_fee": {
"request_currency": {
"value": "74.97",
"currency": "USD"
},
"billable_currency": {
"value": "74.97",
"currency": "USD"
},
"scope": "per_accommodation",
"frequency": "per_night"
}
},사용자 인터페이스 예:
스탠다드 더블룸 예시](resources/reference/assets/Price_display_must_include_the_total_price_and_breakdown_of_the_taxes_and_fees.png'Standard double room example'
BP7: 해당되는 경우 아동 연령을 다시 입력해야 합니다.
통합에서 어린이 여행객을 허용하며 고객이 객실 선택 시 어린이 여행객을 지정한 경우, 예약 페이지에서 어린이 여행객의 인원 수와 각 연령을 명확히 확인해야 합니다. 이 정보는 child_ages객체를 통해 제공됩니다.
BP8: Expedia Group MoR 또는 숙박 시설 수금: 최종 여행자로부터 결제를 받을 시기를 명시합니다.
Expedia Group MoR인 경우, 제공한 신용카드로 예약 금액 전액이 즉시 청구됨을 명시합니다.
Property Collect일 경우 숙박 시설에서 체크인 또는 체크아웃 시 신용카드로 요금이 청구된다고 명시해야 합니다. 숙박 시설에서 환불 불가 후불제 요금을 제공하는 경우 예약을 완료한 직후에 숙박 시설에서 고객에게 요금을 청구할 수도 있다는 점을 대신 명시해야 합니다.
BP9: 유럽 경제 지역 규정 준수: 결제 서비스 지침 2(PSD2)
EEA(유럽 경제 지역)의 고객과 거래하고자 하는 모든 파트너는 PSD2를 준수해야 합니다. 자세한 내용은 여기에서 확인해 보세요.
Expedia Group MoR 또는 숙박 시설 수집
Expedia Group 가 MoR이거나 숙박 시설 Collect가 유럽 고객에게 사용되는 경우, 예약 경로에 two-factor 인증 에 대한 Rapid의 API 채택이 포함되어야 합니다.
제휴 MoR - 일반
파트너는 규제 범위 내에 있는 고객과 거래할 때 PSD2 규정의 SCA(엄격한 고객 인증) 요구 사항을 준수해야 합니다. 지침 전문은 유럽 연합 위원회에서 확인하실 수 있습니다. 채택 가능한 준수 표준에 대한 추가 정보는 EMVCo의 “3D 보안 프로토콜 및 핵심 기능 사양”에 나와 있습니다.
제휴 MoR - 법인 카드 또는 가상 카드
EEA 내 국가에서 발급된 partner-owned 카드로 Expedia Group 결제하는 파트너는 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": "/2.4/payment-sessions?token=XXXX"
}
}
}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"사용자 인터페이스 예:
