Cancelación por cualquier motivo

Ofrece a los viajeros la flexibilidad de cancelar una reserva en non-refundable y recibir un reembolso del precio total del 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 CFAR?

Con la incorporación de CFAR, los viajeros pueden cancelar las 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 papeleo adicional.

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 de forma manual

Ejemplo de visualización CFAR

Ten en cuenta que este ejemplo solo sirve a modo 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, comparación de precios y reserva). 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 es necesario realizar ningún cambio en los datos de tus solicitudes actuales de Rapid Lodging para 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 realizada.

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 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 el 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 cambio seleccionado. Utiliza el enlace « href » que aparece en el enlace add_trip_protection que has obtenido en el paso 2 como URL de solicitud.

La respuesta incluye el nombre del producto, además de:

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 moneda de solicitud (con e sin impuestos/tasas)
Cancelación de 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 para 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": "2026-09-28T13:23:37Z",
    "end": "2026-10-08T08: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 data-block-key=\"vkgdz\">By purchasing, I agree to all Cancel For Any Reason <a href=\"https://example.com" rel=\"noopener noreferrer\" target=\"_blank\">Terms and Conditions</a>.</p>",
    "links": {
      "terms_and_conditions": {
        "method": "GET",
        "href": "https://example.com
      }
    }
  },
  "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": "2026-10-07T22:59:59Z",
  "cancel_penalties": [
    {
      "start": "2026-09-28T13:23:37Z",
      "end": "2026-10-08T07:00:00Z",
      "currency": "USD",
      "amount": "709.72",
      "percent": "100%"
    }
  ],
  "links": {
    "book_with_trip_protection": {
      "method": "POST",
      "href": "/v3/itineraries?token=QldfCGlcUA4FVFBbDQ4JUwpDRwdWXBBLDwheZkFdBwVQU19RA1tUUBlXDQcGSwcHCwEYBl0NVUwFDgdVCwJSAlZSVAsQXlVHVApVC0BrDlBnQ1BWWxYBD3w9YHNxcSceQgVCVmgIV14KDFZTAg4EWApARgxFUmJmJ7IHpnIxJTSCpoNH5DNVUnOHclNCdQcFh9LWFfWwpzN1BkIDpMASo1ZkZWPg0nUUZTMicjCCA0Ml0vN0APLiZ0ZXByCXtwdmISVyVHB3IWJlAAVglDTA8EVV8KDgMDWg9UBQ=="
    }
  }
}

Paso 4: Llama a la API de reservas

Si el viajero acepta el presupuesto de CFAR para una reserva que cumpla los requisitos, 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 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 al cabo de unas 2 horas (mira el campo « expires_at »). Si el token caduca, deberías volver a enviar la solicitud.

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 que contenga 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": "2025-10-13T15:59:00.000Z",
      "end": "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",
        }
      }
    },
    "pricing": {
      "inclusive": {
        "billable_currency": {
          "value": "702.00",
          "currency": "USD"
        }
      },
      "exclusive": {
        "billable_currency": {
          "value": "702.00",
          "currency": "USD"
        }
      }
    }
  }
}

Nota: Los precios de « trip_protection » que aparecen en la respuesta de «Retrieve» solo indican la moneda de facturación. 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 el 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 esquemas 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.