As quatro capacidades que importam
Seção intitulada “As quatro capacidades que importam”| Capacidade | O que significa | Por que os produtos travam sem ela |
|---|---|---|
| Tarifas e disponibilidade em tempo real | Preços atuais e o que está realmente reservável, por intervalo de datas | Tarifas em cache falham na confirmação e minam a confiança |
| Criação de reserva | Criar uma reserva real que o hotel recebe | Sem isto é um link de referência, não um produto |
| Pagamento | Receber dinheiro como parte da reserva | Um redirecionamento para outro site é onde a conversão morre |
| Confirmação e webhooks | Informar o hóspede, hotel e o seu sistema do que aconteceu | Suportar 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.
De quem é a oferta que está a integrar?
Seção intitulada “De quem é a oferta que está a integrar?”Esta questão molda tudo o que vem a seguir. Oferta revendida através de uma cadeia chega com um acréscimo dentro da tarifa, disponibilidade mais desatualizada e sem caminho de volta 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 — a oferta controlada pelo hotel evita o momento embaraçoso em que o seu preço é pior.
Quem é o comerciante registado
Seção intitulada “Quem é o comerciante registado”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, por isso 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.
Três níveis de integração
Seção intitulada “Três níveis de integração”- Componentes web. Insira uma pesquisa reservável, lista de quartos ou checkout numa página existente. Sem trabalho backend; menor controlo sobre o layout.
- 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.
- 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 usa normalmente componentes para uma superfície de marketing e a API para o seu fluxo principal.
O que construir primeiro
Seção intitulada “O que construir primeiro”- 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.createe os eventos de cancelamento antes de construir qualquer interface. - Decidir o seu modelo de atribuição cedo — o contexto da fonte precisa acompanhar a reserva, ou o seu relatório será uma suposição depois.
- Lidar com os casos de falha: disponibilidade perdida entre cotação e reserva, pagamento recusado, reembolsos parciais.
Preços que um programador deve conhecer
Seção intitulada “Preços que um programador deve conhecer”As APIs Consumer e Booking Engine são gratuitas. A API Partner inclui uma franquia mensal gratuita de 10.000 noites de hotel, depois cobra por unidade. Reservas confirmadas têm 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.
Erros comuns
Seção intitulada “Erros comuns”- Construir com tarifas em cache. Parecem bem no desenvolvimento e falham em produção.
- Deixar o pagamento para um redirecionamento. Cada passagem 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 só técnica.
- Não passar o contexto da fonte. A atribuição não pode ser reconstruída depois.