Cart Management

Manage multi-product carts

The Cart functionality allows you to group multiple bookings (from one or more suppliers) under a single order, enabling flexible checkout, centralized payment, and promotional logic. The key to managing a shared cart is the order_reference, which is created once and reused across all related operations.

Typical Workflow

1

Create Reservation

Start by creating a reservation (single product booking) and receive a reservation_reference in the response.

2

Add More Products

Create more reservations as needed for other products or suppliers.

3

Apply Promotions (Optional)

Optionally, apply promotional codes or discounts to the cart.

4

Review Cart

Retrieve the current state of the cart to review all bookings and applied promotions.

5

Capture Payment (Optional)

Initiate payment or skip this step.

6

Confirm Order

Use the reservation references to create an order, this will return the shared order_reference.

Benefits

• Group bookings from multiple suppliers into a single order.

• Apply promotions and cart-level discounts.

• Centralize payment under one transaction.

• Fully compatible with real-time availability and POS/web workflows.

---

Core Concepts

• Order Reference: A unique identifier representing the cart. All bookings associated with this order_referenceare grouped together.

• Booking Aggregation: Multiple bookings can be added to the same cart by referencing the existing order_reference.

• Real-time Cart Management: Bookings can be added or removed dynamically, with the cart reflecting the current state.

• Promotions and Discounts: Apply various promotional codes or discounts, which can affect individual items or the entire cart.

• Payment Integration: Once all desired bookings are in the cart, a single payment transaction can be initiated for the entire order.