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 cumprimento pelo Booking Engine.

REST + OAuth2 + SDKs Servidor MCP hospedado 70 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.create → fulfill & reconcile

O que os desenvolvedores podem construir com o 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 cumprimento 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 canais / PMS

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

Por que construir nele

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 pelo hotel via Extranet
  • Booking Engine gerencia checkout, pagamento e confirmação
  • Atribuição preservada por 6 meses por clique
  • Assine 70 eventos 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 do início ao cumprimento.

  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

    Operações de busca e leitura dos 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 webhook: status de reserva, pagamentos, reembolsos, cancelamentos e mudanças de canal.

  5. 5

    Cumprir 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 cumpre — checkout, pagamento, confirmação e sincronização da reserva com PMS ou gerenciador de canais 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
  • Gerenciador de links
  • Studio + rede
  • Apps parceiros

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 cumpre 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 webhook para conciliação em tempo real
  • Cumprimento 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 cumprimento 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 realiza o cumprimento da 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 ou 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 ao cumprimento pelo Booking Engine.