Cuándo sirve y cuándo no
Tu hotel opera en yaReserva —tu inventario, tus precios y tus políticas viven aquí— pero la pantalla de reservas de tu sitio es tuya. Esta API te deja vender contra ese inventario sin usar nuestro widget.
Credenciales
Paso 1: Crea la conexión
En «Motor de reservas propio» se crean la llave y el secreto, y opcionalmente los dominios autorizados y un tope por reserva.
Paso 2: Guarda el secreto de inmediato
Se muestra una sola vez, al crearlo y al rotarlo. Si se pierde, se rota y se cambia en tu servidor: no hay forma de volver a verlo.
Paso 3: Decide si es de servidor o de navegador
Sin dominios autorizados la llave es de servidor: una petición que llegue desde un navegador se rechaza aunque la firma sea correcta. Si tu motor corre en el navegador, declara sus dominios.
El flujo, en cuatro pasos
Paso 1: Disponibilidad
El huésped busca fechas y recibe habitaciones y tarifas. Que no haya nada libre no es un error: contesta correctamente con la lista vacía.
Paso 2: Cotizar
Elige una y se cotiza con impuestos y política. Los tramos de la cancelación viajan uno por uno, no como una frase hecha, para que tu pantalla los dibuje en su idioma y su formato.
Paso 3: Reservar
Con los datos del huésped y una llave de idempotencia por intento. La misma llave devuelve siempre la misma reserva, así que dos peticiones simultáneas no crean dos reservas.
Paso 4: Cobrar
Se pide la intención de pago y se termina el cobro en tu pantalla. Sin monto, se cobra el saldo pendiente entero.
Quién cobra y qué se paga
- El cobro nace en tu cuenta de venta directa. Tu motor nunca llama a la pasarela para crear la intención de pago: la crea nuestro backend y tu pantalla la termina. Crearla de tu lado pondría el monto y la moneda en manos del cliente y rompería la conciliación con el folio.
- Cancelar no devuelve el dinero. El cargo nació en tu cuenta, así que la devolución la emites tú desde tu panel. La respuesta lo dice, para que tu pantalla no le prometa al huésped un reembolso que nadie mandó.
- El motor propio se contrata como suscripción aparte. Se cobra el mes completo, sin prorratear, al precio vigente ese mes, y trae sus folios de timbrado. Las comisiones no la acreditan: «si vendes, no pagas» es sobre la cuota, y esto es un producto distinto.