취소 정책 구성

빠른 숙소 API에서 취소 정책이 어떻게 적용되는지 자세히 알아보세요.

소개

예약 시 전액 환불되지 않는 모든 요금 유형은 API 응답에 refundable=false로 표시됩니다.

각 요금에 대한 구체적인 취소 정책은 Rapid 예약 가능 여부 조회 API의 cancel_penalties 및 nonrefundable_date_ranges 개체 조합으로 결정됩니다.

nonrefundable_date_ranges 개체는 예약 시 전액 환불이 불가능한 숙박 날짜를 정의합니다. 따라서 이 개체는 cancel_penalties 개체에 규정된 추가 취소 정책보다 우선합니다. 필요에 따라 nonrefundable_date_ranges 개체를 사용하여 예약 시 환불 불가능한 숙박 날짜를 설정할 수 있습니다. 참고: nonrefundable_date_range가 포함됩니다. 즉, 1박 요금과 '종료'일에 대한 모든 세금 및 수수료도 청구됩니다.
cancel_penalties 개체는 추가 취소 위약금 세부 정보를 규정하며, 이러한 정책은 다양한 옵션으로 구성됩니다. 세부 정보에는 지정된 위약금 적용 기간 시작일과 종료일, 위약금 유형 및 금액이 포함됩니다. 위약금 유형에는 고정 금액, 숙박 일수 기준 금액, 총 비용에 대한 백분율이 있습니다.

nonrefundable_date_ranges 개체에 정의한 환불 불가 날짜가 요금에 포함된 경우 이러한 숙박 요금은 cancel_penalties 개체에 명시된 다른 취소 위약금에 추가로 부과된다는 점에 유의해야 합니다.

예약에 대한 환불 금액은 예약 관리 API의 일부인 예약 검색 서비스에 있는 cancel_refund 개체에서 확인할 수 있습니다. 숙박 1회 기준 금액의 환불 상태에 대한 자세한 내용은 아래에서 확인해 주세요.

참고: cancel_penalties의 시작 및 종료 기간은 현지 숙박 시설 시간을 기준으로 합니다.

아래 취소 정책 텍스트 구성 지침은 숙박 시설이 취소 정책을 정확하게 해석하고 최종 여행객에게 이를 전달할 수 있도록 지원합니다. 또한, API가 목록에 없는 형식으로 정책을 반환할 경우 환불 불가 메시지를 고객에게 표시하는 데 도움이 됩니다.

캘리포니아 숙박 시설에 대한 정책 표시 업데이트

캘리포니아의 최근 정책 변경 사항을 준수하기 위해 캘리포니아에 위치한 숙박 시설의 경우, 예약 생성 타임스탬프( check-in )로부터 72시간 이내에 취소하지 않는 한, 취소 기간은 예약 생성 시간으로부터 정확히 24시간 후에 시작되도록 Rapid API 을 수정했습니다. 익스피디아 시스템은 이 변경을 자동으로 수행하도록 설정되어 있습니다.

다음은 몇 가지 예입니다:

캘리포니아에 위치한 숙박 시설의 경우 취소 정책이 적용되지 않고 전액 환불이 가능한 요금이 적용되며, 취소 정책은 변경되지 않습니다.
예약 시점부터 취소 위약금이 적용되는 non-refundable 요금이 적용되는 캘리포니아주에 위치한 숙박 시설의 경우, 예약 생성일로부터 정확히 24시간 후에 취소 정책이 적용되도록 수정됩니다.
캘리포니아 외 지역에 위치한 숙박 시설의 경우, 캘리포니아에서 예약이 이루어진 경우에도 취소 정책은 변경되지 않습니다.

Pre-booking 정책 취소

업데이트된 취소 위약금 창은 여행자가 쇼핑하는 동안 API 호출에 자동으로 표시됩니다. non-refundable 예약의 경우 환불 가능 플래그가 false 로 표시되어 있으므로 취소 기간을 기준으로 이를 준수해야 합니다.호텔의 경우 해당 기간은 예약 타임스탬프 시점으로부터 24시간이며, Vrbo 숙박 시설의 경우 예약 다음 날 종료 시까지입니다.

Post-booking 정책 취소

API는 GET/itineraries검색 호출에 업데이트된 취소 위약금 창을 표시합니다. 취소 정책은 모든 예약 확인 이메일에도 표시됩니다.

이 변경으로 조회 API 가용성 응답의 refundable 부울은 수정되지 않습니다. 요금이 non-refundable, 로 설정된 경우에도 Rapid API's 필터링 기능을 유지하기 위해 refundable=false 으로 표시됩니다. 현재 사용 중인 것과 동일한 로직을 사용하여 이 매개변수를 필터링할 수는 있지만, 인터페이스 요소를 표시할 때 캘리포니아의 취소 정책 변경 사항을 고려해야 합니다.

인벤토리 검색 시 예약이 전액 환불 가능한지 여부를 확인할 수 있도록 검색 일정 응답의 refundable 파라미터에 예약이 현재 개정된 취소 위약금 기간 내에 있는지 여부가 반영되어야 합니다.

정책 템플릿

취소 정책은 4가지 주요 기간으로 구성되며, 다음과 같은 템플릿으로 표시됩니다. 취소 정책을 적절하게 표시하려면 4가지 기간을 모두 포함해 주세요.

1. 취소 정책 예외 기간

nonrefundable_date_ranges 개체에서 예약 시점부터 취소 시 환불되지 않는 날짜를 정의할 수 있습니다. 숙박 날짜가 이 기간에 속하지 않는 경우 cancel_penalties 개체 내에 지정된 정책이 적용되며, 예약된 숙박의 일부만 예외 기간 내에 포함되는 경우 부분 환불이 제공될 수 있습니다.

2. 무료 취소 기간

[위약금 적용 기간의 가장 빠른 시작 날짜 및 시간]까지 무료로 취소할 수 있습니다. 참고: 환불 불가 기간(nonrefundable_date_ranges 개체에 정의된 대로)에 속하는 예약 숙박 날짜는 환불되지 않지만, cancel_penalties 개체에 지정된 가장 빠른 위약금 적용 기간의 시작 시간 전에 취소된 경우 이 기간에 포함되지 않은 숙박 날짜에 대한 요금은 전액 환불됩니다.

3. 위약금 적용 취소 기간(여러 위약금 적용 기간이 있을 수 있음) - API 응답에 `cancel_penalties`가 있는 경우

참고: 환불 불가 기간(nonrefundable_date_ranges 개체에 정의된 대로)에 속하는 예약 숙박 날짜는 계속해서 전액 부과되지만, 이 기간에 속하지 않는 숙박 날짜에 대한 요금은 cancel_penalties 개체에 지정된 정책에 따라 환불됩니다.

금액 위약금

[위약금 적용 기간의 시작 날짜 및 시간] 후에 취소하는 경우 [통화] [금액]의 수수료가 부과됩니다.

또는

1박당 위약금

[위약금 적용 기간의 시작 날짜 및 시간] 후에 취소하는 경우 [숙박 일수]박 위약금과 세금 및 수수료가 부과됩니다.

또는

백분율 위약금

[위약금 적용 기간의 시작 날짜 및 시간] 후에 취소하는 경우 총 요금의 [백분율]%에 해당하는 위약금이 부과됩니다. 금액 위약금과 1박당 위약금 또는 금액 위약금과 백분율 위약금은 동시에 적용될 수 있지만, 동일한 기간에 1박당 위약금과 백분율 위약금을 적용할 수는 없습니다.

4. 늦은 체크인 및 노쇼 기간

이 예약에 대해 체크인하지 않거나 체크인 후 취소 또는 변경할 경우 숙박 시설의 재량에 따라 예약 금액의 최대 100%까지 위약금이 부과될 수 있습니다.

위약금 적용 기간의 가장 늦은 종료일이 가장 늦은 취소 날짜 및 시간입니다.

5. 숙박 1회 기준 금액 환불

숙박 개체에 반환된 숙박 1회 기준 금액은 환불 불가로 간주합니다(1일 이상의 숙박이 환불 불가인 경우도 포함). 전체 숙박 기간에 대해 전액 환불 가능한 경우에만 숙박 1회 기준 금액이 환불됩니다.

예

예 1 - 금액 위약금

API 응답:

"refundable": true,
"cancel_penalties": [
    {
        "start": "2022-08-26T23:59:00.000+07:00",
        "end": "2022-09-29T23:59:00.000+07:00",
        "amount": "
        ",
        "currency": "USD"
    }
],

예약 세부 정보:

고객이 2022년 7월 5일에 예약합니다.
체크인 날짜는 2022년 9월 29일입니다.
체크아웃 날짜는 2022년 10월 6일입니다.

취소 정책 설명:

2022년 8월 26일 23:59(GMT +7:00)까지 무료로 취소할 수 있습니다.
2022년 8월 26일 23:59(GMT +7:00) 후에 취소하는 경우 USD 200의 수수료가 부과됩니다.
위약금 적용 취소 기간이 끝나는 일시는 2022년 9월 29일 23:59(GMT +7:00)이며, 그 후로는 예약을 전액 환불받으실 수 없습니다.
이 예약에 대해 체크인하지 않거나 체크인 후 취소 또는 변경할 경우 숙박 시설의 재량에 따라 예약 금액의 최대 100%까지 위약금이 부과될 수 있습니다.

참고: 여러 객실 요청의 경우 반환되는 취소 위약금은 객실 투숙 인원을 기준으로 하며, 해당 인원 수에 따라 금액을 곱해야 합니다.

예 2 - 금액 위약금 + 환불 불가 날짜

API 응답:

"refundable": false,
"cancel_penalties": [
    {
        "start": "2022-08-26T23:59:00.000+07:00",
        "end": "2022-09-29T23:59:00.000+07:00",
        "amount": "200",
        "currency": "USD"
    }
], 
"nonrefundable_date_ranges": [ 
    {  
        "start": "2022-09-30",
        "end": "2022-10-01"
    }
    {   "start": "2022-10-05",         
        "end": "2022-10-06"     
    }
],

예약 세부 정보:

고객이 2022년 7월 5일에 예약합니다.
체크인 날짜는 2022년 9월 29일입니다.
체크아웃 날짜는 2022년 10월 7일입니다.

취소 정책 설명:

2022년 8월 26일 23:59(GMT +7:00) 전에 취소하는 경우:
- 환불 불가 기간(2022년 9월 30일 ~ 2022년 10월 1일 및 2022년 10월 5일 ~ 2022년 10월 6일) 동안 예약된 숙박은 예약 시점부터 전액 환불이 불가능합니다.
- 환불 불가 기간에 포함되지 않은 숙박은 무료로 취소할 수 있습니다.
2022년 8월 26일 23:59(GMT +7:00) ~ 2022년 9월 29일 23:59(GMT +7:00)에 취소하는 경우:
- 환불 불가 기간(2022년 9월 30일 ~ 2022년 10월 1일 및 2022년 10월 5일 ~ 2022년 10월 6일) 동안 예약된 숙박은 예약 시점부터 전액 환불이 불가능합니다.
- 환불 불가 숙박 일수 외에 USD 200의 위약금이 부과됩니다.
위약금 적용 취소 기간이 끝나는 일시는 2022년 9월 29일 23:59(GMT +7:00)이며, 그 후로는 예약을 전액 환불받으실 수 없습니다.
이 예약에 대해 체크인하지 않거나 체크인 후 취소 또는 변경할 경우 숙박 시설의 재량에 따라 예약 금액의 최대 100%까지 위약금이 부과될 수 있습니다.

참고:

이러한 방식으로 nonrefundable_date_ranges 개체를 모든 cancel_penalties 개체 기간과 함께 사용할 수 있습니다.
여러 객실 요청의 경우 반환되는 취소 위약금은 객실 투숙 인원을 기준으로 하며, 해당 인원 수에 따라 금액을 곱해야 합니다.

예 3 - 1박당 위약금

API 응답:

"refundable": true,
"cancel_penalties": [
    {
        "start": "2022-08-26T23:59:00.000+07:00",
        "end": "2022-09-29T23:59:00.000+07:00",
        "nights": "1",
        "currency": "USD"
    }
],

예약 세부 정보:

고객이 2022년 7월 5일에 예약합니다.
체크인 날짜는 2022년 9월 29일입니다.
체크아웃 날짜는 2022년 10월 6일입니다.

취소 정책 설명:

2022년 8월 26일 23:59(GMT +7:00)까지 무료로 취소할 수 있습니다.
2022년 8월 26일 23:59(GMT +7:00) 후에 취소하는 경우 1박 요금이 위약금으로 부과됩니다.
위약금 적용 취소 기간이 끝나는 일시는 2022년 9월 29일 23:59(GMT +7:00)이며, 그 후로는 예약을 전액 환불받으실 수 없습니다.
이 예약에 대해 체크인하지 않거나 체크인 후 취소 또는 변경할 경우 숙박 시설의 재량에 따라 예약 금액의 최대 100%까지 위약금이 부과될 수 있습니다.

참고: 여러 박을 예약한 경우 첫 1박에 대해 위약금이 부과됩니다.

예 4 - 백분율 위약금

API 응답:

"refundable": true,
"cancel_penalties": [
    {         
        "start": "2022-08-26T23:59:00.000+07:00",        
        "end": "2022-09-29T23:59:00.000+07:00",         
        "percent": "90%",        
        "currency": "USD"     }
],

예약 세부 정보:

고객이 2022년 7월 5일에 예약합니다.
체크인 날짜는 2022년 9월 29일입니다.
체크아웃 날짜는 2022년 10월 6일입니다.

취소 정책 설명:

2022년 8월 26일 23:59(GMT +7:00)까지 무료로 취소할 수 있습니다.
2022년 8월 26일 23:59(GMT +7:00) 후에 취소하는 경우 숙박료의 90%에 해당하는 위약금과 수수료가 부과됩니다.
위약금 적용 취소 기간이 끝나는 일시는 2022년 9월 29일 23:59(GMT +7:00)이며, 그 후로는 예약을 전액 환불받으실 수 없습니다.
이 예약에 대해 체크인하지 않거나 체크인 후 취소 또는 변경할 경우 숙박 시설의 재량에 따라 예약 금액의 최대 100%까지 위약금이 부과될 수 있습니다.

예 5 - 무료 취소/취소 위약금 없음

API 응답:

"refundable": true,
"cancel_penalties": [
    {
    "start": "2022-08-26T23:59:00.000+07:00",
    "end": "2022-09-29T23:59:00.000+07:00",
    "nights": "0",
    "currency": "USD"
    }
],

예약 세부 정보:

고객이 2022년 7월 5일에 예약합니다.
체크인 날짜는 2022년 9월 29일입니다.
체크아웃 날짜는 2022년 10월 6일입니다.

취소 정책 설명:

2022년 8월 26일 23:59(GMT +7:00)까지 무료로 취소할 수 있습니다.
8월 26일 23:59(GMT +7:00)부터 체크인 당일인 2022년 9월 29일 사이에는 무료로 취소할 수 있습니다. 위약금은 부과되지 않습니다.
이 예약에 대해 체크인하지 않거나 체크인 후 취소 또는 변경할 경우 숙박 시설의 재량에 따라 예약 금액의 최대 100%까지 위약금이 부과될 수 있습니다.

예 6 - 환불 불가

예약이 전액 환불 불가이면 cancel_penalties 기간의 시작 날짜/시간이 예약 날짜/시간 전인 것입니다.

API 응답:

"cancel_penalties": [
        {
                "start": "2022-11-29T10:47:19.727+00:00",
                "end": "2023-01-05T23:59:00.000+00:00",
                "percent": "100%",
                "currency": "USD"
        }
    ],

예약 세부 정보:

고객이 2022년 11월 30일에 예약합니다.
체크인 날짜는 2023년 1월 5일입니다.
체크아웃 날짜는 2023년 1월 7일입니다.

취소 정책 텍스트:

예약을 취소하면 환불이 불가하며, 향후 숙박에 사용할 수 있는 크레딧도 제공되지 않습니다.

예 7 - 단계적 취소

단계적 취소 정책을 통해 숙박 시설은 취소 공지 금액에 따라 다른 취소 위약금을 고객에게 부과할 수 있습니다. 일반적으로 숙박하는 날짜에 가까워질수록 취소 위약금이 커집니다.

API 응답:

"refundable": true,
"cancel_penalties": [
    { 
        "start": "2022-08-31T23:59:00.000+07:00",
        "end": "2022-12-09T23:59:00.000+07:00",
        "percent": "70%", 
        "currency": "USD" 
    },
    { 
        "start": "2022-12-09T23:59:00.000+07:00",
        "end": "2022-12-12T23:59:00.000+07:00",
        "percent": "90%", 
        "currency": "USD" 
    }
 ],

예약 세부 정보:

고객이 2022년 7월 5일에 예약합니다.
체크인 날짜는 2022년 12월 12일입니다.
체크아웃 날짜는 2022년 12월 22일입니다.

취소 정책 설명:

2022년 8월 31일 23:59(GMT +7:00) 전까지 취소하는 경우 무료입니다.
2022년 8월 31일 23:59(GMT +7:00) ~ 2022년 12월 9일 23:59(GMT +7:00)에 취소하는 경우 숙박료의 70%에 해당하는 위약금과 수수료가 부과됩니다.
2022년 12월 9일 23:59(GMT +7:00) ~ 2022년 12월 12일 23:59(GMT +7:00)에 취소하는 경우 숙박료의 90%에 해당하는 위약금과 수수료가 부과됩니다.
위약금 적용 취소 기간이 끝나는 일시는 2022년 12월 12일 23:59(GMT +7:00)이며, 그 후로는 예약을 전액 환불받으실 수 없습니다.
이 예약에 대해 체크인하지 않거나 체크인 후 취소 또는 변경할 경우 숙박 시설의 재량에 따라 예약 금액의 최대 100%까지 위약금이 부과될 수 있습니다.

예 8 - 부분 환불 가능

API 응답:

"refundable": false
"cancel_penalties": [
     {
     "start": "2022-11-27T22:21:15.996+01:00",
     "end": "2023-01-10T18:00:00.000+01:00",
     "percent": "90%",
     "currency": "USD"
     }
  ],

예약 세부 정보:

고객이 2022년 11월 28일에 예약합니다.
체크인 날짜는 2023년 1월 10일입니다.
체크아웃 날짜는 2023년 1월 14일입니다.

취소 정책 설명:

예약 시점부터 모든 취소에는 90%의 취소 위약금이 부과됩니다.
위약금 적용 취소 기간이 끝나는 일시는 2023년 1월 10일 자정(GMT +1:00)이며, 그 후로는 예약을 전액 환불받으실 수 없습니다.
이 예약에 대해 체크인하지 않거나 체크인 후 취소 또는 변경할 경우 숙박 시설의 재량에 따라 예약 금액의 최대 100%까지 위약금이 부과될 수 있습니다.

예 9 - 숙박 1회 기준 환불 금액

API 응답:

"refundable" : false,
      "cancel_refund" :

{ 
  "amount": "-784.57",
  "currency": "EUR"
 }
,
      "cancel_penalties" : [ {
        "currency" : "EUR",
        "nights" : "1",
        "start" : "2022-11-16T18:00:00.000+04:00",
        "end" : "2022-11-19T18:00:00.000+04:00"

취소 정책 설명:

숙박 1회 기준 금액은 예약 전체가 환불 가능한 경우에만 환불됩니다.
이 예약을 취소하면 1박 취소 위약금이 발생하여 예약의 전체 환불이 불가하며, 이 경우 숙박 1회 기준 금액이 환불되지 않습니다.

취소 정책 구성

빠른 숙소 API에서 취소 정책이 어떻게 적용되는지 자세히 알아보세요.

소개

캘리포니아 숙박 시설에 대한 정책 표시 업데이트

Pre-booking 정책 취소

Post-booking 정책 취소

정책 템플릿

1. 취소 정책 예외 기간

2. 무료 취소 기간

3. 위약금 적용 취소 기간(여러 위약금 적용 기간이 있을 수 있음) - API 응답에 cancel_penalties가 있는 경우

4. 늦은 체크인 및 노쇼 기간

5. 숙박 1회 기준 금액 환불

예

예 1 - 금액 위약금

예 2 - 금액 위약금 + 환불 불가 날짜

예 3 - 1박당 위약금

예 4 - 백분율 위약금

예 5 - 무료 취소/취소 위약금 없음

예 6 - 환불 불가

예 7 - 단계적 취소

예 8 - 부분 환불 가능

예 9 - 숙박 1회 기준 환불 금액

3. 위약금 적용 취소 기간(여러 위약금 적용 기간이 있을 수 있음) - API 응답에 `cancel_penalties`가 있는 경우