Cart Object


A shopping cart for a customer on a Wix eCommerce site.

A cart holds the customer's selected items, applied discounts (coupons, automatic rules), delivery information, and payment details before the order is placed.

Carts may be deleted after a period of inactivity.

Use the Cart Service to manage carts by ID, or the Current Cart Service to manage the current customer's cart by session.

Properties
businessInfoBusinessInfo

Information about the site from which the Cart's line items were added.


couponsArray <Coupon>Read-onlymaxItems 1

List of coupons added to the Cart. Currently only one coupon code is supported.


createdDatestringRead-onlyformat date-time

Date and time the Cart was created.


currentCartbooleanRead-only

Whether this is the customer's current cart. The current cart can be accessed using the identity context (for example, visitorId from session cookies) without an explicit cart ID.


customCheckoutUrlstringmaxLength 2048

Custom checkout URL to redirect the customer to a checkout page. By default, customers are redirected to the standard Wix checkout page. Clients can override this behavior by providing their own URL here. If the URL contains the placeholder {checkout_id}, it will be replaced with the actual Cart ID.


customerInfoCustomerInfo

Information about the customer that owns the Cart.


deliveryInfoDeliveryInfo

Delivery-related information associated with the Cart.


demoboolean

Whether this is a demo cart. Demo carts are created in the Wix editor for merchant preview and can't proceed to checkout.

Default: false


extendedFieldsExtendedFields

Custom fields. Extended fields must be configured in the app dashboard before they can be accessed with API calls.


idstringRead-onlyformat GUID

Cart ID.


lineItemsArray <LineItem>Read-onlymaxItems 300

Line items added to the Cart by the customer. This list may include in-stock items and invalid or out-of-stock items.


notestringmaxLength 1000

Optional message left by the customer. Usually intended for the merchant and contains special instructions, requests, or clarifications related to the order.


orderIdstringRead-onlyformat GUID

Order ID. Empty until the checkout process is completed.


orderPlacedbooleanRead-only

Whether the Cart has been placed as an Order. Defaults to false.


paymentInfoPaymentInfo

Payment-related information associated with the Cart.


purchaseFlowIdstringRead-onlyformat GUID

Persistent ID that correlates the Cart with the created Order after checkout is completed.


revisionstringRead-only

Revision number, which increments by 1 each time the Cart is updated.


settingsCartSettingsRead-onlyimmutable

Additional cart settings.

Settings can only be configured at cart creation time and can't be changed afterwards.


sourceCartSource

Information about the source of the Cart, detailing the origin or context in which the Cart was created.


subtotalConvertedMoneyRead-only

The sum of all line item final prices.


taxInfoTaxInfo

Tax-related information associated with the Cart.


updatedDatestringRead-onlyformat date-time

Date and time the Cart was last updated.

Did this help?