Cancelación por cualquier motivo

Ofrece a los viajeros la flexibilidad de cancelar una reserva en non-refundable y recibir un reembolso del importe total de la estancia en el hotel

La API de Trip Protection es una nueva función opcional para quienes ya hayan integrado la API de Rapid Lodging. Permite ofrecer reservas de alojamiento que cumplan los requisitos con una mejora a la opción «cancelación por cualquier motivo» (CFAR), lo que da a los viajeros la flexibilidad de cancelar una reserva en non-refundable y recibir un reembolso completo del precio pagado por el hotel.

¿Qué es el CFAR?

Con la incorporación de CFAR, los viajeros pueden cancelar sus reservas de alojamiento en non-refundable antes de hacer el check-in y recibir un reembolso completo del hotel. CFAR es un servicio de viajes —no un seguro de viaje tradicional— y no exige ningún motivo específico ni ningún trámite de reclamación; los viajeros pueden cancelar por cualquier motivo sin necesidad de más papeleo.

CFAR te ayuda a:

Aumenta la conversión en el inventario de lower-priced non-refundable
Ofrece a los viajeros tranquilidad a la hora de reservar tarifas de « non-refundable »
Reducir los problemas relacionados con las cancelaciones
Ofrece flexibilidad sin tener que gestionar las reclamaciones manualmente

Ejemplo de visualización CFAR

Ilustración de la interfaz de usuario de CFAR

Ten en cuenta que este ejemplo se ofrece únicamente a título ilustrativo.

Autenticación

Antes de integrar la API de Trip Protection, ya tienes que tener en funcionamiento la API de Rapid Lodging (puntos finales de disponibilidad/búsqueda, comprobación de precios y reservas). El mecanismo de autenticación se hará mediante autenticación por firma, igual que en la API de Rapid Lodging.

>> Lee sobre la autenticación de firmas

Ponte en contacto con tu gestor de cuentas para que te añadan este ámbito a tus credenciales.

Funcionamiento

La integración de CFAR apenas causa molestias. No hace falta que modifiques los datos de tus solicitudes actuales de Rapid Lodging para las funciones de disponibilidad/búsqueda, reserva y cancelación (pasos 1, 4 y 6). El nuevo comportamiento es acumulativo, así que si no aceptas la oferta de CFAR, no notarás ningún cambio en tu integración.

CFAR con Rapid Lodging

Al usar la funcionalidad CFAR, hay dos formas principales en las que los viajeros interactuarán: la primera es buscar ofertas o hacer reservas, y la segunda es gestionar una reserva ya existente.

Paso 1: Busca precios de alojamiento

No hace falta cambiar nada.

Esta es la llamada habitual para consultar la disponibilidad y buscar alojamiento rápido. No hace falta hacer ningún cambio en la gestión de las solicitudes ni de las respuestas.

Paso 2: Llama a la API de Price Check

Esta es la llamada habitual de Rapid Lodging para consultar los precios. No hace falta cambiar nada en la solicitud.

Cuando una tarifa cumple los requisitos para CFAR y está disponible en el momento de la reserva, la respuesta de «Price Check» incluirá un enlace « add_trip_protection » junto al enlace « book » en el objeto « links ». Deberías usar este enlace para ofrecer al viajero la opción CFAR.

Ejemplo de objeto de enlaces de respuesta de «Price Check» (tarifa «CFAR-eligible »)

"links": {
  "book": {
    "method": "POST",
    "href": "/v3/itineraries?token=MY5S3j36cOcL",
    "expires": "2025-10-13T16:10:00.000+01:00"
  },
  "add_trip_protection": {
    "method": "GET",
    "href": "/v1/trip-protection/quote?token=MY5S3j36cOcLfLBZjPYQ1abhfc8CqmjmFVzkk7euvWaunE57LLeDgaxm516m",
    "expires": "2025-10-13T16:10:00.000+01:00"
  }
}

Nota: El enlace « add_trip_protection » solo aparecerá cuando la tarifa esté disponible y sea válida para CFAR.

Paso 3: Pide un presupuesto para el seguro de viaje

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

Este es un paso opcional que te permite obtener una cotización CFAR completa para el tipo de interés seleccionado. Usa el enlace « href » que aparece en el enlace add_trip_protection que has obtenido en el paso 2 como URL de la solicitud.

La respuesta incluye:

Detalles del producto: nombre del producto, tipo, proveedor y Merchant que figura en el registro
Detalles de la póliza: — fechas de cobertura, porcentaje y límite de cobertura, texto promocional (título, resumen, ventajas), aviso legal y un enlace al documento con las condiciones de la póliza
Precios: el precio de CFAR (trip_protection_price) y los totales combinados de alojamiento + protección (totals), todos ellos expresados tanto en la moneda de facturación como en la de la solicitud (con e sin impuestos/tasas)
Anular las penalizaciones: penalizaciones que se aplican al propio producto de protección en caso de cancelación
Enlace para reservar:. El parámetro « links.book_with_trip_protection » se utiliza en el paso 4 para reservar con CFAR.

Encabezados obligatorios

Encabezado	Campo obligatorio	Notas
`Accept`	Sí	Tiene que ser «application/json»
`Accept-Encoding`	Sí	Tiene que estar comprimido con 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 en todas las llamadas de la misma sesión
`Test`	No	Para pruebas en el entorno de pruebas: `standard`, `service_unavailable`, `unknown_internal_error`

Ejemplo: Respuesta a la solicitud de presupuesto de

{ 
  "policy": { 
    "start_date": "2026-08-28T10:40:49Z", 
    "end_date": "2026-08-30T08:00:00+01:00", 
    "coverage": { 
      "limit": { 
        "value": "709.72", 
        "currency": "USD", 
        "percent": "100%" 
      } 
    } 
  }, 
  "content": { 
    "product_name": "CFAR upgrade", 
    "headline": "Make your stay refundable", 
    "overview": "Get a refund on your accommodation with the Cancel For Any Reason (CFAR) upgrade.", 
    "benefits": [ 
      { 
        "title": "Get a 100% refund of your accommodation cost", 
        "description": null 
      }, 
      { 
        "title": "Cancel before 8:00am property time on the day of check-in", 
        "description": null 
      }, 
      { 
        "title": "No questions asked, no paperwork", 
        "description": null 
      } 
    ], 
    "disclaimer_html": "<p>By purchasing, I agree to all Cancel For Any Reason <a href=\"https://policy.example.com/pds/example\">Terms and Conditions</a>.</p>", 
    "links": { 
      "terms_and_conditions": { 
        "method": "GET", 
        "href": "https://policy.example.com/pds/example?policy_type=cfar_v1", 
        "expires": null 
      } 
    } 
  }, 
  "pricing": { 
    "trip_protection": { 
      "inclusive": { 
        "billable_currency": { 
          "value": "149.04", 
          "currency": "USD" 
        }, 
        "request_currency": { 
          "value": "149.04", 
          "currency": "USD" 
        } 
      }, 
      "exclusive": { 
        "billable_currency": { 
          "value": "149.04", 
          "currency": "USD" 
        }, 
        "request_currency": { 
          "value": "149.04", 
          "currency": "USD" 
        } 
      } 
    }, 
    "totals": { 
      "inclusive": { 
        "billable_currency": { 
          "value": "858.76", 
          "currency": "USD" 
        }, 
        "request_currency": { 
          "value": "858.76", 
          "currency": "USD" 
        } 
      }, 
      "exclusive": { 
        "billable_currency": { 
          "value": "858.76", 
          "currency": "USD" 
        }, 
        "request_currency": { 
          "value": "858.76", 
          "currency": "USD" 
        } 
      } 
    } 
  }, 
  "refundable": false, 
  "expires_at": "2026-08-29T22:59:59Z", 
  "cancel_penalties": [ 
    {
      "start": "2026-08-28T10:40:49Z", 
      "end": "2026-08-30T07:00:00Z", 
      "currency": "USD", 
      "amount": "709.72", 
      "percent": "100%" 
    } 
  ], 
  "links": { 
    "book_with_trip_protection": { 
      "method": "POST", 
      "href": "/v3/itineraries?token=QldfCGlcUA4", 
      "expires": null 
    } 
  } 
}

Paso 4: Llama a la API de reservas

Si el viajero acepta el presupuesto de CFAR para una reserva válida, la reserva se realizará a través de un enlace book_with_trip_protection que incluye el contexto del presupuesto en el token. No hace falta cambiar nada en el esquema de solicitud de libros.

El nuevo enlace se pasará como parte de la llamada estándar de Rapid Lodging Booking (POST /v3/itineraries). El enlace de reserva que hay que usar depende de si el viajero se ha inscrito en el CFAR.

La elección del viajero	Enlace de reserva que tienes que usar
Con CFAR	`links.book_with_trip_protection` De la respuesta a la cotización 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 ni a la solicitud de reserva ni a la respuesta. El CFAR se activa únicamente en función del token que se utilice en el enlace de reserva.

Nota: El token « links.book_with_trip_protection » de la respuesta del presupuesto caduca (mira el campo « expires »). Asegúrate de enviar la reserva antes de que caduque el token.

Paso 5: Consultar la reserva

No hay cambios en la solicitud.

Esta es la llamada habitual de Rapid Lodging GET /v3/itineraries/{itinerary_id}.

Cuando se adquiera CFAR, la respuesta del itinerario incluirá un objeto « trip_protection » adicional con los detalles de la póliza y el precio del producto adquirido. Si no has comprado CFAR, no verás ningún cambio en la respuesta del itinerario.

Además, cuando CFAR está activo, los campos « cancel_penalties » y « refundable » del objeto « rate » del itinerario reflejarán la política de CFAR en lugar de la política de cancelación de la tarifa base.

Ejemplo: Respuesta del itinerario en la que se muestra el objeto trip_protection

{ 
  "trip_protection": { 
    "product_name": "Cancel For Any Reason (100% Refund)", 
    "product_type": "hotel_cancel_for_any_reason", 
    "vendor": "[vendor]", 
    "merchant_of_record": "expedia", 
    "eligibility_status": "eligible", 
    "policy": { 
      "start_date": "2025-10-13T15:59:00.000Z", 
      "end_date": "2025-10-18T08:00:00.000-08:00", 
      "coverage": { 
        "percentage": "100%", 
        "limit": { 
          "inclusive": { 
            "billable_currency": { 
              "value": "702.00", 
              "currency": "USD" 
            } 
          }, 
          "exclusive": { 
            "billable_currency": { 
              "value": "702.00", 
              "currency": "USD" 
            } 
          } 
        } 
      }, 
      "links": { 
        "policy_wording": { 
          "method": "GET", 
          "href": "https://policy.example.com/pds/example?policy_type=cfar_v1", 
          "expires": null 
        } 
      } 
    }, 
    "pricing": { 
      "inclusive": { 
        "billable_currency": { 
          "value": "702.00", 
          "currency": "USD" 
        } 
      }, 
      "exclusive": { 
        "billable_currency": { 
          "value": "702.00", 
          "currency": "USD" 
        } 
      } 
    } 
  }, 
}

Nota: El precio de « trip_protection » que aparece en la respuesta de la consulta solo indica la moneda en la que se factura. 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 estándar de cancelación de Rapid Lodging. Si se ha contratado CFAR para una reserva, al cancelarla se activará automáticamente una solicitud de reembolso en nombre del viajero, siempre que se cumplan las condiciones de elegibilidad. Si intentas cancelar fuera del plazo establecido (por ejemplo, antes de las 8:00 de la mañana del día de check-in), ), no se tramitará ningún reembolso. No hace falta que hagas nada más para tu implementación.

Los reembolsos los gestiona íntegramente Expedia Group. El viajero recibirá el reembolso correspondiente a través del proceso habitual de tramitación de reclamaciones.

Detalles de la API

Echa un vistazo a las definiciones de los puntos finales de Trip Protection-related en esta página y, a continuación, usa API Explorer u otro software de pruebas para ver cómo se comparan los ejemplos y las definiciones de esquema con los resultados reales.

Nota: Este archivo de esquema se proporciona únicamente con fines de evaluación. Es probable que se produzcan cambios y mejoras, incluidos cambios que afecten a la compatibilidad, antes de que esto esté disponible para todo el mundo.