Pular para o conteúdo
Para Desenvolvedores

Construa comércio hoteleiro dentro do seu produto.

Seção intitulada “Construa comércio hoteleiro dentro do seu produto.”

Comércio hoteleiro API-first: busca, reserva, pagamento, 70 webhooks, atribuição e transferência para IA — com servidor MCP hospedado para agentes lerem contratos ao vivo, e Booking Engine executando por trás.

REST + OAuth2 + SDKs Servidor MCP hospedado 70 eventos de webhook
wink · agent integration live

# 1 · connect an agent or coding client

$ claude mcp add wink

https://api.wink.travel/mcp --transport http

→ browser sign-in at iam.wink.travel

✓ connected · OAuth2 + PKCE · no client secret

# 2 · find the operation, read the live contract

api_search "create booking"

→ POST /bookings · wink://api/operation/createBooking

# 3 · create the booking, take payment

$ wink bookings create --rate rp_8421

201 · #WK-2X9F · paid via Wink

# 4 · react in real time

on booking.create → fulfill & reconcile

O que os desenvolvedores podem construir com Wink?

Desenvolvedores podem construir fluxos de busca, reserva, pagamento, webhook, atribuição, relatórios, transferência para IA e comércio incorporado em seus próprios produtos. O acesso para desenvolvedores Wink funciona com oferta controlada por hotéis via Extranet, contexto de parceiros da rede subjacente, transferência para IA via Agentic AI, e execução pelo Booking Engine para checkout, pagamento, confirmação e conclusão de reservas específicas de hotéis.

Para quem é

Para equipes construindo comércio hoteleiro, não apenas lendo docs.

Seção intitulada “Para equipes construindo comércio hoteleiro, não apenas lendo docs.”

O acesso para desenvolvedores atende equipes de produto, engenharia, IA, plataforma e operações. Avaliando uma integração para um produto de IA, banco ou super app? Veja Para Plataformas & IA.

Equipes de produto

Adicione comércio hoteleiro a um app ou plataforma existente via acesso para desenvolvedores + Booking Engine.

Equipes de produto de IA

Direcione intenção de hotel liderada por assistentes para fluxos de reserva controlados com Agentic AI e servidor MCP.

Agências & DMCs

Construa vitrines personalizadas, fluxos de reserva ou produtos de itinerário com Web Components.

Gerenciador de canal / PMS

Coordene disponibilidade, tarifas, reservas e fluxos de eventos relacionados.

Por que construir sobre ele

Um cartão de hotel é fácil. Um sistema de reservas de hotel não é.

Seção intitulada “Um cartão de hotel é fácil. Um sistema de reservas de hotel não é.”

Comércio hoteleiro precisa de regras de oferta, disponibilidade, tarifas, ofertas, políticas, checkout, pagamento, confirmação, atribuição e relatórios. Construa sobre essas camadas em vez de reconstruí-las.

  • Reconstruir regras de oferta, tarifa e política
  • Conectar checkout a dados específicos do hotel
  • Unir atribuição entre sessões
  • Gerenciar pagamentos, reembolsos e conciliação
  • Controlar IA para que não invente disponibilidade
  • Manter tudo conforme os hotéis mudam diariamente
  • Integre oferta aprovada por hotéis via Extranet
  • Booking Engine cuida do checkout, pagamento e confirmação
  • Atribuição preservada por 6 meses por clique
  • Assine 70 eventos de webhook
  • Transferência estruturada para IA via MCP + Agentic AI
  • 1,5% + custo de processamento — Booking Engine em cada transferência

O modelo

Um caminho de integração da conexão à execução.

  1. 1

    Conectar

    Adicione o servidor MCP hospedado ou crie credenciais OAuth2 para começar contra contratos ao vivo.

  2. 2

    Ler contratos ao vivo

    Busque operações e leia os esquemas atuais de requisição e resposta — sem suposições, sem documentação desatualizada.

  3. 3

    Construir o fluxo

    Conecte busca, disponibilidade, reserva, pagamento e relatórios ao seu produto.

  4. 4

    Assinar eventos

    Reaja a 70 eventos de webhook: status de reserva, pagamentos, reembolsos, cancelamentos e mudanças de canal.

  5. 5

    Executar no Booking Engine

    Cada chamada é resolvida no Booking Engine para checkout, pagamento e confirmação específicos do hotel.

Para agentes de IA — comece aqui

Um servidor MCP hospedado permite que um agente descubra as APIs do Wink e construa uma integração funcional sem adivinhar endpoints.

Endpoint HTTP transmitido (fallback SSE em /sse). Do Claude Code:

claude mcp add —transport http 
wink-docs https://docs.mcp.wink.travel/mcp

Também funciona com Codex, Cursor e VS Code — veja a documentação MCP.

Duas ferramentas resolvem intenção para operações reais e documentação conceitual:

  • api_searchencontre a operação para chamar — ex: “consultar inventário”, “criar reserva”, “recibo de pagamento”
  • docs_searchencontre conceitos — “autenticação”, “webhooks”, “atribuição”

Cada resultado retorna um URI wink:// — abra a operação, seu esquema de requisição/resposta, ou sua receita de tarefa.

wink-api-builder usa o servidor MCP como fonte da verdade: api_search → contratos ao vivo → autenticação → código verificado, e sinaliza qualquer divergência com a API atual.

Funciona com Claude Code, Codex e Cursor — veja AI Skills.

Crie a reserva via API e o Booking Engine a executa — checkout, pagamento, confirmação e sincronização da reserva com PMS ou gerenciador de canal conectado, com contexto de origem preservado.

Assine booking.create e outros 63 eventos para reagir em tempo real.

Um motor, toda integração

Seja qual for a forma como seu produto envia demanda — API, agente, componente ou link — a reserva é resolvida em um único lugar que você controla.

  • REST API
  • MCP / agentes
  • Web Components
  • WinkLinks
  • Studio + network
  • Partner apps

Booking Engine

checkout · payment · confirmation

Reserva confirmada

Pagamento realizado, hóspede confirmado, atribuição e contexto de origem preservados.

A gama completa

De uma construção completa de API a um componente drop-in.

Seção intitulada “De uma construção completa de API a um componente drop-in.”

Vá tão fundo quanto uma integração completa REST + MCP — ou, quando isso for mais do que o trabalho precisa, incorpore um Web Component do Studio: cartões de hotéis, mapas, grades e módulos de reserva. De qualquer forma, o Booking Engine executa a reserva por trás.

  • API REST + OAuth2 completa, servidor MCP hospedado e clientes gerados
  • Ou Web Components reserváveis — cartões, mapas e grades
  • 70 eventos de webhook para conciliação em tempo real
  • Execução pelo Booking Engine em todas as superfícies
Veja a documentação Build on Wink
Um Web Component de cartão de hotel incorporável do Wink

Perguntas frequentes para desenvolvedores

O que equipes técnicas e de produto perguntam primeiro.

Existe uma página de produto separada para acesso à API?
Não. O acesso à API é gerenciado pela página Builders e pela documentação Build on Wink, não por uma página de produto de marketing independente.
O acesso à API substitui o Booking Engine?
Não. O acesso à API direciona a demanda e a lógica de integração. O Booking Engine continua sendo a camada de execução para checkout, pagamento, confirmação e conclusão de reservas específicas de hotéis.
Assistentes de IA podem usar o Wink?
Sim. Um servidor MCP hospedado permite que agentes de IA leiam os contratos da API ao vivo para que possam buscar oferta hoteleira em tempo real, criar reservas e realizar pagamentos via Booking Engine — completando a reserva em um único fluxo, não apenas redirecionando o usuário para um site. Qualquer hotel está pronto para agentes assim que seu perfil estiver ativo no Wink.
Posso incorporar cartões de hotéis ou mapas sem uma integração completa da API?
Sim. O Studio pode criar Web Components como cartões de hotéis, mapas, grades e outros ativos incorporados quando uma rota de menor esforço for suficiente — o Booking Engine executa a reserva por trás.
Grupos hoteleiros podem usar o acesso para desenvolvedores?
Sim. Grupos hoteleiros e operadores técnicos podem usar o acesso para desenvolvedores para conectar a oferta, reserva e fluxos de relatórios do Wink com sistemas internos.
Por onde os desenvolvedores devem começar?
Conecte-se ao servidor MCP, leia a documentação Build on Wink, crie credenciais OAuth2 e comece a desenvolver em staging — sem pedido de acesso, sem espera. Quando estiver pronto, crie uma aplicação em produção e aponte seu código para as URLs de produção.
O acesso para desenvolvedores é aberto a todos?
Sim. A documentação e o servidor MCP são públicos, e qualquer desenvolvedor pode criar credenciais OAuth2 e começar a desenvolver em staging sem nos consultar. A migração para produção também não requer aprovação. Apenas gerenciadores de canais e agentes de viagem passam por certificação.

Pronto para construir comércio hoteleiro dentro do seu produto?

Seção intitulada “Pronto para construir comércio hoteleiro dentro do seu produto?”

Conecte o servidor MCP, leia a documentação, escolha a superfície de integração certa. Nada é restrito — comece quando seu produto estiver pronto para conectar demanda aprovada de hotéis à execução pelo Booking Engine.