Pular para o conteúdo
Recursos

Como é que os programadores adicionam reserva de hotéis a um produto?

Seção intitulada “Como é que os programadores adicionam reserva de hotéis a um produto?”

Pesquisa e tarifas são a parte fácil. Um produto só se torna útil quando pode criar uma reserva real, receber o pagamento e informar o viajante e o hotel que a reserva foi feita.

Muitas APIs devolvem conteúdo de hotéis. Muito menos permitem completar a transação.

A resposta curta

Precisa de quatro coisas: tarifas e disponibilidade em tempo real, criação de reserva, pagamento e confirmação mais webhooks. APIs de conteúdo só de leitura param na primeira. Na Wink as APIs Consumer e Booking Engine são gratuitas, a criação de reservas funciona via REST com OAuth2, existem 70 eventos webhook incluindo booking.create, e o pagamento é recolhido para o hotel — que permanece como comerciante registado — pelo que não precisa de se tornar um. Um servidor MCP expõe as mesmas capacidades para agentes de IA, e componentes web cobrem os casos em que quer um caminho de reserva sem construir uma interface.

CapacidadeO que significaPor que os produtos travam sem ela
Tarifas e disponibilidade em tempo realPreços atuais e o que está realmente reservável, por intervalo de datasTarifas em cache falham na confirmação e minam a confiança
Criação de reservaCriar uma reserva real que o hotel recebeSem isto é um link de referência, não um produto
PagamentoReceber dinheiro como parte da reservaUm redirecionamento para outro site é onde a conversão morre
Confirmação e webhooksInformar o hóspede, hotel e o seu sistema do que aconteceuSuportar carga e evitar lacunas de reconciliação

A maioria das “APIs de hotéis” que um programador encontra cobre a primeira e às vezes a segunda. A transação é a parte difícil, e é essa que decide se tem um produto.

Esta questão molda tudo o que vem a seguir. Oferta revendida através de uma cadeia chega com um acréscimo no preço, disponibilidade mais desatualizada e sem caminho de retorno ao hotel para questões sobre a reserva. Oferta que vem diretamente do hotel traz a tarifa do próprio hotel, disponibilidade em tempo real e um hotel que sabe que a reserva existe.

Para qualquer coisa onde o viajante vai comparar com o site próprio do hotel — que é a maioria dos casos — a oferta controlada pelo hotel evita o momento embaraçoso em que o seu preço é pior.

Se construir a reserva de hotéis você mesmo, tornar-se comerciante registado significa assumir responsabilidade pelo pagamento, estornos, reembolsos, gestão fiscal e muitas vezes uma licença de agência de viagens em cada mercado.

Na Wink o hotel permanece como comerciante registado e o pagamento é recolhido para o hotel, pelo que o integrador não herda essa responsabilidade. Acordos de comerciante registado estão disponíveis em integrações API onde um parceiro realmente precisa receber o pagamento, e esse caminho tem os seus próprios requisitos de licenciamento.

  1. Componentes web. Insira uma pesquisa reservável, lista de quartos ou checkout numa página existente. Sem trabalho backend; menor controlo sobre o layout.
  2. REST API. Controlo total sobre pesquisa, tarifas, criação de reserva e confirmação, autenticado com OAuth2. Use quando o fluxo de reserva faz parte da experiência do seu produto.
  3. Servidor MCP. As mesmas capacidades expostas para agentes de IA, para que um assistente possa pesquisar, precificar e completar uma reserva em vez de encaminhar o utilizador para um site.

Os três não são exclusivos — um produto normalmente usa componentes para uma superfície de marketing e a API para o seu fluxo principal.

  • Pesquisar e precificar para uma cidade e um intervalo de datas. Obtenha tarifas reais antes de desenhar qualquer coisa.
  • Criar uma reserva de teste completa, incluindo pagamento e confirmação.
  • Subscrever booking.create e os eventos de cancelamento antes de construir qualquer interface.
  • Decidir o seu modelo de atribuição cedo — o contexto da origem precisa acompanhar a reserva, ou o seu relatório será especulativo depois.
  • Tratar os casos de falha: disponibilidade perdida entre cotação e reserva, pagamento recusado, reembolsos parciais.

As APIs Consumer e Booking Engine são gratuitas. A Partner API inclui uma franquia mensal gratuita de 10.000 noites de hotel, depois cobra por unidade. Reservas confirmadas suportam a taxa de plataforma do hotel de 1,5% mais o custo do processamento do cartão, e aplica-se uma comissão padrão de 10% quando o seu produto gerou a reserva — que é como um integrador ganha em vez de pagar.

A franquia gratuita é por integrador. Abrir várias contas para contornar isto é abuso e resulta numa proibição imediata e permanente. Veja Uso e limites da Partner API.

  • Construir com tarifas em cache. Parecem bem no desenvolvimento e falham em produção.
  • Deixar o pagamento para um redirecionamento. Cada transferência perde reservas.
  • Ignorar webhooks até ao lançamento. A reconciliação torna-se um trabalho manual.
  • Tornar-se comerciante registado sem necessidade. É uma decisão de licenciamento e responsabilidade, não apenas técnica.
  • Não passar o contexto da origem. A atribuição não pode ser reconstruída depois.

Continue a explorar

Perguntas Frequentes sobre a API de Reserva de Hotéis

O que integrar, quanto custa e quem assume a responsabilidade do pagamento.

O que uma API de reserva de hotéis precisa suportar?
Tarifas e disponibilidade em tempo real, criação de reserva, pagamento e confirmação com webhooks. APIs de conteúdo só de leitura cobrem apenas o primeiro e não podem completar uma transação.
A API da Wink é gratuita?
As APIs Consumer e Booking Engine são gratuitas. A Partner API inclui 10.000 noites de hotel gratuitas por mês, depois cobra por unidade.
Tenho de me tornar o comerciante registado?
Não. O hotel permanece como comerciante registado e o pagamento é recolhido para o hotel. Existem acordos de comerciante registado para integrações API que realmente precisam receber o pagamento, com os seus próprios requisitos de licenciamento.
Os agentes de IA podem reservar através das mesmas capacidades?
Sim. Um servidor MCP expõe pesquisa, preços e reserva para agentes, para que um assistente possa completar uma reserva em vez de encaminhar o utilizador para um site.
Como sou pago como integrador?
Aplica-se uma comissão padrão de 10% nas reservas geradas pelo seu produto, calculada após a taxa de plataforma do hotel e o processamento do cartão, com atribuição válida por 6 meses por clique.
Preciso de construir uma interface?
Nem sempre. Componentes web fornecem pesquisa reservável, listas de quartos e checkout que se inserem numa página existente; a REST API está disponível quando o fluxo deve ser seu.

Oferta de hotéis em tempo real, criação de reservas via REST, webhooks, um servidor MCP para agentes e pagamento que não precisa de gerir.