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.

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 CFAR

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

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

Autenticação

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á por meio de autenticação por assinatura, como na API Rapid Lodging.

>> Leia sobre autenticação por assinatura

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

Ao usar a funcionalidade CFAR, os viajantes interagem principalmente de duas maneiras: a primeira é pesquisando ou reservando, e a segunda é gerenciando uma reserva existente.

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 e estiver disponível no momento da reserva, a resposta da Verificação de Preço incluirá um link add_trip_protection ao lado do link book no objeto links. Você deve usar este link para oferecer ao viajante a opção CFAR.

Objeto de links de resposta de verificação de preço de exemplo (taxa 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: O link add_trip_protection só estará presente quando a taxa estiver disponível e elegível para CFAR.

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 href do link add_trip_protection retornado 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 os termos 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_with_trip_protection é 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

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

Etapa 4: Chame a API de reservas

Se o viajante aceitar a cotação CFAR para uma reserva elegível, a reserva será feita com um link book_with_trip_protection que incorpora o contexto da cotação no token. Não são necessárias alterações no esquema de solicitação de livros.

O novo link será transmitido como parte da chamada padrão de Reserva Rápida de Alojamento (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_with_trip_protection` 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.book_with_trip_protection da 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 a reserva

Nenhuma alteração na solicitação.

Este é o serviço padrão de hospedagem rápida.GET /v3/itineraries/{itinerary_id} chamar.

Quando o CFAR for adquirido, a resposta do itinerário incluirá um adicional.trip_protection Objeto contendo as informações sobre a política e os 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

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

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 a reserva

Nenhuma alteração na solicitação.

Esta é a ligação padrão de cancelamento da Rapid Lodging. Caso o CFAR tenha sido adquirido para uma reserva, o cancelamento acionará automaticamente uma solicitação de reembolso em nome do viajante, sujeita aos termos de elegibilidade. Caso a tentativa de cancelamento seja feita fora do período de elegibilidade (por exemplo, antes das 8h da manhã do dia do evento check-in), nenhum reembolso será processado. 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.