Ir al contenido
Recursos

¿Cómo agregan los desarrolladores reservas de hotel a un producto?

Sección titulada «¿Cómo agregan los desarrolladores reservas de hotel a un producto?»

La búsqueda y las tarifas son la parte fácil. Un producto solo es útil cuando puede crear una reserva real, recibir el pago y comunicar al viajero y al hotel que se concretó.

Muchas APIs devuelven contenido hotelero. Mucho menos permiten completar la transacción.

La respuesta corta

Necesitás cuatro cosas: tarifas y disponibilidad en tiempo real, creación de reservas, pago y confirmación más webhooks. Las APIs de solo lectura terminan en lo primero. En Wink, las APIs Consumer y Booking Engine son gratuitas, la creación de reservas se realiza vía REST con OAuth2, hay 70 eventos webhook incluyendo booking.create, y el pago se cobra para el hotel — que sigue siendo el merchant of record — por lo que no tenés que convertirte en uno. Un servidor MCP expone las mismas capacidades para agentes de IA, y los web components cubren los casos donde querés un camino de reserva sin construir una UI.

CapacidadQué significaPor qué los productos se estancan sin ella
Tarifas y disponibilidad en tiempo realPrecios actuales y lo que realmente está reservable, por rango de fechasLas tarifas en caché fallan en la confirmación y erosionan la confianza
Creación de reservasCrear una reserva real que el hotel recibeSin esto sos un enlace de referencia, no un producto
PagoRecibir dinero como parte de la reservaUn redireccionamiento a otro sitio es donde muere la conversión
Confirmación y webhooksInformar al huésped, hotel y tu sistema qué pasóSoporta la carga y evita brechas en la conciliación

La mayoría de las “APIs de hotel” que encuentra un desarrollador cubren la primera y a veces la segunda. La transacción es la parte difícil, y es la que decide si tenés un producto.

¿De quién es la oferta que estás integrando?

Sección titulada «¿De quién es la oferta que estás integrando?»

Esta pregunta define todo lo que sigue. La oferta revendida a través de una cadena llega con un margen dentro de la tarifa, disponibilidad más obsoleta y sin ruta de regreso al hotel para consultas sobre la reserva. La oferta que viene directamente del hotel lleva la tarifa propia del hotel, disponibilidad en tiempo real y un hotel que sabe que la reserva existe.

Para cualquier cosa donde el viajero compare con el sitio web propio del hotel — que es la mayoría — la oferta controlada por el hotel evita el momento incómodo cuando tu precio es peor.

Si construís la reserva de hotel vos mismo, convertirte en merchant of record significa asumir la responsabilidad del pago, contracargos, reembolsos, manejo de impuestos y a menudo una licencia de agencia de viajes en cada mercado.

En Wink el hotel sigue siendo el merchant of record y el pago se cobra para el hotel, por lo que un integrador no hereda esa responsabilidad. Los acuerdos merchant of record están disponibles en integraciones API donde un socio realmente necesita cobrar directamente, y esa vía tiene sus propios requisitos de licencia.

  1. Web components. Insertá una búsqueda reservable, lista de habitaciones o checkout en una página existente. Sin trabajo backend; menor control sobre el diseño.
  2. REST API. Control total sobre búsqueda, tarifas, creación de reservas y confirmación, autenticado con OAuth2. Usalo cuando el flujo de reserva sea parte de la experiencia propia de tu producto.
  3. Servidor MCP. Las mismas capacidades expuestas para agentes de IA, para que un asistente pueda buscar, cotizar y completar una reserva en lugar de derivar al usuario a un sitio web.

Los tres no son excluyentes — un producto comúnmente usa componentes para una superficie de marketing y la API para su flujo principal.

  • Buscar y cotizar para una ciudad y un rango de fechas. Lográ que fluyan tarifas reales antes de diseñar nada.
  • Crear una reserva de prueba completa, incluyendo pago y confirmación.
  • Suscribirse a booking.create y a los eventos de cancelación antes de construir cualquier UI encima.
  • Decidir temprano tu modelo de atribución — el contexto de la fuente debe viajar con la reserva, o tu reporte será una suposición después.
  • Manejar los casos de fallo: disponibilidad perdida entre cotización y reserva, pago rechazado, reembolsos parciales.

Precios que un desarrollador debería conocer

Sección titulada «Precios que un desarrollador debería conocer»

Las APIs Consumer y Booking Engine son gratuitas. La Partner API incluye una franquicia mensual gratuita de 10.000 noches-hotel, luego factura por unidad. Las reservas confirmadas llevan la comisión de plataforma del hotel del 1,5% más el costo del procesamiento de tarjetas, y se aplica una comisión predeterminada del 10% cuando tu producto generó la reserva — que es cómo un integrador gana en lugar de pagar.

La franquicia gratuita es por integrador. Abrir múltiples cuentas para evadirla es abuso y resulta en una prohibición inmediata y permanente. Ver Uso y límites de la Partner API.

  • Construir sobre tarifas en caché. Se ven bien en desarrollo y fallan en producción.
  • Dejar el pago a un redireccionamiento. Cada transferencia pierde reservas.
  • Ignorar los webhooks hasta el lanzamiento. La conciliación se vuelve un trabajo manual.
  • Convertirse en merchant of record sin necesidad. Es una decisión de licencia y responsabilidad, no solo técnica.
  • No pasar el contexto de la fuente. La atribución no puede reconstruirse después.

Seguí explorando

Preguntas frecuentes sobre la API de reservas de hotel

Qué integrar, cuánto cuesta y quién asume la responsabilidad del pago.

¿Qué debe soportar una API de reservas de hotel?
Tarifas y disponibilidad en tiempo real, creación de reservas, pago y confirmación con webhooks. Las APIs de solo lectura cubren solo lo primero y no pueden completar una transacción.
¿La API de Wink es gratuita?
Las APIs Consumer y Booking Engine son gratuitas. La Partner API incluye 10.000 noches-hotel gratis por mes, luego factura por unidad.
¿Tengo que convertirme en merchant of record?
No. El hotel sigue siendo merchant of record y el pago se cobra para el hotel. Existen acuerdos merchant of record para integraciones API que realmente necesitan cobrar, con sus propios requisitos de licencia.
¿Pueden los agentes de IA reservar con las mismas capacidades?
Sí. Un servidor MCP expone búsqueda, cotización y reserva a agentes, para que un asistente pueda completar una reserva en lugar de derivar al usuario a un sitio web.
¿Cómo me pagan como integrador?
Se aplica una comisión predeterminada del 10% sobre las reservas que generó tu producto, calculada después de la comisión de plataforma del hotel y el procesamiento de tarjetas, con atribución que dura 6 meses por clic.
¿Necesito construir una UI?
No necesariamente. Los web components proveen búsqueda reservable, listas de habitaciones y checkout que se insertan en una página existente; la REST API está disponible cuando el flujo debe ser propio.

Construí un producto que realmente pueda reservar.

Sección titulada «Construí un producto que realmente pueda reservar.»

Oferta hotelera en vivo, creación de reservas vía REST, webhooks, un servidor MCP para agentes y pagos que no tenés que manejar.