Bookings
availabilityId
in order to make a Booking Reservation.Reserving availability when making a booking. The steps to make a reservation are:
- 1.
Check Availability: Check the availability on the /availability endpoint to retrieve an
availabilityId
- 2.
Booking Reservation (this step): Create a booking that reserves the availability while you collect payment and contact information from the customer. The booking will remain with status
ON_HOLD
until the booking is confirmed or the reservation hold expires.
The availability for the booking is held for the amount of time equal to theexpirationMinutes
parameter (if provided), up to an internal limit set by either the supplier or the OCTo provider. The utc_expires_at
parameter in the response object will indicate when a reservtion will expire. A reservation can be extended by calling the /bookings/{uuid}/extend endpoint.
A reserved booking can be confirmed after the customer finalizes their choice on the /bookings/{uuid}/confirm endpoint provided the reservation had not expired.
This endpoint confirms the booking so it's ready to be used.
This endpoint will fetch the bookings you have made for the given filters.
When using this endpoint you must include one of the following query parameters:
resellerReference
supplierReference
localDate
localDateStart
andlocalDateEnd
Fetch the status of an existing booking.
Updates a booking before and after it has been confirmed as long as it hasn''t been redeemed or within the cancellation cutoff window. To know if the booking can be updated check the booking''s cancellable
field. If the booking can be cancelled, it can also be updated. It''s generally preferred to update a booking rather than cancelling it and rebooking.
Use this endpoint to hold the availability for a booking longer if the status is ON_HOLD
.