숙박 API 출시 요구 사항
빠른 숙박 API로 바로 시작하기
빠른 숙소 API의 출시 요건에는 대상에 관계없이 모든 구현에 적용되는 요건과 business-to-business (B2B) 또는 business-to-consumer (B2C) 사용에 대한 특정 요건이 포함됩니다. 앞서 통합한 다른 요금 유형/예약 흐름과는 차이가 있을 수 있으므로, 이 요구 사항을 자세히 읽어보시기 바랍니다.
참고: 아래 나열된 각 요구 사항에는 고객 서비스 팀의 도움을 받을 수 있는 참조 코드가 포함되어 있습니다.
요구 사항
다음 요구 사항은 모든 숙박 API 구현에 적용됩니다.
GR1: 회사 이름 및 로고 사용
당사의 이름과 로고 사용은 예외적으로 사전에 명시적으로 서면 승인을 받은 traveler-facing 또는 agent-facing 사이트에서만 사용할 수 있습니다.
사용자 인터페이스 예시
GR2: 표시할 이용 약관 URL 링크
사이트의 자체 이용약관 텍스트 내에 당사의 이용약관 링크를 제공하거나 예약 페이지에서 약관에 직접 연결하세요. 이 이용약관에서는 예약과 관련된 정책을 자세히 설명합니다. "공급업체 이용약관"이라는 링크 문구를 사용하여 easy-to-find 위치에 다음 링크를 배치합니다.
당사가 지원하는 모든 언어의 이용약관 버전은 Rapid API 이용약관 페이지에서 확인할 수 있습니다 .
사용자 인터페이스 예시 - B2B
사용자 인터페이스 예시 - B2C
GR4: 신용 카드 규정의 적절한 사용 및 표시( Expedia Group 가 Merchant 인 경우, MOR)
여행자의 카드 소지자 데이터를 획득, 사용, 전송, 저장 또는 처리하는 경우 PCI 보안 표준 협의회에서 발행한 결제 카드 업계(PCI) 데이터 보안 표준을 준수해야 합니다. 이러한 규정에 대한 전체 참조는 공식 PCI 보안 표준 위원회 웹사이트에서 확인할 수 있습니다.
GR5: 숙박 시설 수집을 사용하거나 Expedia Group 가 MOR인 경우 PCI 준수 증거를 제공하세요(해당 파트너만 해당).
Expedia Group 가 MOR이든 숙박 시설 가 MOR이든, PCI 준수 증명(AOC)을 PCI 준수 증거로 제공해야 합니다.
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": [
[사용자 인터페이스 예시: 성인 2명과 만 17세, 만 2세, 만 1세 미만의 어린이 3명이 투숙하는 객실 1개.
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": [...]
}
},사용자 인터페이스 예시 - B2B
사용자 인터페이스 예시 - B2C
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",사용자 인터페이스 예시 - B2B
사용자 인터페이스 예시 - B2C
AP3: Check-in 및 특별 지침 표시
checkin, checkout, fees, policies객체의 콘텐츠는 콘텐츠 API 숙박 시설 정의에서 반환된 대로 각 방에 대해 표시되어야 합니다. 이 정보는 예약 가능 여부 페이지에 표시되어 여행자가 체크인 시 발생할 수 있는 수수료 또는 특별 액세스 지침을 인지할 수 있도록 해야 합니다.
특별 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 및 특별 지침 표시
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"
}
},사용자 인터페이스 예시
BP5: 가격 표시에는 총 가격과 세금 및 수수료 내역이 포함되어야 합니다.
A) 총 요금
총 예약 요금은 결제 페이지에서 여행객을 대상으로 표시되어야 합니다. 총 요금은 API 응답과 일치해야 하며 반올림하거나 통화를 전환해서는 안 됩니다. 최종 내역에는 객실 요금(총액 또는 1박당), 추가 1박 요금(아래 설명된 property_fee항목 제외), 모든 숙박 금액 및 세금, 청구 가능한 총액이 포함되어야 하며, 현재 지불한 금액과 나중에 지불할 금액을 숙박 시설에 명시해야 합니다.
참고: 추가 가격 표시 요구 사항은 B2B 또는 B2C 패키지 요금 및 노출 패키지 요금 구현에 적용됩니다.
B) 세금 내역
가격 표시에는 tax_and_service_fee와 property_fee의 합계가 '세금 및 수수료'라는 제목으로 한 줄에 표시되어야 합니다. 가격 내역 내 세금 및 수수료 총액을 언급할 때는 법적으로 아래의 정확한 문구를 표시해야 합니다. pop-up, 일반 텍스트, 모달 또는 기타 구현으로 표시할 수 있습니다. 결제 페이지에 숙박 시설 수수료가 별도로 표시되지 않아야 합니다.
"세금"은 공급업체(e.g. 호텔)에 지불하는 세금 회수 비용이며, 자세한 내용은 이용약관을 참조하세요. 서비스 수수료는 예약을 서비스하는 데 대한 보상으로 유지되며 공급업체가 부과하는 수수료가 포함될 수 있습니다." 번역은 익스피디아 파트너 솔루션 에서 확인할 수 있습니다.
tax_and_service_fee에 반환되는 금액에는 조세 관할권에서 규정하는 세금 및 수수료만 포함됩니다.
C) 파트너 서비스 및 예약 요금
Expedia Group 에서 추가 서비스 또는 예약 요금에 대한 면제를 허용하는 경우, 이를 명확하게 구분해야 합니다. 회원님이 예약에 추가되는 서비스 요금을 부과하는 경우, 해당 요금은 별도의 서비스(즉, 숙박 제공에 대한 추가 요금이 아닌)에 대해 Expedia Group 이 아닌 회원님이 부과하는 것임을 여행자에게 명확히 알려야 합니다. 요금은 기존 세금 및 수수료 항목에 포함되지 않을 수 있습니다. 글에 부과되는 요금에 '수수료'라는 단어를 사용하지 마세요. 대신 "제휴사 숙박 시설" 또는 "제휴사 서비스 요금"을 사용할 수 있습니다.
참고: 추가 요구 사항은 B2B 또는 B2C 숙박 시설 수집 및 노출 패키지 요금 구현에 적용됩니다.
BP7: 아동 연령이 반복 표시됩니다(해당되는 경우).
통합에서 어린이 여행자를 허용하고 여행자가 객실 선택 시 어린이 여행자를 지정한 경우, 예약 페이지에서 어린이 여행자의 수와 연령을 명확하게 확인해야 합니다. 이 정보는 child_ages객체를 통해 제공됩니다.
사용자 인터페이스 예시
BP8: 최종 여행자로부터 결제가 이루어지는 시점에 대한 설명(숙박 시설 수집 또는 Expedia Group 이 MOR인 경우)
익스피디아 그룹이 MOR인 경우, 제공된 신용카드로 예약 금액 전액이 즉시 청구될 것임을 명시하세요.
Property Collect일 경우 숙박 시설에서 체크인 또는 체크아웃 시 신용카드로 요금이 청구된다고 명시해야 합니다. non-refundable post-pay 요금이 적용되는 경우, 대신 예약 완료 직후 숙박 시설로 여행자에게 요금이 청구될 수 있음을 표시하세요.
BP9: SCA 규정 준수
규제 기관과 카드 네트워크는 온라인 결제의 보안을 강화하고 사기로부터 소비자를 보호하기 위해 새로운 요건을 도입하고 있습니다. 이러한 규정 중 상당수는 온라인 결제 시 강력한 고객 인증(SCA)을 사용해야 한다는 요구 사항을 포함하고 있습니다.
BP10: check-out 페이지에 표시되는 결제 처리 위치가 MOR인 경우 Expedia Group
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"사용자 인터페이스 예시
B2B 구현 세부 사항
개발 지원 또는 피드백 제공에 도움이 되는 체크리스트는 요구 사항 에서 확인할 수 있습니다. 사이트 검토를 위해 스크린샷을 제공하는 경우, 검토 완료에 도움이 되도록 체크리스트에 스크린샷과 해당 로그도 추가해야 합니다.
추가 패키지 요금 요구 사항
위에 나열된 일반적인 요구 사항 외에도 패키지 요금 요소를 구현에 포함하는 경우 이러한 요구 사항도 충족해야 합니다.
AP4: 고유 레이블 또는 식별자로 패키지 요금을 표시합니다.
객실 수준에서 Expedia Group 패키지 요금이 개별 품목이 아닌 패키지 요금임을 명확하게 식별해야 합니다.
사용자 인터페이스 예시
BP5: 가격 표시에는 총 가격과 세금 및 수수료 내역이 포함되어야 합니다.
패키지 요금의 총 가격 요건은 위에 나열된 일반적인 요건과 다릅니다.
A) 총 요금
패키지 요금은 교통수단 요소와 함께 하나의 총 패키지 요금으로 표시되어야 합니다. 일반적으로 숙박 시설에 운송비를 더한 per-person 비용을 표시하는 방식으로 이루어집니다.
총 예약 요금은 결제 페이지에서 여행객을 대상으로 표시되어야 합니다. 총 요금은 API 응답과 일치해야 하며 반올림하거나 통화를 전환해서는 안 됩니다.
사용자 인터페이스 예시
BP11: 상담원이 패키지 요금 규칙을 수락하도록 요구하기
담당자가 이 요금을 승인된 교통수단 요소와 함께 판매함을 인정하는 체크상자를 체크아웃 페이지에 포함하세요.
사용자 인터페이스 예시
추가 숙박 시설 수집 요구 사항
위에 나열된 일반적인 요구 사항 외에도 숙박 시설 수집을 구현에 포함하려는 경우 이러한 요구 사항도 충족해야 합니다.
B2C 구현 세부 사항
개발을 지원하거나 요구 사항에 대한 피드백을 제공하는 데 도움이 되는 체크리스트()를 만들었습니다. 사이트 검토를 위해 스크린샷을 제공하는 경우, 검토 완료에 도움이 되도록 체크리스트에 스크린샷과 해당 로그도 추가해야 합니다.
GR10: member-only 거래에 대한 적절한 액세스 권한 제공
Member-only 거래는 closed-user 환경(예: 사이트, 모바일 앱 또는 상담원 도구에 로그인)에서만 판매해야 합니다.
사용자 인터페이스 예시
추가 패키지 요금 요건
위에 나열된 일반적인 요구 사항 외에도 패키지 요금 요소를 구현에 포함하는 경우 이러한 요구 사항도 충족해야 합니다.
BP5: 패키지 가격 표시에는 총 가격과 세금 및 수수료 내역이 포함되어야 합니다.
패키지 요금의 총 가격 요건은 위에 나열된 일반적인 요건과 다릅니다.
A) 총 요금
패키지 요금은 교통수단 요소와 함께 하나의 총 패키지 요금으로 표시되어야 합니다. 일반적으로 숙박 시설에 운송비를 더한 per-person 비용을 표시하는 방식으로 이루어집니다.
총 예약 요금은 결제 페이지에서 여행객을 대상으로 표시되어야 합니다. 총 요금은 API 응답과 일치해야 하며 반올림하거나 통화를 전환해서는 안 됩니다.
사용자 인터페이스 예시
추가 노출 패키지 요금 요 건
위에 나열된 일반적인 요구 사항 외에도 구현에 노출 패키지 요금 요소를 포함하는 경우 이러한 요구 사항도 충족해야 합니다.
추가 숙박 시설 수집 요구 사항
위에 나열된 일반적인 요구 사항 외에도 구현에 노출 패키지 요금 요소를 포함하는 경우 이러한 요구 사항도 충족해야 합니다.