B2B 단독 출시 요구 사항
여행자가 여행사 중 한 곳과 상호 작용하는 business-to-business (B2B) 통합 모델을 사용하는 경우 이러한 출시 요구 사항이 적용됩니다.
개요
B2B 출시 요구 사항은 두 가지 섹션으로 분류됩니다:
B2B SA 요구 사항: 이 예약 흐름에만 해당되는 요구 사항입니다. 앞서 통합한 다른 요금 유형/예약 흐름과는 차이가 있을 수 있으므로, 이 요구 사항을 자세히 읽어보시기 바랍니다.
공통 요구 사항: 이 요구 사항은 모든 예약 흐름에 공통으로 적용됩니다. 모든 흐름에서 이 요구 사항을 충족하는지 확인해 주세요.
체크리스트
개발 지원 또는 피드백 제공에 도움이 되는 체크리스트는 에서 확인할 수 있습니다 . 사이트 이용 후기 스크린샷을 제공하려는 경우 체크리스트에 스크린샷과 해당 로그를 추가해 주세요. 그러면 심사를 완료하는 데 도움이 됩니다.
B2B SA 관련 요구 사항
일반적인 출시 요구 사항
아래 출시 요건은 모든 예약 흐름의 모든 파트너에게 적용됩니다. 요금 표시에 대한 자세한 설명을 포함하여 각 요금 유형과 관련된 추가 요구 사항은 각 요금 요구 사항 목록에 나와 있습니다.
GR1: 회사 이름 및 로고 사용
당사의 이름과 로고 사용은 예외적으로 사전에 명시적으로 서면 승인을 받은 traveler-facing 또는 agent-facing 사이트에서만 사용할 수 있습니다.
예시:
GR2: 표시할 이용 약관 URL 링크
사이트의 자체 이용약관 텍스트에 당사의 이용약관 링크를 제공하거나 예약 페이지에서 직접 약관에 연결하세요. 이 이용약관에서는 예약과 관련된 정책을 자세히 설명합니다. "공급업체 이용약관"이라는 링크 문구를 사용하여 easy-to-find 위치에 다음 링크를 배치합니다. 영어 버전 및 기타 버전 을 익스피디아 파트너 솔루션에서 확인할 수 있습니다.
예시:
GR4: 당사는 Merchant 기록(MoR)이 있는 곳입니다: 신용카드 규정과 관련한 적절한 사용 및 표시
여행자의 카드 소지자 데이터를 획득, 사용, 전송, 저장 또는 처리하는 경우 PCI 보안 표준 협의회에서 발행한 결제 카드 업계 데이터 보안 표준을 준수해야 합니다. 이러한 규정에 대한 전체 참조는 공식 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: Non-refundable 플래그가 명확하게 표시됨
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: check-in 및 특별 check-in 지침 표시
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 또는 특별 액세스 지침에서 잠재적인 수수료에 대해 알 수 있도록 표시되어야 합니다.
특별 check-in 필드에는 checkin개체의 지침 필드에 포함되지 않은 check-in 에 중요한 정보(예: 숙박 시설에 예상 도착 시간, check-in 게스트 건물과 다른 위치, 또는 숙박 시설에서 이메일을 통해 특별 check-in 지침을 기대하라는 알림)를 포함할 수 있습니다.
동일한 영역에서 instructions 및 special_instructions를 여행객에게 표시해야 합니다.
BP3: 취소 정책 및 non-refundable 태그가 명확하게 표시됨
최종 예약 페이지에서 여행자가 구매를 확정하도록 허용하기 전에 선택한 객실의 취소 정책 또는 non-refundable 태그를 제공해야 합니다. 각 요금에 대한 취소 정책은 빠른 쇼핑 가용성 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: 가격 내역 내에 숙박 시설에 부과되는 요금을 별도로 표시합니다.
수수료 배열에서 요금이 반환되면 숙박 시설에서 체크인 또는 체크아웃 시 지불해야 할 요금으로 각 값을 개별 표시해야 합니다. 여행자에게 현지 통화를 제시하고 환전을 요청하세요. 이러한 요금은 당사나 지방 정부가 아닌 숙박 시설에서 직접 징수하며, 세금 및 수수료 항목에 포함된 표준 세금 회수 비용, 세금 또는 수수료의 일부가 아닙니다.
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: 우리는 MoR 또는 숙박 시설 Collect입니다: 최종 여행자로부터 대금을 수령할 시기를 명시합니다.
당사가 MoR인 경우, 제공된 신용카드로 예약 금액 전액이 즉시 청구될 것임을 명시하세요.
Property Collect일 경우 숙박 시설에서 체크인 또는 체크아웃 시 신용카드로 요금이 청구된다고 명시해야 합니다. non-refundable post-pay 요금이 적용되는 경우, 대신 예약 완료 직후 숙박 시설로 여행자에게 요금이 청구될 수 있음을 표시하세요.
BP9: 강력한 고객 인증(SCA) 규정 준수
규제 기관과 카드 네트워크는 온라인 결제의 보안을 강화하고 사기로부터 소비자를 보호하기 위해 새로운 요건을 도입하고 있습니다. 이러한 규정의 대부분은 온라인 결제 시 강력한 고객 인증(SCA)을 사용해야 한다는 요구 사항을 포함하고 있습니다.
BP10: 우리는 MoR입니다 - check-out 페이지에 표시되는 결제 처리 위치
당사가 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"사용자 인터페이스 예:
