숙박 API 출시 요건
Rapid Lodging API로 바로 시작하세요
Rapid Lodging API의 출시 요건에는 대상 고객과 관계없이 모든 구현에 적용되는 요건과, 기업 간( business-to-business, B2B) 또는 기업과 소비자 간( business-to-consumer, B2C) 사용에 대한 구체적인 요건이 포함됩니다. 앞서 통합한 다른 요금 유형/예약 흐름과는 차이가 있을 수 있으므로, 이 요구 사항을 자세히 읽어보시기 바랍니다.
참고: 아래에 나열된 각 요구 사항에는 고객 서비스 팀이 고객님을 더 잘 도와드릴 수 있도록 참고 코드가 포함되어 있습니다.
요구 사항
다음 요구 사항은 모든 Lodging API 구현에 적용됩니다.
GR1: 당사의 명칭 및 로고 사용
당사의 명칭 및 로고는 예외적으로 사전에 당사의 명시적인 서면 승인을 받은 경우에만 traveler-facing 또는 agent-facing 사이트에서 사용할 수 있습니다.
사용자 인터페이스 예시
GR2: 표시할 이용약관 URL 링크
귀사 사이트의 이용약관 문구 내에 당사의 이용약관 링크를 포함하거나, 예약 페이지에서 당사의 이용약관으로 직접 연결되는 링크를 제공해 주십시오. 이 이용약관에서는 예약과 관련된 정책을 자세히 설명합니다. 다음 링크를 easy-to-find 위치에 배치하고, 링크 문구로 “공급업체 이용 약관”을 사용하십시오.
당사가 지원하는 모든 언어로 된 이용 약관 버전은 당사 지원 사이트에서 확인하실 수 있습니다.
사용자 인터페이스 예시 - B2B
사용자 인터페이스 예시 - B2C
GR4: ‘ Expedia Group ’가 등록된 신용카드 발급사( Merchant of Record, MOR)인 경우 신용카드 규정의 적절한 사용 및 표시
여행객의 카드 소지자 데이터를 수집, 사용, 전송, 저장 또는 처리하는 경우, PCI 보안 표준 위원회에서 제정한 결제 카드 산업(PCI) 데이터 보안 표준을 준수해야 합니다.
GR5: 숙박 시설 collect를 사용하거나 Expedia Group 가 MOR인 경우, PCI 준수 증빙 자료를 제출하십시오(해당 파트너에 한함).
Expedia Group 가 MOR이든 숙박 시설가 MOR이든 상관없이, PCI 보안 표준 위원회(PCI Security Standards Council)의 규정에 따라 PCI 준수 증빙 자료로 준수 확인서(AOC)를 제출해야 합니다.
SP1: 제휴사가 예약에 자녀를 포함할 수 있도록 허용하는 경우, 자녀의 연령에 대한 정확한 안내 및 입력
통합 시스템에서 미성년자 승객의 탑승을 허용하는 경우, 체크인 시 각 미성년자 승객의 연령을 지정할 수 있는 기능을 제공해야 합니다. 이 정보는 occupancy 객체를 통해 제공됩니다(아래 예시 참조).
여행자가 동반 아동을 지정할 경우, API 응답에 예약 비용이나 예약 자격에 영향을 미칠 수 있는 연령 제한 및/또는 추가 숙박 요금 또는 유아용 침대 요금이 포함될 수 있습니다.
모든 호텔은 어린이로 분류하는 연령 범주를 구성합니다. 일반적으로 만 17세 이하의 개인을 어린이로 간주합니다. 일부 숙박 시설은 만 18세 미만을 허용하지 않습니다.
API 요청 예시
https://api.ean.com/v3/properties/availability?checkin=2027-09-11
&checkout=2027-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명과 9세, 4세 어린이 2명이 투숙하는 1실.
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": [...]
}
},사용자 인터페이스 예시 - B2B
사용자 인터페이스 예시 - B2C
AP2: ‘ Non-refundable ’ 깃발이 선명하게 보인다
Non-refundable 가용성 정보는 조회 API 가용성 응답에서 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",사용자 인터페이스 예시 - B2B
사용자 인터페이스 예시 - B2C
AP3: Check-in 및 표시된 특별 지침
checkin, checkout, fees 및 policies 객체의 내용은 Content 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 객체의 내용은 Content API 숙박 시설 정의에 따라 반환된 대로 각 객실별로 표시되어야 합니다. 여행자가 예약을 확정하기 전에 check-in 에서 발생할 수 있는 수수료나 특별 이용 안내 사항을 확인할 수 있도록 이 정보를 반드시 표시해야 합니다.
check-in 특수 필드에는 checkin 객체의 지침 필드에 포함되지 않은, check-in 에 필수적인 정보가 포함될 수 있습니다. 예를 들어, 숙박 시설에 예상 도착 시간을 통보해야 한다는 요구 사항, 게스트 건물과 다른 위치에서 check-in 를 이용해야 한다는 사항, 또는 숙박 시설로부터 이메일로 check-in 에 대한 특별 지침을 받을 수 있다는 알림 등이 이에 해당합니다.
동일한 영역에서 instructions 및 special_instructions를 여행객에게 표시해야 합니다.
BP3: 취소 정책 및 ‘ non-refundable ’ 태그가 명확하게 표시됨
여행자가 최종 예약 페이지에서 예약을 확정하기 전에, 선택한 객실에 대한 취소 정책 또는 ‘ 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항목이 비어 있거나 반환되지 않은 경우 해당 요금은 전액 환불 불가 요금입니다.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 배열
"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. 호텔)에 지급되는 세금 환수 수수료입니다. 자세한 내용은 당사의 이용 약관을 참조해 주십시오." 서비스 수수료는 예약 처리에 대한 대가로 징수되며, 여기에는 공급업체에서 부과하는 수수료가 포함될 수 있습니다." _
>> 번역본을 보려면 Expedia Partner Solutions를 방문하세요
tax_and_service_fee에서 반환되는 금액에는 해당 세무 관할 구역에서 의무적으로 부과하는 세금 및 수수료만 포함됩니다.
C) 파트너 서비스 및 예약 요금
Expedia Group 가 추가 서비스 요금이나 예약 수수료를 허용하는 면제를 부여하는 경우, 해당 요금은 명확하게 구분되어야 합니다. 귀사가 예약 금액에 서비스 요금을 추가하는 경우, 해당 요금이 Expedia Group 에서 별도의 서비스(즉, 숙박 제공에 대한 추가 요금이 아님)에 대해 부과하는 것이 아니라 귀사에서 부과하는 것임을 여행자에게 명확히 알려야 합니다. 요금은 기존 세금 및 수수료 항목 내에 포함되어서는 안 됩니다. 숙박 시설에서 부과하는 어떠한 요금에 대해서도 “수수료”라 는 단어를 사용하지 마십시오. 대신 “제휴사 예약 요금” 또는 “제휴사 수수료”를 사용하실 수 있습니다.
참고: B2B 및 B2C 숙박 시설 수집 및 노출 패키지 요금 구현 모두에 추가 요구 사항이 적용됩니다.
사용자 인터페이스 예시
BP7: 아동의 연령을 다시 명시합니다(해당되는 경우).
귀사의 연동 시스템에서 아동 동반 여행객을 허용하고, 해당 여행객이 객실 선택 시 아동 동반 인원을 지정했다면, 예약 페이지에서 아동 동반 여행객의 인원과 연령을 명확히 확인해야 합니다. 이 정보는 child_ages 객체를 통해 제공됩니다.
사용자 인터페이스 예시
BP8: 최종 여행자로부터 대금을 징수할 시기에 대한 명세 ( 숙박 시설 수취인 부담인 경우 또는 Expedia Group 가 MOR인 경우)
Expeda Group이 MOR인 경우, 제공된 신용카드로 예약 총액이 즉시 청구될 것임을 명시하십시오.
Property Collect일 경우 숙박 시설에서 체크인 또는 체크아웃 시 신용카드로 요금이 청구된다고 명시해야 합니다. 만약 숙박 시설가 non-refundable post-pay 요금을 적용하고 있다면, 대신 예약 완료 직후 숙박 시설 측에서 여행자에게 요금이 청구될 수 있음을 안내해 주십시오.
BP9: SCA 규정 준수
규제 당국과 카드 네트워크 업체들은 온라인 결제의 보안을 강화하고 소비자를 사기 피해로부터 보호하기 위해 새로운 요건을 도입하고 있다. 이러한 규정 중 상당수는 온라인 결제 시 강력한 고객 인증(SCA)을 적용해야 한다는 요건을 포함하고 있습니다.
BP10: Expedia Group 가 MOR인 경우 check-out 페이지에 결제 처리 위치가 표시됨
Expedia Group 가 MOR인 경우, 결제 처리가 이루어질 국가는 ‘ check-out ’ 페이지의 눈에 잘 띄는 곳에 표시되어야 합니다. 문구인 “This payment will be processed in” 는 국가명 앞에 삽입되어야 합니다.
조회 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 구현 세부 사항
개발을 지원하거나 피드백을 드리기 위해 체크리스트를 마련해 두었습니다. 사이트 검토를 위해 스크린샷을 제공하시는 경우, 검토를 원활하게 진행할 수 있도록 체크리스트에 해당 스크린샷과 관련 로그를 함께 첨부해 주시기 바랍니다.
GR3: 다운스트림 에이전트는 당사의 재고에 접근하기 위해 당사의 에이전트 이용 약관에 동의해야 합니다.
여행객을 대신하여 예약을 진행하는 여행사는 당사의 하도급 여행사 계약에 동의해야 합니다. 예약 전에 다운스트림 여행사 계약 링크를 담당자에게 제공하고 검토 후 동의를 받아야 합니다. 기타 버전은 익스피디아 파트너 솔루션 웹사이트에서 확인하실 수 있습니다.
사용자 인터페이스 예시
추가 패키지 요금 관련 요건
위에 나열된 일 반적인 요구 사항 외에도, 구현에 패키지 요금 요소를 포함하는 경우 다음 요구 사항도 충족해야 합니다.
AP4: 고유한 레이블이나 식별자를 사용하여 패키지 요금을 표시합니다.
Expedia Group 패키지 요금을 객실 단위의 패키지 요금(개별 항목이 아님)으로 명확히 표시해야 합니다.
사용자 인터페이스 예시
BP5: 가격 표시에는 총액과 세금 및 수수료의 내역이 포함되어야 합니다.
패키지 요금의 총 가격 요건은 위에 나열된 일반적인 요건과는 다릅니다.
A) 총 요금
패키지 요금은 교통수단 요소와 함께 하나의 총 패키지 요금으로 표시되어야 합니다. 이는 일반적으로 숙박 시설에 운송비를 더한 금액인 per-person 의 비용을 표시함으로써 이루어집니다.
총 예약 요금은 결제 페이지에서 여행객을 대상으로 표시되어야 합니다. 총 요금은 API 응답과 일치해야 하며 반올림하거나 통화를 전환해서는 안 됩니다.
사용자 인터페이스 예시
BP11: 대리점에 택배 요금 규정 준수 의무화
담당자가 이 요금을 승인된 교통수단 요소와 함께 판매함을 인정하는 체크상자를 체크아웃 페이지에 포함하세요.
사용자 인터페이스 예시
숙박 시설 추가 수집 요건
위에 나열된 일반적인 요구 사항 외에도, 구현에 숙박 시설 collect를 포함하는 경우 다음 요구 사항도 충족해야 합니다.
B2C 구현 세부 사항
여러분의 개발을 지원하거나 요구 사항에 대한 피드백을 제공하기 위해 체크리스트를 마련했습니다. 사이트 검토를 위해 스크린샷을 제공하시는 경우, 검토를 원활하게 진행할 수 있도록 체크리스트에 해당 스크린샷과 관련 로그를 함께 첨부해 주시기 바랍니다.
GR10: ‘ member-only ’ 상품에 대한 적절한 이용 기회를 제공
Member-only 해당 상품은 closed-user 환경(예: 웹사이트 로그인, 모바일 앱 또는 에이전트 도구)을 통해서만 독점적으로 판매됩니다.
사용자 인터페이스 예시
추가 패키지 요금 요건
위에 나열된 일반적인 요구 사항 외에도, 구현에 패키지 요금 요소를 포함하는 경우 다음 요구 사항도 충족해야 합니다.
BP5: 패키지 가격 표시에는 총액과 세금 및 수수료의 내역이 포함되어야 합니다.
패키지 요금의 총 가격 요건은 위에 나열된 일반적인 요건과는 다릅니다.
A) 총 요금
패키지 요 금은 교통수단 요소와 함께 하나의 총 패키지 요금으로 표시되어야 합니다. 이는 일반적으로 숙박 시설에 운송비를 더한 금액인 per-person 의 비용을 표시함으로써 이루어집니다.
총 예약 요금은 결제 페이지에서 여행객을 대상으로 표시되어야 합니다. 총 요금은 API 응답과 일치해야 하며 반올림하거나 통화를 전환해서는 안 됩니다.
사용자 인터페이스 예시
추가 노출 패키지 요금 요건
위에 나열된 일반적인 요구 사항 외에도, 구현에 노출된 패키지 요금 요소를 포함하는 경우 다음 요구 사항도 충족해야 합니다.
숙박 시설 추가 수집 요건
위에 나열된 일반적인 요구 사항 외에도, 구현에 노출된 패키지 요금 요소를 포함하는 경우 다음 요구 사항도 충족해야 합니다.