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.

Contate 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": "2027-10-13T15:59:00.000+01:00",
    "end_date": "2027-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.