As quatro capacidades que importam
Seção intitulada “As quatro capacidades que importam”| Capacidade | O que significa | Por que produtos travam sem ela |
|---|---|---|
| Tarifas e disponibilidade ao vivo | 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 isso você é um link de indicação, 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 seu sistema sobre o que aconteceu | Suporta carga e evita lacunas de conciliação |
A maioria das “APIs de hotel” que um desenvolvedor encontra cobre a primeira e às vezes a segunda. A transação é a parte difícil, e é ela que decide se você tem um produto.
De quem é a oferta que você está integrando?
Seção intitulada “De quem é a oferta que você está integrando?”Essa pergunta define tudo o que vem depois. Oferta revendida por uma cadeia chega com um markup embutido na tarifa, disponibilidade mais desatualizada e sem rota de volta ao hotel para dúvidas sobre a reserva. Oferta que vem diretamente do hotel traz a tarifa do próprio hotel, disponibilidade ao vivo e um hotel que sabe que a reserva existe.
Para qualquer coisa onde o viajante vai comparar com o site do próprio hotel — que é a maioria dos casos — a oferta controlada pelo hotel evita o momento constrangedor quando seu preço é pior.
Quem é o comerciante registrado
Seção intitulada “Quem é o comerciante registrado”Se você construir a reserva de hotel por conta própria, tornar-se o comerciante registrado significa assumir responsabilidade pelo pagamento, estornos, reembolsos, tratamento de impostos e muitas vezes uma licença de agência de viagens em cada mercado.
Na Wink, o hotel permanece como comerciante registrado e o pagamento é coletado para o hotel, então o integrador não herda essa responsabilidade. Arranjos de comerciante registrado estão disponíveis em integrações API onde um parceiro realmente precisa receber o pagamento, e essa via tem 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 busca reservável, lista de quartos ou checkout em uma página existente. Sem trabalho backend; menor controle sobre o layout.
- REST API. Controle total sobre busca, 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 buscar, precificar e completar uma reserva em vez de encaminhar o usuário 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 seu fluxo principal.
O que construir primeiro
Seção intitulada “O que construir primeiro”- Buscar e precificar para uma cidade e um intervalo de datas. Obtenha tarifas reais antes de projetar qualquer coisa.
- Crie uma reserva de teste completa, incluindo pagamento e confirmação.
- Assine
booking.createde os eventos de cancelamento antes de construir qualquer interface. - Decida seu modelo de atribuição cedo — o contexto da fonte precisa acompanhar a reserva, ou seu relatório será suposição depois.
- Trate os casos de falha: disponibilidade perdida entre cotação e reserva, pagamento recusado, reembolsos parciais.
Preços que um desenvolvedor deve conhecer
Seção intitulada “Preços que um desenvolvedor deve conhecer”As APIs Consumer e Booking Engine são gratuitas. A Partner API inclui uma cota mensal gratuita de 10.000 noites de hotel, depois cobra por unidade. Reservas confirmadas carregam a taxa de plataforma do hotel de 1,5% mais o custo do processamento do cartão, e uma comissão padrão de 10% se aplica quando seu produto gerou a reserva — que é como um integrador ganha em vez de pagar.
Erros comuns
Seção intitulada “Erros comuns”- Construir sobre tarifas em cache. Elas parecem boas no desenvolvimento e falham na produção.
- Deixar o pagamento para um redirecionamento. Cada repasse perde reservas.
- Ignorar webhooks até o lançamento. A conciliação vira trabalho manual.
- Tornar-se comerciante registrado 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.