Las cuatro capacidades que importan
Sección titulada «Las cuatro capacidades que importan»| Capacidad | Qué significa | Por qué los productos se estancan sin ella |
|---|---|---|
| Tarifas y disponibilidad en tiempo real | Precios actuales y lo que realmente está reservable, por rango de fechas | Las tarifas en caché fallan en la confirmación y erosionan la confianza |
| Creación de reserva | Crear una reserva real que el hotel recibe | Sin esto sos un enlace de referencia, no un producto |
| Pago | Recibir dinero como parte de la reserva | Un redireccionamiento a otro sitio es donde muere la conversión |
| Confirmación y webhooks | Informar al huésped, hotel y tu sistema qué pasó | Soporta la carga y evita brechas en la conciliación |
La mayoría de los “APIs de hotel” que un desarrollador encuentra cubren lo primero y a veces lo segundo. 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 integrás?
Sección titulada «¿De quién es la oferta que integrás?»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 contra 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.
Quién es el merchant of record
Sección titulada «Quién es el merchant of record»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 el pago, y esa vía tiene sus propios requisitos de licencia.
Tres niveles de integración
Sección titulada «Tres niveles de integración»- Web components. Insertá una búsqueda reservable, lista de habitaciones o checkout en una página existente. Sin trabajo backend; menos control sobre el diseño.
- REST API. Control total sobre búsqueda, tarifas, creación de reserva y confirmación, autenticado con OAuth2. Usalo cuando el flujo de reserva sea parte de la experiencia propia de tu producto.
- 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.
Qué construir primero
Sección titulada «Qué construir primero»- Buscar y cotizar para una ciudad y un rango de fechas. Conseguí tarifas reales antes de diseñar nada.
- Crear una reserva de prueba completa, incluyendo pago y confirmación.
- Suscribirse a
booking.createy a los eventos de cancelación antes de construir cualquier UI encima. - Decidir tu modelo de atribución temprano — el contexto de la fuente debe viajar con la reserva, o tu reporte será una suposición después.
- Manejar los casos de falla: 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 de procesamiento de tarjeta, 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.
Errores comunes
Sección titulada «Errores comunes»- Construir sobre tarifas en caché. Se ven bien en desarrollo y fallan en producción.
- Dejar el pago a un redireccionamiento. Cada derivación 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 licencias y responsabilidad, no solo técnica.
- No pasar el contexto de la fuente. La atribución no puede reconstruirse después.