Options

Options are variations to the main experience. Customers must choose an option to complete a booking.

Creating an option

Options can either be created when creating an experience or by using the POST /supplier/catalog/experiences/{experience_id}/options endpoint.

An option must contain the following properties:

option_id

The option ID, assigned by the supplier.

label

The human-friendly label for the option that customers will see.

holder_categories

Every option must have at least one holder category, the type of person making a booking.

Limiting quantities

Suppliers can set a minimum quantity required for a booking with an option's min_booking_quantity property. Only bookings with a total quantity that is greater than or equal to this value are accepted.

Suppliers can set a maximum limit per booking with an option's max_booking_quantity property. Only bookings with a total quantity that is less than or equal to this value are accepted. When no maximum is specified, no limit is placed on the booking quantity.

Changing the order

While PORTA returns options sorted by the order they were created, on musement.com options appear in order from least to most expensive. Suppliers can modify this order by assigning a main_option property value of true to a single option. The main option for an experience will appear first in the list of options on musement.com: