Cómo mantener y confirmar una reserva de resort

La API de Resorts utiliza un proceso de reserva de dos pasos: primero crea una retención en la reserva y luego la confirma. Esto le brinda una ventana para finalizar el pago o realizar una validación adicional antes de confirmar la reserva.

Paso 1: Crear una reserva

Punto final

POST {{apihost}}/resorts/api/v2/itineraries?token={token}&recommendationid={recommendation_id}

Encabezados requeridos

Parámetros de consulta

Cuerpo de solicitud

{
  "property_id": "RST-98765",
  "checkin": "2026-04-01",
  "checkout": "2026-04-07",
  "total_rate": 1710,
  "currency": "USD",
  "action": "CONFIRM",
  "communication_details": {
    "email": "guest@example.com",
    "phone": "+1-555-123-4567"
  },
  "traveler": {
    "first_name": "Jane",
    "middle_name": "",
    "last_name": "Doe",
    "address": "456 Palm Avenue",
    "city": "Los Angeles",
    "state": "CA",
    "zip_code": "90001",
    "country": "US",
    "email": "guest@example.com",
    "phone": "+1-555-123-4567"
  }
}

Campos del cuerpo de la solicitud

Ejemplo de respuesta: retención creada

{
  "status": 200,
  "data": {
    "reference_number": "XRN-2026040100123",
    "status": "HOLD"
  }
}

Ejemplo de respuesta: reserva confirmada inmediatamente

En algunos casos, la reserva podrá confirmarse inmediatamente sin pasar por un estado de espera:

{
  "status": 200,
  "data": {
    "reference_number": "XRN-2026040100123",
    "status": "CONFIRMED"
  }
}

Error: Tarifa no coincidente

Si el total_rate de su solicitud no coincide con el precio confirmado, la API devuelve un error 400:

{
  "message": "Total rate does not match the confirmed price",
  "status": 400
}

Utilice siempre el valor totalRate del punto final de confirmación de precios para evitar este error.

Paso 2: Confirmar la retención

Si la reserva se creó con un estado "HOLD", deberá confirmarlo explícitamente para finalizar la reserva.

Punto final

PUT {{apihost}}/resorts/api/v2/itineraries?referencenumber={reference_number}&status=CONFIRM

Encabezados requeridos

Parámetros de consulta

Cuerpo de solicitud

El cuerpo de la solicitud debe estar vacío.

Ejemplo de respuesta

{
  "status": 200,
  "data": {
    "reference_number": "XRN-2026040100123",
    "status": "CONFIRMED"
  }
}

Error: Estado de retención no válido

Si la reserva no se encuentra actualmente en un estado HOLD (por ejemplo, ya ha sido confirmada o liberada), la API devuelve un error 417:

{
  "message": "Booking is not in HOLD state",
  "status": 417
}

Flujo de reserva completo

Aquí está la secuencia completa desde la búsqueda hasta la reserva confirmada:

1. Autocompletar: obtiene el código de región del destino.
2. Búsqueda de propiedades: busque complejos turísticos disponibles y obtenga un recommendation_id.
3. Disponibilidad: consulta la disponibilidad de habitaciones y obtén un token.
4. Precio: confirme la tarifa final utilizando token y recommendation_id.
5. Reserva: cree una reserva con los total_rate, token confirmados y los detalles del viajero.
6. Confirmar: si el estado de la respuesta es "HOLD", confirme la reserva para finalizarla.

Mejores prácticas- Confirma siempre el precio primero: nunca crees una reserva utilizando tarifas de la respuesta de búsqueda o disponibilidad. Utilice siempre la tarifa devuelta por el punto final de fijación de precios.

• Manejar ambos estados: su integración debe manejar las respuestas "HOLD" y "CONFIRMED" desde el punto final de retención. Si el estado es "CONFIRMED", no es necesario realizar ninguna otra acción.
• Confirmar de inmediato: las retenciones tienen un límite de tiempo. Confirme la reserva tan pronto como se complete su proceso de pago o validación.
• Guarde el número de referencia: reference_number es su identificador principal para todas las operaciones posteriores (confirmar, liberar, recuperar).

Artículo siguiente: Cómo cancelar una retención de resort