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, 64+ webhooks, atribuição e transferência para IA — com um servidor MCP hospedado para que agentes leiam os contratos ao vivo, e Booking Engine executando por trás.

REST + OAuth2 + SDKs Servidor MCP hospedado 64+ eventos 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.created fulfill & reconcile

O que os desenvolvedores podem construir com o Wink?

Desenvolvedores podem construir busca de hotéis, reserva, pagamento, webhook, atribuição, relatórios, transferência para IA e fluxos de comércio incorporados em produtos aprovados. 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 é ideal para 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.

Channel manager / 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 gerencia checkout, pagamento e confirmação
  • Atribuição preservada por 6 meses por clique
  • Assine 64+ eventos webhook
  • Transferência estruturada para IA via MCP + Agentic AI
  • 5,5% all-in — Booking Engine em toda transferência

O modelo

Um caminho de integração do início à execução.

  1. 1

    Conectar

    Adicione o servidor MCP hospedado ou solicite acesso à API com OAuth2 para começar com contratos ao vivo.

  2. 2

    Ler contratos ao vivo

    Busque operações e leia os esquemas atuais de requisição e resposta — sem adivinhaçõ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 64+ eventos 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 streamable (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 Skills de IA.

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

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

Um motor, toda integração

Seja qual for a forma que seu produto envie 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 plug-and-play.

Seção intitulada “De uma construção completa de API a um componente plug-and-play.”

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 SDKs
  • Ou Web Components reserváveis — cartões, mapas e grades
  • 64+ eventos webhook para conciliação em tempo real
  • Execução pelo Booking Engine em toda superfície
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, quando aprovados, 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 e solicite acesso à API quando o caso de uso do produto, escopo técnico e rota comercial estiverem claros.
O acesso para desenvolvedores é aberto a todos?
O acesso para desenvolvedores deve ser controlado. Documentação pública e o servidor MCP podem suportar avaliação, mas credenciais de API e uso em produção devem corresponder ao produto aprovado e ao contexto comercial.

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 e solicite acesso quando seu produto estiver pronto para conectar demanda hoteleira aprovada à execução pelo Booking Engine.