The ACME Shopping Cart is a collection of structured items that can be purchased, including Event Tickets, Add-ons, Memberships, and Donations.
The power of the ACME Shopping cart is that all items can be purchased in a unified cart. For example, if a guest purchases a Membership along with Event Tickets, the combination in a single shopping cart allows you to provide immediate membership benefits, such as discounts on the tickets.
All checkout calls require a Shopping Cart to complete. There are two options:
- Include the Shopping Cart Object with all of the items being purchased directly in the checkout call
- Create the Shopping Cart prior to checkout with the items being purchased, then include just the Shopping Cart ID in the checkout call.
For more information see the Shopping Cart and Checkout documentation:
Shopping Cart Object
If it's an existing shopping cart then the id of the cart.
The ID of the level. If you don't have the membership id but know the membership level then you can pass this in to give them membership discounts and access. If you pass in a membership id then this will not be used.
|items [ ] (Required)|
A list of items in the shopping cart. See Shopping Cart Item Object for details.
|comboItems [ ]|
A list of combo items in the cart. This is for a combo event not combo ticket category. See Combo Item Object for details.
A list of coupon codes (strings) being applied to this cart.
The id of an existing customer. This is ignored when creating a cart outside of checkout. A new customer can be created during B2C Checkout
A list of membership IDs that are being used on the order
|saleChannel: (Required for checkout)|
The sales channel that this order was completed on.
Note: The Shopping Cart response includes tempVisitorId. This is for ACME Internal Use only. Use customerId instead.
Shopping Cart Item Object
A unique ID for this item
|eventId (Required for Events)|
ID of the Event Instance
|ticketingTypeId (Required for Events)|
ID of the ticket type
The name of the event
The name of the ticket type
The number of these items in the shopping cart
The price for each item in the shopping cart. If a discount is applied, this will reflect the discounted price.
The retail price (aka full price) for each item in the shopping cart.
The total amount (quantity x unitPrice) of the items in the cart. In the case of a donation, this is used only for variable donation prices.
|itemType: (Required if not an Event)|
The type of item. Can be one of Event, Inventory, ComboEvent, ComboInventory. The default is Event.
|inventoryId (Required for Add On or Donation)|
If this item is not an event then this is the inventory id of the item.
Name of the item, if it's not an event.
Information about the membership being purchased.
See Membership Info Object (coming soon)
If a membership is being used to make this purchase then setting this flag will ignore restrictions on the membership. For example, if Gold members can only buy two tickets, setting this to true will ignore the restriction and enable the member to buy more.
If a discount is applicable (i.e. if you are using a coupon code), the discount id may be returned.
The details about the donation if this item is a donation. See Donation Details Object