Ir al contenido
Para desarrolladores

Comercio hotelero API-first: búsqueda, reservación, pago, más de 64 webhooks, atribución y transferencia con IA — con un servidor MCP alojado para que los agentes lean los contratos en vivo, y Booking Engine cumpliendo debajo.

REST + OAuth2 + SDKs Servidor MCP alojado Más de 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

¿Qué pueden construir los desarrolladores con Wink?

Los desarrolladores pueden construir flujos de trabajo de búsqueda hotelera, reservación, pago, webhook, atribución, informes, transferencia con IA y comercio embebido en productos aprobados. El acceso para desarrolladores de Wink funciona con la oferta controlada por hoteles desde Extranet, el contexto de socios de la red subyacente, transferencia con IA a través de Agentic AI y cumplimiento con Booking Engine para checkout, pago, confirmación y finalización de reservaciones específicas de hoteles.

Para quién es

Para equipos que construyen comercio hotelero, no solo leen documentación.

Sección titulada «Para equipos que construyen comercio hotelero, no solo leen documentación.»

El acceso para desarrolladores es ideal para equipos de producto, ingeniería, IA, plataforma y operaciones. ¿Evaluando una integración para un producto de IA, banco o superapp? Consulta Para plataformas y IA.

Equipos de producto

Agrega comercio hotelero a una app o plataforma existente mediante acceso para desarrolladores + Booking Engine.

Equipos de producto de IA

Dirige la intención hotelera guiada por asistentes hacia flujos de reservación controlados con Agentic AI y el servidor MCP.

Agencias y DMCs

Construye escaparates personalizados, flujos de reservación o productos de itinerarios con Web Components.

Channel manager / PMS

Coordina disponibilidad, tarifas, reservaciones y flujos de eventos relacionados.

Por qué construir sobre esto

Una tarjeta de hotel es fácil. Un sistema de reservación hotelera no lo es.

Sección titulada «Una tarjeta de hotel es fácil. Un sistema de reservación hotelera no lo es.»

El comercio hotelero necesita reglas de oferta, disponibilidad, tarifas, ofertas, políticas, checkout, pago, confirmación, atribución e informes. Construye sobre esas capas en lugar de reconstruirlas.

  • Reconstruir reglas de oferta, tarifas y políticas
  • Conectar el checkout a datos específicos del hotel
  • Unir la atribución a través de sesiones
  • Gestionar pagos, reembolsos y conciliación
  • Controlar la IA para que no invente disponibilidad
  • Mantener todo actualizado conforme los hoteles cambian diariamente
  • Integra oferta aprobada por hoteles desde Extranet
  • Booking Engine maneja checkout, pago y confirmación
  • Atribución preservada por 6 meses por clic
  • Suscríbete a más de 64 eventos webhook
  • Transferencia estructurada con IA vía MCP + Agentic AI
  • 5.5% todo incluido — Booking Engine en cada transferencia

El modelo

Desde la primera llamada hasta la reservación confirmada.

Sección titulada «Desde la primera llamada hasta la reservación confirmada.»

Un camino de integración desde la conexión hasta el cumplimiento.

  1. 1

    Conectar

    Agrega el servidor MCP alojado o solicita acceso a la API con OAuth2 para comenzar con contratos en vivo.

  2. 2

    Leer contratos en vivo

    Busca operaciones y lee los esquemas actuales de solicitud y respuesta — sin adivinar, sin documentación obsoleta.

  3. 3

    Construir el flujo

    Conecta búsqueda, disponibilidad, reservación, pago e informes en tu producto.

  4. 4

    Suscribirse a eventos

    Reacciona a más de 64 eventos webhook: estado de reservación, pagos, reembolsos, cancelaciones y cambios de canal.

  5. 5

    Cumplir en Booking Engine

    Cada llamada se resuelve en Booking Engine para checkout, pago y confirmación específicos del hotel.

Para agentes de IA — comienza aquí

Conéctate, luego lee los contratos en vivo.

Sección titulada «Conéctate, luego lee los contratos en vivo.»

Un servidor MCP alojado permite que un agente descubra las APIs de Wink y construya una integración funcional sin adivinar los endpoints.

Endpoint HTTP transmitible (SSE fallback en /sse). Desde Claude Code:

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

También funciona con Codex, Cursor y VS Code — consulta la documentación MCP.

Dos herramientas resuelven la intención a operaciones reales y documentación conceptual:

  • api_searchencuentra la operación a llamar — ej. “consultar inventario”, “crear reservación”, “recibo de pago”
  • docs_searchencuentra conceptos — “autenticación”, “webhooks”, “atribución”

Cada resultado devuelve un URI wink:// — abre la operación, su esquema de solicitud/respuesta o su receta de tarea.

wink-api-builder usa el servidor MCP como fuente de verdad: api_search → contratos en vivo → autenticación → código verificado, y señala cualquier discrepancia con la API actual.

Funciona con Claude Code, Codex y Cursor — consulta las Habilidades de IA.

Crea la reservación vía API y Booking Engine la cumple — checkout, pago, confirmación y sincronización con el PMS o channel manager conectado, preservando el contexto de la fuente.

Suscríbete a booking.created y otros 63 eventos para reaccionar en tiempo real.

Un motor, todas las integraciones

Todas las integraciones convergen en Booking Engine.

Sección titulada «Todas las integraciones convergen en Booking Engine.»

Sin importar cómo tu producto envíe la demanda — API, agente, componente o enlace — la reservación se resuelve en un solo lugar que controlas.

  • REST API
  • MCP / agentes
  • Web Components
  • WinkLinks
  • Studio + red
  • Apps de socios

Booking Engine

checkout · payment · confirmation

Reservación confirmada

Pago recibido, huésped confirmado, atribución y contexto de fuente preservados.

La gama completa

Desde una construcción completa de API hasta un componente plug-and-play.

Sección titulada «Desde una construcción completa de API hasta un componente plug-and-play.»

Profundiza tanto como una integración completa REST + MCP — o, cuando eso es más de lo que el trabajo necesita, usa un Web Component de Studio: tarjetas de hotel, mapas, cuadrículas y módulos de reservación. De cualquier forma, Booking Engine cumple la reservación debajo.

  • API REST + OAuth2 completa, servidor MCP alojado y SDKs
  • O Web Components reservables — tarjetas, mapas y cuadrículas
  • Más de 64 eventos webhook para conciliación en tiempo real
  • Cumplimiento con Booking Engine debajo de cada superficie
Ver la documentación de Build on Wink
Un Web Component de tarjeta de hotel embebible de Wink

Preguntas frecuentes para desarrolladores

Lo que los equipos técnicos y de producto preguntan primero.

¿Existe una página de producto separada para el acceso a la API?
No. El acceso a la API se maneja a través de la página de Builders y la documentación de Build on Wink, no mediante una página de producto de marketing independiente.
¿El acceso a la API reemplaza a Booking Engine?
No. El acceso a la API enruta la demanda y la lógica de integración. Booking Engine sigue siendo la capa de cumplimiento para el checkout, pago, confirmación y finalización de reservaciones específicas de hoteles.
¿Pueden los asistentes de IA usar Wink?
Sí. Un servidor MCP alojado permite que los agentes de IA lean los contratos API en vivo para que puedan buscar la oferta hotelera en tiempo real, crear reservaciones y realizar pagos a través de Booking Engine — completando una reservación en un solo flujo, no solo redirigiendo al usuario a un sitio web. Cualquier hotel está listo para agentes una vez que su perfil está activo en Wink.
¿Puedo incrustar tarjetas de hotel o mapas sin una integración completa de API?
Sí. Studio puede crear Web Components como tarjetas de hotel, mapas, cuadrículas y otros activos incrustados cuando una ruta de menor esfuerzo es suficiente — Booking Engine cumple la reservación debajo.
¿Pueden los grupos hoteleros usar el acceso para desarrolladores?
Sí. Los grupos hoteleros y operadores técnicos pueden usar el acceso para desarrolladores cuando está aprobado para conectar la oferta, reservación e informes de Wink con sistemas internos.
¿Por dónde deben empezar los desarrolladores?
Conéctense al servidor MCP, lean la documentación de Build on Wink y luego soliciten acceso a la API cuando el caso de uso del producto, el alcance técnico y la ruta comercial estén claros.
¿El acceso para desarrolladores está abierto para todos?
El acceso para desarrolladores debe ser controlado. La documentación pública y el servidor MCP pueden apoyar la evaluación, pero las credenciales API y el uso en producción deben coincidir con el producto aprobado y el contexto comercial.

¿Listo para construir comercio hotelero en tu producto?

Sección titulada «¿Listo para construir comercio hotelero en tu producto?»

Conecta el servidor MCP, lee la documentación, elige la superficie de integración correcta y solicita acceso cuando tu producto esté listo para conectar demanda hotelera aprobada con el cumplimiento de Booking Engine.