어떤 이유로든 취소

여행자에게 non-refundable 예약을 취소하고 호텔 요금 전액을 환불받을 수 있는 유연성 제공

개요

여행 보호 API는 이미 빠른 숙소 API와 통합한 사용자를 위한 새로운 옵션 기능입니다. 해당 숙박 예약에 대해 '어떤 사유로든 취소 가능(CFAR)' 업그레이드가 제공되므로, 여행자는 non-refundable 예약을 취소하고 호텔 결제 대금을 전액 환불받을 수 있는 유연성을 누릴 수 있습니다.

CFAR이란 무엇인가요?

CFAR이 추가되면 여행자는 체크인 전에 non-refundable 숙박 예약을 취소하고 호텔 전액을 환불받을 수 있습니다. CFAR은 기존 여행 보험이 아닌 여행 서비스로서 자격 요건이나 청구 절차가 필요하지 않으며, 여행자는 어떤 이유로든 추가 서류 작업 없이 취소할 수 있습니다.

CFAR이 도와드립니다:

lower-priced non-refundable 인벤토리에서 전환율 높이기
non-refundable 요금 예약 시 여행자에게 자신감 부여
취소 관련 마찰 감소
수동 클레임 처리 없이 유연성 제공

CFAR 라이브 사이트 표시 예시

참고: 이 샘플은 예시용으로만 제공됩니다.

출시 요구 사항

여행 보호 API를 통합하기 전에 이미 Rapid Lodging API(예약 가능 여부/쇼핑, 가격 확인, 예약 엔드포인트)를 사용 중이어야 합니다. 인증 메커니즘은 래피드 숙박 API에서와 같이 서명 인증()을 통해 이루어집니다.

이 범위를 자격 증명에 추가하려면 계정 관리자에게 문의하세요.

작동 방식

CFAR 통합은 중단을 최소화합니다. 예약 가능 여부/쇼핑, 예약 및 취소(1, 4, 6단계)에 대한 기존 빠른 숙소 요청 페이로드는 변경할 필요가 없습니다. 새로운 동작은 추가적이므로 CFAR 제안에 따라 조치를 취하지 않으면 통합에 아무런 변화가 없습니다.

빠른 숙박이 가능한 CFAR

1단계: 숙박 요금 검색

변경할 필요가 없습니다.

표준 숙박 예약 가능 여부/쇼핑 호출입니다. 요청 또는 응답 처리에는 수정이 필요하지 않습니다.

2단계: 가격 확인 API 호출

표준 빠른 숙박 요금 확인 전화입니다. 요청을 변경할 필요는 없습니다.

요금이 CFAR 적용 대상인 경우, 가격 확인 응답에는 add_trip_protection객체에 기존 book링크와 함께 links링크가 포함됩니다. 이 링크를 사용하여 여행자에게 CFAR 옵션을 제공해야 합니다.

예시: 가격 확인 응답 linksobject (CFAR-eligible rate)

{
  "links": {
    "book": {
      "method": "POST",
      "href": "/v3/itineraries?token=QldfCGtcTjIbASj7"
    },
    "add_trip_protection": {
      "method": "GET",
      "href": "/v1/trip-protection/quote?token=QldfCGtcTjIbASj7"
    }
  }
}

참고:add_trip_protection 링크는 요금이 CFAR 적용 대상인 경우에만 표시됩니다. 링크가 없는 경우 해당 요금에 대해 CFAR을 사용할 수 없습니다.

3단계: 여행자 보험 견적 받기

엔드포인트: GET /v1/trip-protection/quote?token={token}

이 단계는 선택한 요금에 대한 전체 CFAR 견적을 검색하는 선택적 단계입니다. 2단계에서 반환된 href링크의 add_trip_protection을 요청 URL로 사용합니다.

응답에는 다음이 포함됩니다:

제품 세부 정보: 제품 이름, 유형, 공급업체 및 판매자 기록
정책 세부 정보: 보장 날짜, 보장 비율 및 한도, 마케팅 카피(헤드라인, 개요, 혜택), 면책 조항 및 정책 문구 문서 링크
가격: CFAR 가격(trip_protection_price)과 숙박 + 보호 합산 금액(totals), 각각 청구 가능 통화와 요청 통화로 표시(세금/수수료 포함 및 제외)됩니다.
취소 위약금: 취소 시 보호 상품 자체에 적용되는 위약금
예약 링크:links.book 매개변수는 4단계에서 CFAR로 예약하는 데 사용됩니다.

필수 헤더

헤더	필수 항목	참고
`Accept`	예	애플리케이션/json이어야 합니다.
`Accept-Encoding`	예	Gzip 형식이어야 합니다.
`Customer-Ip`	예	End-traveler's IPv4 주소(서버가 아닌)
`User-Agent`	예	고객의 user-agent 또는 `{app-name}/{app-version}`
`Customer-Session-Id`	아니요	사용자 세션당 고유; re-use 동일한 세션의 모든 통화에 걸쳐서
`Test`	아니요	샌드박스 테스트용: `standard`, `service_unavailable`, `unknown_internal_error`

예시: 견적 응답

{
  "product_name": "Cancel for any reason (100% Refund)",
  "product_type": "hotel_cancel_for_any_reason",
  "vendor": "[vendor name]",
  "merchant_of_record": "expedia",
  "policy": {
    "start_date": "2025-10-13T15:59:00.000+01:00",
    "end_date": "2025-10-18T08:00:00.000-08:00",
    "coverage": {
      "percentage": "100%",
      "limit": {
        "inclusive": {
          "billable_currency": { "value": "[amount]", "currency": "USD" },
          "request_currency": { "value": "[amount]", "currency": "USD" }
        },
        "exclusive": {
          "billable_currency": { "value": "[amount]", "currency": "USD" },
          "request_currency": { "value": "[amount]", "currency": "USD" }
        }
      }
    },
    "description": {
      "headline": "Change of plans? You're covered.",
      "overview": "Add flexibility to your stay with Cancel for any reason coverage. Get a refund if you cancel before 8:00 AM property time on [check-in date].",
      "benefits": "<b>Get a refund of 100%: [refund_amount]</b>
<b>Cancel anytime before 8:00 AM property time on [checkin_date]</b>
<b>No questions asked, no paperwork</b>
"
    },
    "disclaimer": "By purchasing, I agree to all Cancel for any reason [policy_terms_link_text] on my itinerary",
    "links": {
      "policy_wording": {
        "method": "GET",
        "href": "https://staging.vendor.com/pds/1ed50cef-49e1-4ff6-acc9-137ba784e472?policy_type=expedia_travel_insurance_v1"
      }
    }
  },
  "pricing": {
    "trip_protection_price": {
      "inclusive": {
        "billable_currency": { "value": "[amount]", "currency": "USD" },
        "request_currency": { "value": "[amount]", "currency": "USD" }
      },
      "exclusive": {
        "billable_currency": { "value": "[amount]", "currency": "USD" },
        "request_currency": { "value": "[amount]", "currency": "USD" }
      }
    },
    "totals": {
      "inclusive": {
        "billable_currency": { "value": "[amount]", "currency": "USD" },
        "request_currency": { "value": "[amount]", "currency": "USD" }
      },
      "exclusive": {
        "billable_currency": { "value": "[amount]", "currency": "USD" },
        "request_currency": { "value": "[amount]", "currency": "USD" }
      }
    }
  },
  "refundable": false,
  "cancel_penalties": [
    {
      "start": "2026-10-13T15:59:00.000+01:00",
      "end": "2026-10-18T08:00:00.000-08:00",
      "currency": "USD",
      "amount": "[amount]",
      "percent": "100%"
    }
  ],
  "links": {
    "book": {
      "method": "POST",
      "href": "/v3/itineraries?token=MY5S3j36cOcL",
      "expires": "2026-10-13T16:10:00.000+01:00"
    }
  }
}

4단계: 예약 API 호출

요청 페이로드는 변경되지 않습니다.

표준 빠른 숙박 예약 전화(POST /v3/itineraries)입니다. 사용할 예약 링크는 여행자가 CFAR에 동의했는지 여부에 따라 달라집니다.

여행자 선택	예약 링크 사용
CFAR 사용	`links.book` 3단계 견적 응답에서
CFAR 없음	`links.book` 2단계 가격 확인 응답에서

예약 요청이나 응답에 새 필드가 추가되지 않습니다. CFAR은 예약 링크에 사용된 토큰에 의해서만 활성화됩니다.

참고: 견적 응답의 links.book토큰이 만료됩니다( expires필드 참조). 토큰이 만료되기 전에 예약이 제출되었는지 확인하세요.

5단계: 예약 검색

요청에 대한 변경 사항이 없습니다.

표준 빠른 숙박 GET /v3/itineraries/{itinerary_id}전화입니다.

CFAR을 구매한 경우 일정 응답에는 구매한 제품의 정책 및 가격 세부 정보가 포함된 trip_protection객체가 추가로 포함됩니다. CFAR을 구매하지 않은 경우 일정 응답에 아무런 변화가 없습니다.

또한 CFAR이 활성화된 경우 일정 cancel_penalties객체에 있는 refundable및 rate필드에는 기본 요금의 취소 정책이 아닌 CFAR 정책이 반영됩니다.

예시: 예: trip_protection개체를 보여주는 일정 응답

[
  {
    "itinerary_id": "8999989898988",
    "property_id": "8150374",
    "trip_protection": {
      "product_name": "Cancel for any reason (100% Refund)",
      "product_type": "hotel_cancel_for_any_reason",
      "vendor": "[vendor]",
      "merchant_of_record": "expedia",
      "policy": {
        "start_date": "2026-10-13T15:59:00.000+01:00",
        "end_date": "2026-10-18T08:00:00.000-08:00",
        "coverage": {
          "percentage": "100%",
          "limit": {
            "inclusive": {
              "billable_currency": { "value": "[amount]", "currency": "USD" }
            },
            "exclusive": {
              "billable_currency": { "value": "[amount]", "currency": "USD" }
            }
          }
        },
        "links": {
          "policy_wording": {
            "method": "GET",
            "href": "https://staging.vendor.com/pds/1ed50cef-49e1-4ff6-acc9-137ba784e472?policy_type=expedia_travel_insurance_v1"
          }
        }
      },
      "pricing": {
        "inclusive": {
          "billable_currency": { "value": "[amount]", "currency": "USD" }
        },
        "exclusive": {
          "billable_currency": { "value": "[amount]", "currency": "USD" }
        }
      }
    }
  }
]

참고: 검색 응답의 trip_protection가격에는 청구 가능한 통화만 반영됩니다. 요청 통화를 포함한 전체 내역은 원본 견적 응답을 참조하세요.

6단계: 예약 취소

요청에 대한 변경 사항이 없습니다.

이 전화는 표준 빠른 숙소 취소 전화입니다. CFAR을 구매한 경우, 예약을 취소하면 여행자를 대신하여 자동으로 환불 청구가 이루어집니다. 구현을 위해 추가 조치가 필요하지 않습니다.

환불은 전적으로 다음 기관에서 처리합니다. Expedia Group. 여행자는 표준 클레임 정산 절차를 통해 해당 환불금을 받게 됩니다.

API 세부 정보

이 페이지의 Trip Protection-related 엔드포인트 정의를 살펴본 다음 API Explorer 또는 다른 테스트 소프트웨어를 사용하여 예제와 스키마 정의가 실제 출력과 어떻게 비교되는지 파악하세요.

참고: 이 스키마 파일은 평가 목적으로만 제공됩니다. 변경 사항을 포함한 수정 및 보완이 이루어져야 정식 버전이 출시될 수 있습니다.