Developer Hub
자동 생성된 번역입니다.

취소 정책 구성

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

소개

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

각 요금에 대한 구체적인 취소 정책은 Rapid 예약 가능 여부 조회 API의 cancel_penaltiesnonrefundable_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가 목록에 없는 형식으로 정책을 반환할 경우 환불 불가 메시지를 고객에게 표시하는 데 도움이 됩니다.

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

캘리포니아주의 최근 정책 변경 사항을 준수하기 위해, 당사는 Rapid API 를 개정하여 캘리포니아주에 위치한 모든 숙박 시설에 대해, 예약 생성 타임스탬프로부터 정확히 24시간 후에 취소 기간이 시작되도록 했습니다. 단, check-in 시간으로부터 72시간 이내에 예약된 경우는 예외로 합니다. 익스피디아 시스템은 이러한 변경 사항이 자동으로 적용되도록 설정되어 있습니다.

다음은 몇 가지 예시입니다:

  • 캘리포니아 주에 위치한 숙박 시설의 경우, 전액 환불이 가능하며 별도의 취소 정책이 적용되지 않으므로, 취소 정책에 대한 변경 사항은 없습니다.
  • 캘리포니아 주에 위치한 숙박 시설의 경우, 예약 시점부터 취소 위약금이 적용되는 ‘ 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 로 표시됩니다. 현재와 동일한 논리를 사용하여 이 매개변수를 기준으로 필터링하는 것은 여전히 가능하지만, 인터페이스 요소를 표시할 때는 캘리포니아주의 해지 정책 변경 사항을 고려해야 합니다.

Retrieve 일정 응답에 포함된 ‘ 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회 기준 금액이 환불됩니다.

참고: 취소 시 부과되는 수수료를 언급할 때는, 누가 수수료를 징수하는지 및 그 사유를 더 정확하게 반영하기 위해 “취소 수수료(cancellation fee)” 대신 “숙박 시설 수수료”라는 용어를 사용하는 것이 모범 사례입니다.

|

예 1 - 금액 위약금

API 응답:

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

예약 세부 정보:

  • 고객이 2027년 7월 5일에 예약을 합니다.
  • Check-in 날짜는 2027년 9월 29일입니다.
  • Check-out 날짜는 2027년 10월 6일입니다.

취소 정책 설명:

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

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

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

API 응답:

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

예약 세부 정보:

  • 고객이 2027년 7월 5일에 예약을 합니다.
  • Check-in 날짜는 2027년 9월 29일입니다.
  • Check-out 날짜는 2027년 10월 7일입니다.

취소 정책 설명:

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

참고:

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

예 3 - 1박당 위약금

API 응답:

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

예약 세부 정보:

  • 고객이 2027년 7월 5일에 예약을 합니다.
  • Check-in 날짜는 2027년 9월 29일입니다.
  • Check-out 날짜는 2027년 10월 6일입니다.

취소 정책 설명:

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

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

예 4 - 백분율 위약금

API 응답:

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

예약 세부 정보:

  • 고객이 2027년 7월 5일에 예약을 합니다.
  • Check-in 날짜는 2027년 9월 29일입니다.
  • Check-out 날짜는 2027년 10월 6일입니다.

취소 정책 설명:

  • 8월 26일 2027 11:59 (GMT +7:00)까지 무료로 취소할 수 있습니다.
  • 2027 11:59 년 8월 26일 오후 (GMT +7:00) 이후에 취소할 경우, 숙박 요금 및 수수료의 90%가 위약금으로 부과됩니다.
  • 취소 가능 기간의 마감 시간은 9월 29일 오후 2027 11:59 (GMT +7:00)이며, 이 시간이 되면 예약은 완전히 non-refundable.
  • 이 예약에 대해 체크인하지 않거나 체크인 후 취소 또는 변경할 경우 숙박 시설의 재량에 따라 예약 금액의 최대 100%까지 위약금이 부과될 수 있습니다.

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

API 응답:

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

예약 세부 정보:

  • 고객이 2027년 7월 5일에 예약을 합니다.
  • Check-in 날짜는 2027년 9월 29일입니다.
  • Check-out 날짜는 2027년 10월 6일입니다.

취소 정책 설명:

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

예 6 - 환불 불가

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

API 응답:

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

예약 세부 정보:

  • 고객이 2027년 11월 30일에 예약을 합니다.
  • Check-in 날짜는 2028년 1월 5일입니다.
  • Check-out 날짜는 2028년 1월 7일입니다.

취소 정책 텍스트:

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

예 7 - 단계적 취소

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

API 응답:

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

예약 세부 정보:

  • 고객이 2027년 7월 5일에 예약을 합니다.
  • Check-in 날짜는 2027년 12월 12일입니다.
  • Check-out 날짜는 2027년 12월 22일입니다.

취소 정책 설명:

  • 8월 31일 2027 11:59 PM (GMT +7:00) 이전에 취소할 경우 수수료가 부과되지 않습니다.
  • 8월 31일 2027 11:59 PM (GMT +7:00)부터 12월 9일 2027 11:59 PM (GMT +7:00) 사이에 예약을 취소할 경우, 숙박 요금 및 수수료의 70%가 위약금으로 부과됩니다.
  • 12월 9일 2027 11:59 (GMT +7:00)부터 12월 12일 2027 11:59 (GMT +7:00) 사이에 예약을 취소할 경우, 숙박 요금 및 수수료의 90%가 위약금으로 부과됩니다.
  • 취소 가능 기간의 마감 시간은 12월 12일 오후 2027 11:59 시(GMT +7:00)이며, 이 시간이 되면 예약은 완전히 non-refundable.
  • 이 예약에 대해 체크인하지 않거나 체크인 후 취소 또는 변경할 경우 숙박 시설의 재량에 따라 예약 금액의 최대 100%까지 위약금이 부과될 수 있습니다.

예 8 - 부분 환불 가능

API 응답:

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

예약 세부 정보:

  • 고객이 2027년 11월 28일에 예약을 합니다.
  • Check-in 날짜는 2028년 1월 10일입니다.
  • Check-out 날짜는 2028년 1월 14일입니다.

취소 정책 설명:

  • 예약 시점부터 모든 취소에는 90%의 취소 위약금이 부과됩니다.
  • 취소 가능 기간의 마감 시간은 1월 10일 오전 2028 00:00 (GMT +1:00)이며, 이 시간이 되면 예약은 완전히 non-refundable.
  • 이 예약에 대해 체크인하지 않거나 체크인 후 취소 또는 변경할 경우 숙박 시설의 재량에 따라 예약 금액의 최대 100%까지 위약금이 부과될 수 있습니다.

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

API 응답:

"refundable" : false,
"cancel_penalties" : [
    {
        "start" : "2027-11-16T18:00:00.000+04:00",
        "end" : "2027-11-19T18:00:00.000+04:00",
        "nights" : "1",
        "currency" : "EUR"
    }
],

취소 정책 설명:

  • 숙박 1회 기준 금액은 예약 전체가 환불 가능한 경우에만 환불됩니다.
  • 이 예약을 취소하면 1박 취소 위약금이 발생하여 예약의 전체 환불이 불가하며, 이 경우 숙박 1회 기준 금액이 환불되지 않습니다.
이 페이지가 도움이 되었나요?
이 콘텐츠를 어떻게 개선하면 좋을까요?
더 나은 Developer Hub를 만드는 데 도움을 주셔서 감사합니다!