Cancelar por qualquer motivo

Ofereça aos viajantes a flexibilidade de cancelar uma reserva no hotel non-refundable e receber o reembolso integral do valor da diária.

Visão geral

A API Trip Protection é uma nova funcionalidade opcional para quem já possui integração com a API Rapid Lodging. Isso permite que reservas de hospedagem elegíveis sejam oferecidas com um upgrade de cancelamento por qualquer motivo (CFAR), dando aos viajantes a flexibilidade de cancelar uma reserva non-refundable e receber um reembolso total do preço pago pelo hotel.

O que é CFAR?

Com a adição do CFAR, os viajantes podem cancelar reservas de hospedagem no non-refundable antes do check-in e receber um reembolso total do hotel. A CFAR é um serviço de viagens — não um seguro de viagem tradicional — e não exige justificativa ou processo de sinistro; os viajantes podem cancelar por qualquer motivo sem necessidade de documentação adicional.

O CFAR ajuda você a:

Aumente a conversão do estoque lower-priced non-refundable
Dê aos viajantes confiança ao reservar tarifas non-refundable
Reduzir o atrito em torno do cancelamento
Proporcione flexibilidade sem introduzir o processamento manual de sinistros.

Exemplo de exibição do site ao vivo do CFAR

Ilustração da interface do usuário do CFAR

Observação: Este exemplo é fornecido apenas para fins ilustrativos.

Requisitos de lançamento

Antes de integrar a API Trip Protection, você já deve estar utilizando a API Rapid Lodging (endpoints de Disponibilidade/Compra, Verificação de Preços e Reserva). O mecanismo de autenticação será através de Autenticação de Assinatura, como na API Rapid Lodging.

Entre em contato com seu gerente de contas para adicionar esse escopo às suas credenciais.

Como funciona

A integração do CFAR causa o mínimo de transtornos. Não são necessárias alterações nas suas solicitações de hospedagem rápida existentes para Disponibilidade/Pesquisa, Reserva e Cancelamento (Etapas 1, 4 e 6). O novo comportamento é aditivo, portanto, se você não aproveitar a oferta CFAR, não verá nenhuma alteração na sua integração.

CFAR com alojamento rápido

Passo 1: Pesquise preços de hospedagem

Nenhuma alteração necessária.

Esta é a chamada padrão para verificação rápida de disponibilidade de hospedagem/busca de acomodações. Não são necessárias modificações no tratamento da solicitação ou da resposta.

Etapa 2: Chame a API de verificação de preços.

Esta é a ligação padrão da Rapid Lodging para verificação de preços. Não são necessárias alterações ao pedido.

Quando uma tarifa for elegível para CFAR, a resposta da Verificação de Preço incluirá um link add_trip_protectionao lado do link bookexistente no objeto links. Você deve usar este link para oferecer ao viajante a opção CFAR.

Exemplo: Resposta de verificação de preço linksobjeto (taxa CFAR-eligible)

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

Nota: O link add_trip_protectionsó estará presente quando a taxa for elegível para CFAR. Caso o link esteja ausente, o CFAR não estará disponível para essa taxa.

Passo 3: Obtenha uma cotação de Seguro Viagem

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

Esta etapa é opcional e recupera uma cotação CFAR completa para a taxa selecionada. Use o hrefdo link add_trip_protectionretornado na Etapa 2 como URL da solicitação.

A resposta contém:

Detalhes do produto: nome do produto, tipo, provedor e número de registro Merchant
Detalhes da apólice: datas de cobertura, percentual e limite de cobertura, texto de marketing (título, visão geral, benefícios), isenção de responsabilidade e um link para o documento com o texto da apólice.
Preços: o preço CFAR () e os totais combinados de hospedagem + proteção (trip_protection_price), cada um expresso nas moedas faturáveis e de solicitação (incluindo e excluindo impostos/taxas)totals
Penalidades por cancelamento: penalidades que se aplicam ao próprio produto de proteção em caso de cancelamento.
Link para reserva: o parâmetro links.booké usado na Etapa 4 para reservar com a CFAR

Cabeçalhos obrigatórios

Cabeçalho	Obrigatório	Observações
`Accept`	Sim	Deve ser application/json
`Accept-Encoding`	Sim	Deve ser compactado em gzip
`Customer-Ip`	Sim	Endereço IPv4 de End-traveler (não o do seu servidor)
`User-Agent`	Sim	user-agent do cliente ou `{app-name}/{app-version}`
`Customer-Session-Id`	Não	Único por sessão de usuário; re-use entre chamadas na mesma sessão.
`Test`	Não	Para testes em sandbox: `standard`, `service_unavailable`,`unknown_internal_error`

Exemplo: Citar resposta

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

Etapa 4: API de Reserva de Chamadas

Nenhuma alteração foi feita na carga útil da solicitação.

Esta é a chamada padrão de reserva rápida de hospedagem (POST /v3/itineraries). O link de reserva a ser usado depende se o viajante optou por participar do CFAR.

Escolha do viajante	Link para reserva
Com CFAR	`links.book` Da resposta da citação da Etapa 3
Sem CFAR	`links.book` Da resposta da Etapa 2 - Verificação de Preços

Nenhum campo novo foi adicionado à solicitação ou resposta de reserva. O CFAR é ativado exclusivamente pelo token utilizado no link de reserva.

Nota: O token links.bookda resposta da cotação expira (consulte o campo expires). Certifique-se de que a reserva seja enviada antes do vencimento do token.

Etapa 5: Recuperar reserva

Nenhuma alteração na solicitação.

Esta é a chamada padrão da Rapid Lodging.GET /v3/itineraries/{itinerary_id}

Quando o CFAR for adquirido, a resposta do Itinerário incluirá um objeto adicional trip_protectioncontendo os detalhes da política e dos preços do produto adquirido. Se você não adquiriu o CFAR, não verá nenhuma alteração na resposta do itinerário.

Além disso, quando o CFAR está ativo, ocancel_penalties erefundable campos norate O item no itinerário refletirá a política CFAR em vez da política de cancelamento da tarifa base.

Exemplo: Resposta do itinerário mostrando otrip_protection objeto

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

Observação: Otrip_protection Os preços exibidos na resposta da solicitação refletem apenas a moeda de faturamento. Para obter a discriminação completa, incluindo a moeda solicitada, consulte a resposta da cotação original.

Passo 6: Cancelar Reserva

Nenhuma alteração na solicitação.

Esta é a ligação padrão de cancelamento da Rapid Lodging. Quando o CFAR for adquirido, o cancelamento da reserva acionará automaticamente uma solicitação de reembolso em nome do viajante. Nenhuma ação adicional é necessária para a implementação.

Os reembolsos são processados integralmente por Expedia Group. O viajante receberá o reembolso aplicável por meio do processo padrão de liquidação de reclamações.

Detalhes da API

Explore as configurações de endpoint da viagem Protection-related nesta página e, em seguida, use o API Explorer ou outro software de teste para entender como os exemplos e as configurações de esquema se comparam à saída real.

Observação: Este arquivo de esquema é fornecido apenas para fins de avaliação. É provável que ocorram alterações e melhorias, incluindo alterações que quebrem a compatibilidade, antes que esta versão seja disponibilizada ao público em geral.