취소 정책 구성
Rapid Lodging API를 통해 취소 정책이 어떻게 모델링되고 제공되는지 이해하기
개요
Rapid 조회 API는 ‘가용성’ 응답에 포함된 모든 요금에 대한 취소 정책 세부 정보를 반환합니다. 각 요금제에 대한 구체적인 취소 정책은 다음 주요 항목을 바탕으로 구성됩니다:
- tri-state 플래그(
current_refundability)는 요청 시점에 해당 요금의 환불 가능 여부를 정확하게 나타냅니다. cancel_penalties객체는 시작/종료 날짜, 벌칙 유형 및 값을 포함하는 정책 기간을 정의합니다.nonrefundable_date_ranges는 해당 예약에 대해 non-refundable 로 유지될 투숙 일자를 정의합니다(cancel_penalties보다 우선 적용됨).
참고:cancel_penalties.start 및 cancel_penalties.end에서 반환되는 ISO-8601 오프셋은 표시 및 계산 시 기준으로 삼아야 할 공식적인 값입니다. 이는 대개 현지 숙박 시설 시간대와 일치하지만, supplier-configured 의 시간대 데이터를 반영할 수도 있으므로 숙박 시설 주소/지리적 위치 정보를 바탕으로 재계산해서는 안 됩니다.
이 페이지의 모든 예시에서는 오프셋을 명시적으로 표시하고 있습니다(예: GMT+7:00). 이는 제공된 대로 오프셋을 유지하고 표시해야 함을 강조하기 위함입니다.
>> 캘리포니아주의 구체적인 정책 표시 규칙을 확인하세요 숙박 시설
지침
Refundability(환불 여부)
refundability-driven 의 로직과 사용자 경험을 제어하는 주된 수단으로는 current_refundability을 사용하십시오. 이 도구는 정책 구성을 가장 정확하게 반영하며, 특히 partial-penalty 시나리오에서 더욱 그렇습니다.
| 값 | 의미 |
|---|---|
refundable | 전액 환불 가능 |
non_refundable | 환불이 불가능합니다 |
partially_refundable | 위약금이 0보다 크지만 총 예약 금액보다 작거나, 숙박 기간 내에 ‘ non-refundable ’ 날짜 범위가 포함되어 있는 경우 |
refundable부울 값은 정책의 환불 가능 여부를 파악할 수 있게 해주지만, 그 범위가 제한적이며 부분 환불이나 복잡한 위약금이 어떻게 적용되는지, 또는 기타 수수료가 부과될 수 있는지 여부를 완전히 설명하지는 않습니다. 예약 시 전액 환불이 불가능한 요금의 경우 ‘ refundable=false ’라고 표시됩니다.
Non-refundable 날짜 범위
필요에 따라 nonrefundable_date_ranges 개체를 사용하여 예약 시 환불 불가능한 숙박 날짜를 설정할 수 있습니다. nonrefundable_date_range에는 1박 요금과 각종 세금 및 수수료가 모두 포함되어 있음을 유의해 주시기 바랍니다.
nonrefundable_date_ranges객체에 요금의 ‘ non-refundable ’ 날짜가 정의되어 있는 경우, 해당 숙박 일수에 대해서는 cancel_penalties객체에 명시된 기타 취소 위약금과 함께 요금이 부과됩니다.
숙박 시설 요금
취소 시 지불해야 하는 수수 료를 언급할 때는, 누가 수수료를 징수하는지 및 그 이유가 무엇인지 더 정확하게 반영하기 위해 “취소 수수료” 대신 “숙박 시설 수수료”라는 용어를 사용하는 것이 모범 사례입니다.
예약 시
취소 정책에 대한 세부 내용은 예약이 취소 위약금 적용 기간 내에 이루어졌는지, 아니면 그 기간 외에 이루어졌는지에 따라 답변 내용에 따라 달라집니다. 아래 예시에서 refundable숙박 시설를 확인해 보세요.
취소 위약금 적용 기간 내에 예약된 경우:
{
"itinerary_id": "9999999999999",
...
"rooms": [
{
"links": {
...
},
"id": "1111",
...
"status": "booked",
"checkin": "2026-08-03",
"checkout": "2026-08-07",
...
"rate": {
"id": "2222",
...
"refundable": false,
"cancel_refund": {
"amount": "0.00",
"currency": "USD"
},
"cancel_penalties": [
{
"currency": "USD",
"percent": "100%",
"start": "2026-07-16T06:56:59.311-07:00",
"end": "2026-08-03T23:59:00.000-07:00"
}
],
...
"pricing": {
...
}
}
}
]
}취소 위약금 적용 기간 외에 예약한 경우:
{
"itinerary_id": "9999999999999",
...
"rooms": [
{
"links": {
...
},
"id": "1111",
...
"status": "booked",
"checkin": "2026-09-27",
"checkout": "2026-10-02",
...
"rate": {
"id": "2222",
...
"refundable": true,
"cancel_refund": {
"amount": "-1131.85",
"currency": "EUR"
},
"cancel_penalties": [
{
"currency": "EUR",
"percent": "100%",
"start": "2026-07-18T01:21:30.000-07:00",
"end": "2026-09-27T23:59:00.000-07:00"
}
],
...
"pricing": {
...
}
}
}
]
}정책 구성 요소
여행객에게 제시해야 하는 취소 정책은 에 명시된 네 가지 주요 기간 과 per-stay 의 환불 규정 을 바탕으로 합니다. 로직을 구성할 때 네 가지 시간대를 모두 고려해야 하며, 해당되는 경우에는 UI 텍스트에도 이를 반영해야 합니다.
취소 정책의 예외 사항
정의: nonrefundable_date_ranges
이 숙박 일정은 예약 시점부터 완전히 non-refundable 로 처리됩니다. 예약된 숙박 일수가 다음 기간 중 하나에 해당하는 경우, 여행자가 언제 취소하든 상관없이 해당 숙박 일수에 대한 요금은 항상 전액 청구됩니다.
날짜 범위는 시작일과 종료일을 모두 포함하며, 숙박이 종료되는 날의 1박 요금과 해당 날짜에 적용되는 세금 및 수수료도 함께 청구됩니다. non-refundable.
체류 기간 중 일부만 ‘ non-refundable ’ 기간과 겹치는 경우, 해당 기간 외의 숙박 일수에 대해서는 cancel_penalties에 명시된 기타 위약금 적용 기간에 따라 환불이 가능할 수 있습니다.
Traveler-facing 문의: 이 날짜들은 예약 시점부터 ‘ non-refundable ’로 간주됩니다. 예약을 변경하거나 취소할 경우, 해당 기간에 대한 환불이나 향후 숙박 시 사용할 수 있는 크레딧을 받을 수 없으며, 세금 및 수수료도 지불하셔야 합니다.
무료 취소
이는 예약 생성 시점부터 ‘ cancel_penalties ’ 객체에 벌금이 적용되는 가장 이른 보험 등급 기간이 시작되는 시점까지의 기간이며, ‘ nonrefundable_date_ranges ’에 포함된 숙박 일수는 제외됩니다. 모든 기간 중 가장 이른 ‘ cancel_penalties.start ’를 확인하고, 해당 타임스탬프를 무료 취소 기간의 종료 시점으로 사용하십시오.
참고: 의 취소 정책에는 최대 3단계의 기간이 설정될 수 있습니다.
Traveler-facing 문의: [위약금 적용 기간 중 가장 이른 날짜 및 시간] 이전에 예약을 취소하시면 전액 환불해 드립니다. non-refundable 기간 내에 예약된 숙박 일자에 대해서는 환불이 불가합니다.
벌칙 취소
정의 출처: ‘ cancel_penalties ’에 포함된 각 요소(해당하는 경우).
지원되는 벌칙 유형
각 벌칙 기간 내에서는 ‘ nonrefundable_date_ranges ’의 숙박 일수는 ‘ non-refundable ’ 상태를 유지하며, 추가 벌칙은 해당 ‘ cancel_penalties ’ 창에서 설정된 대로 적용됩니다. 참고로, 동일한 기간 내에 ‘ ’의 금액 + 숙박 일수 또는 ‘ ’의 금액 + 할인율 을 결합하는 것은 가능하지만, 단일 티어 기간 내에 ‘ ’ 숙박 일수와 할인율을 함께 적용할 수는 없습니다.
금액 위약금
- 지정된 통화로 책정된 고정 수수료 (e.g. 200 USD)
Traveler-facing 메시지: [보험 기간 시작일 및 시간] 이후에 취소할 경우 [금액] [통화]가 청구됩니다.
1박당 위약금
- 지정된 숙박 일수에 대한 요금과 세금 및 수수료가 부과됩니다(여러 박을 예약한 경우, 요금은 첫 번째 숙박 일부터 청구됩니다).
Traveler-facing 문의: [보험 기간 시작일 및 시간] 이후에 예약을 취소할 경우, [숙박 일수] 일분의 숙박 요금과 세금 및 수수료가 청구됩니다.
백분율 위약금
- 총 숙박 요금 및 수수료의 일정 비율 (e.g. 90%).
Traveler-facing 문의: [예약 기간의 시작 날짜 및 시간] 이후에 예약을 취소할 경우, 총 숙박 요금의 [비율]이 청구됩니다.
Post-check-in 취소 및 no-show
이는 마지막으로 설정된 페널티 기간(cancel_penalties[end])이 지난 후의 기간입니다. 다시 말해, ‘ check-in ’ 시간 직전 단계 창을 말합니다.
Traveler-facing 문의: 이 예약에 대해 ‘ no-show ’을 선택하셨거나, ‘ check-in ’ 시간 이후에 예약을 취소하거 나 변경하는 경우, [마지막으로 설정된 위약금 적용 기간에 명시된 금액/통화/숙박 일수/비율]이 청구됩니다.
per-stay 에 대한 환불 금액
Per-stay stay객체에 반환되는 금액은 다음과 같은 단일 규칙을 따릅니다:
- 체류 기간 중 어느 하루라도 non-refundable, per-stay 에 해당하는 금액은 다음과 같습니다. non-refundable
- Per-stay 에서 전체 숙박 기간 에 대해 전액 환불이 가능한 경우에만 금액이 환불됩니다.
참고: VRBO 숙박 시설의 경우, 서비스 수수료 부과 및 환불과 관련해 몇 가지 세부 사항이 추가로 적용되므로, 자세한 내용은 통합 컨설턴트에게 문의하시기 바랍니다.
캘리포니아주 정책 정보 업데이트 숙박 시설
캘리포니아주의 정책 변경 사항을 준수하기 위해, 예약 생성 타임스탬프로부터 정확히 24시간이 지난 시점부터 취소 기간이 시작되어야 합니다. 단, 예약이 다음 시점으로부터 72시간 이내에 이루어진 경우는 예외입니다. check-in. 익스피디아 시스템은 캘리포니아에 위치한 모든 숙박 시설에 대해 취소 기간을 자동으로 조정합니다.
예상되는 동작 예시:
- 캘 리포니아 주 내에 위치한 숙박 시설의 경우, 요금이 전액 환불 가능하며 취소 위약금이 부과되지 않으므로, 취소 정책에는 변경 사항이 없습니다.
- 캘리포니아 주에 위치한 숙박 시설의 경우, 예약 시점부터 취소 위약금이 적용되는 ‘ non-refundable ’ 요금이 적용되므로, 취소 정책은 예약 생성일로부터 정확히 24시간이 지난 시점부터 적용되도록 수정됩니다.
- 숙박 시설가 캘리포니아주 외부에 위치한 경우, 예약이 캘리포니아주 내에서 이루어졌더라도 취소 정책에는 아무런 변경이 없습니다.
Pre-booking 취소 정책
여행자가 상품을 구매하는 동안, 업데이트된 취소 위약금 기간이 API 호출 시 자동으로 표시됩니다. non-refundable 예약의 경우 ‘ refundable ’ 플래그가 false로 유지된다는 점을 확인하실 수 있으며, 따라서 취소 기간에 따라 이를 준수하셔야 합니다. 호텔의 경우, 해당 취소 기간은 예약 타임스탬프로부터 24시간입니다. Vrbo 숙박 시설의 경우, 예약일 다음 날 종료 시까지입니다.
Post-booking 취소 정책
예약 후에도 조정된 캘리포니아 보험 약관이 계속 적용됩니다.
- 예약이 환불 가능한지 여부와 환불해야 할 금액에 대해서는 ‘예약 관리’의 ‘
GET /itineraries’ 및 ‘cancel_refund’를 정확한 기준으로 삼으십시오. - 확인 이메일에는 수정된 취소 정책도 명시되어 있습니다.
- Shopping의 ‘
refundable’ 부울 값은 이번 변경 사항에 따라 수정되지 않으며, 필터링 목적으로 해당 요율이 ‘ non-refundable ’로 지정되었는지 여부를 계속해서 반영합니다. - Retrieve 일정 응답에 포함된 ‘
refundable’ 매개변수는 해당 예약이 현재 적용 가능한 취소 기간 내에 있는지 여부를 나타냅니다. ‘ post-booking ’ 옵션을 표시할 때, 이 매개변수를 활용하여 예약이 전액 환불 가능한지 여부를 결정하십시오.