Reservas
La API de reservas te permite reservar habitaciones y tarifas confirmadas por la respuesta de comprobación de los precios.
El método básico de los itinerarios de la API de reservas crea una reserva para el alojamiento, la habitación, la tarifa y la ocupación que se hayan seleccionado. La información sobre el pago, que incluye información sobre la facturación y el contacto del titular de la tarjeta, se facilita directamente dentro de la solicitud.
Cada respuesta de reserva realizada correctamente contiene enlaces para recuperar el itinerario o cancelar la reserva. Consulta los detalles en las secciones Gestión de reservas y Gestión de solicitudes de reserva.
Para reservar varias habitaciones (del mismo tipo), primero debes realizar una solicitud de compra e introducir un parámetro de occupancy distinto para cada habitación. A continuación, en la solicitud de reserva, incluye por separado las peticiones correspondientes de room en la matriz de rooms de cada habitación que quieras reservar.
Para conservar el inventario durante un breve periodo de tiempo antes de finalizar una reserva (por ejemplo, para generar un paquete), consulta nuestra documentación sobre retención y reanudación de reservas.
Para crear una reserva de prueba que no genere un cargo en tu tarjeta ni se envíe al alojamiento, consulta nuestra documentación sobre solicitudes de prueba.
Caducidad del enlace de reserva
El enlace de reserva generado en tu respuesta previa de comprobación de precios caduca tras un breve periodo de tiempo. Si, tras el primer intento, se te muestra un error HTTP 503, es probable que el enlace haya caducado. Deberás obtener un nuevo enlace y realizar un nuevo intento de reserva.
Números de identificación fiscal para reservas en INR y BRL
Debido a requisitos fiscales, algunas transacciones de Rapid efectuadas en rupias indias (INR) y reales brasileños (BRL) deben incluir una identificación fiscal válida del viajero que realiza el pago en el parámetro tax_registration_number.
La creación de solicitudes de reserva puede fallar si este parámetro se deja en blanco o si se proporciona una identificación fiscal no válida. Las solicitudes devolverán un error HTTP 400 con un mensaje que describe el origen del error como tax_registration_number. Para corregirlo, actualiza tax_registration_number con un número de identificación fiscal válido y vuelve a enviar la solicitud de creación de reserva.
Detalles de la API
Explora las definiciones de los puntos de conexión relacionados con las reservas en esta página y usa API Explorer u otro software de pruebas para ver la diferencia entre los ejemplos y las definiciones de esquemas, y el resultado real.
Recursos adicionales
Tanto si lo que quieres es probar todos los puntos de conexión de Rapid API como si quieres descargar las especificaciones de OpenAPI o nuestra colección de Postman, tenemos lo que necesitas.