Crear una reserva¶

Producto: OpenBooking | Módulo: Integración API | Última actualización: 2026-08-12

Introducción¶

Crear una reserva por API son dos pasos: armar el carrito con el servicio y las fechas, y luego hacer el checkout con los datos del cliente y el medio de pago.

Paso 1: Agregar al carrito¶

POST /api/booking/addToCart
Content-Type: application/json

{
  "service_id": 12,
  "service_type": "hotel",
  "start_date": "2026-09-10",
  "end_date": "2026-09-13",
  "adults": 2,
  "children": 0,
  "extra_price": [],
  "rooms": [
    { "id": 5, "number": 1 }
  ]
}

Respuesta: el código de la reserva en curso y el detalle de precios.

Campo	Detalle
`service_id`	Identificador del servicio
`service_type`	`hotel`, `cabin`, `tour`, `car`, `boat`, `space`, `event`, `flight`
`start_date` / `end_date`	Fechas de la estadía
`adults` / `children`	Huéspedes
`rooms`	Habitaciones o unidades y su cantidad, cuando aplica
`extra_price`	Servicios extra seleccionados

⚠️ Advertencia: Este paso no confirma la reserva: crea un borrador. Si el flujo se abandona aquí, la reserva queda sin completar y no bloquea disponibilidad de forma definitiva.

Paso 2: Checkout¶

POST /api/booking/doCheckout
Content-Type: application/json

{
  "code": "abc123",
  "first_name": "Ana",
  "last_name": "Pérez",
  "email": "ana@ejemplo.cl",
  "phone": "+56912345678",
  "payment_gateway": "offline_payment",
  "term_conditions": 1
}

Campo	Detalle
`code`	El código devuelto por `addToCart`
Datos del cliente	Nombre, apellido, correo y teléfono
`payment_gateway`	Identificador de la pasarela elegida
`term_conditions`	Aceptación de términos

Respuesta: según la pasarela, la reserva queda confirmada o se devuelve la URL a la que debe redirigir al cliente para pagar.

Vea Pagos y confirmación.

Consultar una reserva¶

GET /api/booking/{code}

Devuelve el estado, las fechas, los montos y lo pagado.

GET /api/booking/{code}/check-status

Consulta ligera del estado, pensada para hacer seguimiento tras un pago.

GET /api/booking/{code}/thankyou

Datos de la pantalla de confirmación.

Consultas sin reserva¶

POST /api/booking/addEnquiry

Registra una consulta del cliente sobre un servicio y fechas, sin generar reserva. Equivale al formulario de consulta del sitio.

Vea Consultas de clientes.

Errores a manejar¶

Situación	Qué hacer
Sin disponibilidad al hacer checkout	Volver a consultar disponibilidad y ofrecer alternativas
Datos obligatorios faltantes	Mostrar los errores de validación al usuario
Código de carrito inválido o vencido	Reiniciar el flujo desde `addToCart`
Pasarela no disponible	Ofrecer las que sí estén activas

Recomendaciones¶

Verifique disponibilidad inmediatamente antes del checkout.
Guarde el code durante todo el flujo.
Valide en el cliente antes de enviar, para reducir viajes.
Confirme siempre con check-status después de volver de la pasarela.

¿Necesita ayuda adicional? Contacte a soporte: soporte@openx.cl