Basket Structure

The following diagram depicts the structure of a basket:

Each entity is described as follows:

Basket
This level contains information such as the basket reference (e.g. TTG123456789), channel Id (your affiliate id), and which currency the basket uses (e.g. GBP or USD).
Reservation
This entity contains information about the product and performance, which has been added to the basket. A basket may contain reservations of multiple price types. To handle this correctly ensure that you parse each reservation object - there is a reservation object for each price type. Each reservation can can contain multiple items.
- the product Id
- venue Id,
- product type (e.g. SHW)
- performance date
- quantity of seats.
- It also contains information about product prices
- (if applicable) the amount of discount applied to the reservation.
Item
This contains information about the reserved seats for a particular performance. For example;
- block Id (e.g. DC),
- block name (e.g. CIRCLE),
- row (e.g. G)
- seat number (this might also include a seat "location", instead of specific seat numbers, in cases where you cannot book particular seats; common with Broadway shows
Delivery
This contains information about the delivery method used for the basket
Promotions
This refers to discounts applied to basket reservations, based on live promotions. Promotions can have different rules for when they can be applied. For example, a promotion might only be applicable to a specific show (e.g. £10 off Lion King), or can only be applied when a minimum price is reached (e.g. spend more than £100 to get 10% off).

👍
Promotions
Promotions can be applied using a coupon code (e.g. BLACKFRIDAY2019) or automatically, when the items in the basket fulfil the criteria of a promotion. There is also the concept of "missed promotions" - this can be used to return messaging for your customers when they get close to triggering a promotion (e.g. if they have £95 worth of items in their basket and there is a promotion to get 10% off if they spend £100, a missed promotion message might be "Spend £100 to get 10% off").
If you want to setup a promotion, please contact us and we can work with you to configure suitable promotions for your audience.