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 se puede reservar, 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 eres 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é ocurrió | Soporta la carga y evita brechas en la conciliación |
La mayoría de las “APIs de hotel” que un desarrollador encuentra cubren la primera y a veces la segunda. La transacción es la parte difícil, y es la que decide si tienes un producto.
¿De quién es la oferta que integras?
Sección titulada «¿De quién es la oferta que integras?»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 preguntas 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 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 comerciante registrado
Sección titulada «Quién es el comerciante registrado»Si construyes la reserva de hotel tú mismo, convertirte en comerciante registrado 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 permanece como comerciante registrado y el pago se cobra para el hotel, por lo que un integrador no hereda esa responsabilidad. Los acuerdos de comerciante registrado están disponibles en integraciones API donde un socio realmente necesita cobrar el pago, y esa vía conlleva sus propios requisitos de licencia.
Tres niveles de integración
Sección titulada «Tres niveles de integración»- Componentes web. Inserta una búsqueda reservable, lista de habitaciones o checkout en una página existente. Sin trabajo backend; menos control sobre el diseño.
- API REST. Control total sobre búsqueda, tarifas, creación de reserva y confirmación, autenticado con OAuth2. Úsalo 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 redirigir 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. Obtén 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 tus reportes serán conjeturas después.
- Manejar los casos de fallo: disponibilidad perdida entre cotización y reserva, pago rechazado, reembolsos parciales.
Precios que un desarrollador debe conocer
Sección titulada «Precios que un desarrollador debe conocer»Las APIs Consumer y Booking Engine son gratuitas. La API Partner incluye una asignación mensual gratuita de 10,000 noches-hotel, luego cobra 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 transferencia pierde reservas.
- Ignorar los webhooks hasta el lanzamiento. La conciliación se vuelve un trabajo manual.
- Convertirse en comerciante registrado 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.