Cancelar por cualquier motivo

Ofrece a los viajeros la flexibilidad de anular una reserva en non-refundable y recibir un reembolso por el precio total del hotel

Información general

La API de Protección de Viajes es una nueva función opcional para quienes ya se hayan integrado con la API de Alojamiento Rápido. Permite que las reservas de alojamiento elegibles se ofrezcan con una mejora de cancelación por cualquier motivo (CFAR), dando a los viajeros la flexibilidad de cancelar una reserva de non-refundable y recibir un reembolso completo del precio pagado por el hotel.

¿Qué es la CFAR?

Con la incorporación del CFAR, los viajeros pueden anular las reservas de alojamiento de non-refundable antes de registrarse y recibir el reembolso íntegro del hotel. La CFAR es un servicio de viaje -no un seguro de viaje tradicional- y no requiere ningún motivo de cualificación ni proceso de reclamación; los viajeros pueden cancelarla por cualquier motivo sin papeleo adicional.

La CFAR te ayuda:

Aumenta la conversión en el inventario de lower-priced non-refundable
Da confianza a los viajeros al reservar tarifas non-refundable
Reducir la fricción en torno a la cancelación
Proporcionar flexibilidad sin introducir la gestión manual de las reclamaciones

Ejemplo de visualización del sitio CFAR en directo

Nota: Esta muestra se proporciona sólo con fines ilustrativos.

Requisitos de lanzamiento

Antes de integrar la API de Protección de Viajes, ya debes estar activo en la API de Alojamiento Rápido (puntos finales de Disponibilidad/Compra, Comprobación de precios y Reserva). El mecanismo de autenticación será a través de Autenticación de Firma como en la API de Alojamiento Rápido.

Ponte en contacto con el gestor de tu cuenta para que añada este ámbito a tus credenciales.

Funcionamiento

La integración del CFAR es mínimamente perturbadora. No es necesario realizar cambios en las cargas útiles de las solicitudes de Rapid Lodging existentes para Disponibilidad/Compra, Reserva y Cancelación (Pasos 1, 4 y 6). El nuevo comportamiento es aditivo, por lo que si no actúas sobre la oferta CFAR, no verás ningún cambio en tu integración.

CFAR con Alojamiento Rápido

Paso 1: Buscar tarifas de alojamiento

No se requieren cambios.

Esta es la llamada estándar de disponibilidad de alojamiento/compra rápida. No es necesario modificar el tratamiento de las solicitudes ni de las respuestas.

Paso 2: Llamar a la API de comprobación de precios

Esta es la llamada estándar de comprobación de precios de Rapid Lodging. No es necesario modificar la solicitud.

Cuando una tarifa sea apta para CFAR, la respuesta de Comprobación de precios incluirá un enlace add_trip_protectionjunto al enlace bookexistente en el objeto links. Debes utilizar este enlace para ofrecer al viajero la opción CFAR.

Ejemplo: Respuesta de comprobación de precios 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"
    }
  }
}

Nota: El enlace add_trip_protectionsólo estará presente cuando la tasa sea elegible para CFAR. Si el enlace está ausente, el CFAR no está disponible para esa tarifa.

Paso 3: Consigue un presupuesto de Protección de Viaje

Punto final: GET /v1/trip-protection/quote?token={token}

Este es un paso opcional que recupera una cotización CFAR completa para la tarifa seleccionada. Utiliza el hrefdel enlace add_trip_protectiondevuelto en el Paso 2 como URL de la solicitud.

La respuesta contiene:

Detalles del producto: nombre del producto, tipo, proveedor y Merchant de registro
Detalles de la póliza: fechas de cobertura, porcentaje y límite de cobertura, texto de marketing (titular, resumen, prestaciones), descargo de responsabilidad y un enlace al documento de redacción de la póliza
Precios: el precio CFAR (trip_protection_price) y los totales combinados de alojamiento + protección (totals), cada uno expresado tanto en moneda facturable como en moneda de solicitud (impuestos/tasas incluidos y excluidos).
Penalizaciones por cancelación: penalizaciones que se aplican al propio producto de protección si se cancela
Enlace de reserva: el parámetro links.bookse utiliza en el Paso 4 para reservar con CFAR

Encabezados obligatorios

Encabezado	Campo obligatorio	Notas
`Accept`	Sí	Debe ser application/json
`Accept-Encoding`	Sí	Debe ser gzip
`Customer-Ip`	Sí	End-traveler's Dirección IPv4 (no la de tu servidor)
`User-Agent`	Sí	user-agent del cliente o `{app-name}/{app-version}`
`Customer-Session-Id`	No	Único por sesión de usuario; re-use a través de llamadas en la misma sesión
`Test`	No	Para pruebas en sandbox: `standard`, `service_unavailable`, `unknown_internal_error`

Ejemplo: Respuesta de presupuesto

{
  "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"
    }
  }
}

Paso 4: Llamar a la API de reservas

No hay cambios en la carga útil de la solicitud.

Esta es la llamada estándar de Reserva Rápida de Alojamiento (POST /v3/itineraries). El enlace de reserva a utilizar depende de si el viajero ha optado por la CFAR.

Elección del viajero	Enlace de reserva
Con la CFAR	`links.book` De la respuesta a la cita del Paso 3
Sin CFAR	`links.book` De la respuesta de la Comprobación de precios del Paso 2

No se añaden nuevos campos a la solicitud de reserva ni a la respuesta. El CFAR se activa únicamente por el token que se utiliza en el enlace de reserva.

Nota: El token links.bookde la respuesta de presupuesto caduca (consulta el campo expires). Asegúrate de que la reserva se envía antes de que caduque el token.

Paso 5: Recuperar la reserva

No hay cambios en la solicitud.

Ésta es la llamada estándar de Rapid Lodging GET /v3/itineraries/{itinerary_id}.

Cuando se haya comprado CFAR, la respuesta del Itinerario incluirá un objeto adicional trip_protectionque contendrá los detalles de la política y el precio del producto comprado. Si no compraste CFAR, no verás ningún cambio en la respuesta Itinerario.

Además, cuando la CFAR está activa, los campos cancel_penaltiesy refundabledel objeto ratedel itinerario reflejarán la política CFAR en lugar de la política de cancelación de la tarifa base.

Ejemplo: Respuesta de itinerario mostrando el objeto 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" }
        }
      }
    }
  }
]

Nota: El precio de trip_protectionen la respuesta Recuperar refleja sólo la moneda facturable. Para ver el desglose completo, incluida la moneda de la solicitud, consulta la respuesta al presupuesto original.

Paso 6: Cancelar la reserva

No hay cambios en la solicitud.

Esta es la llamada de cancelación estándar de Rapid Lodging. Cuando se haya comprado CFAR, la cancelación de la reserva activará automáticamente una solicitud de reembolso en nombre del viajero. No se requiere ninguna acción adicional para su aplicación.

Las devoluciones se tramitan íntegramente por Expedia Group. El viajero recibirá el reembolso correspondiente a través del proceso estándar de liquidación de reclamaciones.

Detalles de la API

Explora las definiciones de los puntos finales de Trip Protection-related en esta página y, a continuación, utiliza API Explorer u otro programa de pruebas para saber cómo se comparan los ejemplos y las definiciones de los esquemas con la salida real.

Nota: Este archivo de esquema se proporciona sólo con fines de evaluación. Es probable que se introduzcan cambios y mejoras, incluidos cambios de última hora, antes de que esté disponible para todo el mundo.