> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

# Resource: Cart

# Type: Cart Object

# Link: https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/purchase-flow/cart/cart-object.md

## Description: A shopping cart that holds items a buyer intends to purchase. Carts are converted to checkouts when the buyer proceeds to payment.

## Schema:

```json
 Type: Cart Object | type: Cart
 Description: A shopping cart that holds items a buyer intends to purchase. Carts are converted to checkouts when the buyer proceeds to payment.
       - name: id  | type: string | description: Cart ID.
           - name: value  | type: string | description: 
       - name: lineItems  | type: Array<LineItem> | description: Line items.
           - name: id  | type: string | description: Line item ID.
           - name: quantity  | type: number | description: Item quantity.
           - name: catalogReference  | type: CatalogReference | description: Catalog and item reference. Holds IDs for the item and the catalog it came from, as well as further optional info. Optional for custom line items, which don't trigger the Catalog service plugin.
               - name: catalogItemId  | type: string | description: ID of the item within the catalog it belongs to.
               - name: appId  | type: string | description: ID of the app providing the catalog.  You can get your app's ID from its page in the [app dashboard](https://dev.wix.com/dc3/my-apps/).  For items from Wix catalogs, the following values always apply: + Wix Stores: `"215238eb-22a5-4c36-9e7b-e7c08025e04e"` + Wix Bookings: `"13d21c63-b5ec-5912-8397-c3a5ddb27a97"` + Wix Restaurants: `"9a5d83fd-8570-482e-81ab-cfa88942ee60"`
               - name: options  | type: Struct | description: Additional item details in `key:value` pairs.  Use this optional field for more specificity with item selection. The values of the `options` field differ depending on which catalog is providing the items.  For Wix Stores products, learn more about integrating with [Catalog V3](https://dev.wix.com/docs/api-reference/business-solutions/stores/catalog-v3/e-commerce-integration.md) or [Catalog V1](https://dev.wix.com/docs/api-reference/business-solutions/stores/catalog-v1/catalog/e-commerce-integration.md), depending on [the version the site uses](https://dev.wix.com/docs/api-reference/business-solutions/stores/catalog-versioning/introduction.md).
           - name: productName  | type: ProductName | description: Item name. + Stores - `product.name` + Bookings - `service.info.name` + Events - `ticket.name`
               - name: original  | type: string | description: __Required.__ Item name in the site's default language as defined in the [request envelope](https://dev.wix.com/docs/build-apps/develop-your-app/frameworks/self-hosting/supported-extensions/backend-extensions/add-self-hosted-service-plugin-extensions.md#request-envelope).  Min: 1 character. Max: 200 characters.
               - name: translated  | type: string | description: Item name translated into the buyer's language.  Min: 1 character. Max: 400 characters. Default: Same as `original`.
           - name: url  | type: PageUrlV2 | description: URL to the item's page on the site.
               - name: relativePath  | type: string | description: The relative path for the page within the site. For example, `/product-page/a-product`.
               - name: url  | type: string | description: The page's full URL. For example, `https://mysite.com/product-page/a-product`.
           - name: price  | type: MultiCurrencyPrice | description: Item price **after** catalog-defined discount and line item discounts.
               - name: amount  | type: string | description: Amount.
               - name: convertedAmount  | type: string | description: Converted amount.
               - name: formattedAmount  | type: string | description: Amount formatted with currency symbol.
               - name: formattedConvertedAmount  | type: string | description: Converted amount formatted with currency symbol.
           - name: fullPrice  | type: MultiCurrencyPrice | description: Item price **before** catalog-defined discount. Defaults to `price` when not provided.
           - name: priceBeforeDiscounts  | type: MultiCurrencyPrice | description: Item price **before** line item discounts and **after** catalog-defined discount. Defaults to `price` when not provided.
           - name: lineItemPrice  | type: MultiCurrencyPrice | description: Total price **after** catalog-defined discount and line item discounts.
           - name: descriptionLines  | type: Array<DescriptionLine> | description: Line item description lines. Used for displaying the cart, checkout and order.
               - name: name  | type: DescriptionLineName | description: Description line name.
           - name: image  | type: Image | description: Line item image details.
               - name: id  | type: string | description: WixMedia image ID.
               - name: url  | type: string | description: Image URL.
               - name: height  | type: number | description: Original image height.
               - name: width  | type: number | description: Original image width.
               - name: altText  | type: string | description: Image alt text.
               - name: filename  | type: string | description: Image filename.
           - name: availability  | type: ItemAvailabilityInfo | description: Item availability details.
               - name: status  | type: string | description: Item availability status.
               - name: quantityAvailable  | type: number | description: Quantity available.
           - name: physicalProperties  | type: PhysicalProperties | description: Physical properties of the item. When relevant, contains information such as SKU, item weight, and shippability.
               - name: weight  | type: number | description: Line item weight. Measurement unit matches the weight unit specified in `weightUnit` in the request.
               - name: sku  | type: string | description: Stock-keeping unit. Learn more about [SKUs](https://www.wix.com/encyclopedia/definition/stock-keeping-unit-sku).
               - name: shippable  | type: boolean | description: Whether this line item is shippable.
           - name: itemType  | type: ItemType | description: Item type. Either a preset type or custom.
           - name: subscriptionOptionInfo  | type: SubscriptionOptionInfo | description: Subscription option information.
               - name: subscriptionSettings  | type: SubscriptionSettings | description: Subscription option settings.
               - name: title  | type: Title | description: Subscription option title.
               - name: description  | type: Description | description: Subscription option description.
           - name: paymentOption  | type: string | description: Type of selected payment option for current item.  Default: `FULL_PAYMENT_ONLINE`
               enum: FULL_PAYMENT_ONLINE, FULL_PAYMENT_OFFLINE, MEMBERSHIP, DEPOSIT_ONLINE, MEMBERSHIP_OFFLINE, MEMBERSHIP_ONLINE_WITH_OFFLINE_REMAINDER
           - name: serviceProperties  | type: ServiceProperties | description: Service properties. When relevant, this contains information such as date and number of participants.
               - name: scheduledDate  | type: string | description: Date and time the service is to be provided, in [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations) format. For example, the start time of a class.
               - name: numberOfParticipants  | type: number | description: The number of people participating in the service. For example, the number of people attending a class or the number of people per hotel room.
           - name: rootCatalogItemId  | type: string | description: In cases where `catalogReference.catalogItemId` is NOT the actual catalog item ID, this field will return the true item's ID. + For example, for Wix Bookings, `catalogReference.catalogItemId` is the booking ID. Therefore this value is set to the service ID. + in most cases, this field is the same as `catalogReference.catalogItemId`. + Used in membership validation.
           - name: priceDescription  | type: PriceDescription | description: Additional description for the price. For example, when price is 0 but additional details about the actual price are needed - "Starts at $67".
               - name: original  | type: string | description: __Required.__ Price description in the site's default language as defined in the [request envelope](https://dev.wix.com/docs/build-apps/develop-your-app/frameworks/self-hosting/supported-extensions/backend-extensions/add-self-hosted-service-plugin-extensions.md#request-envelope).
               - name: translated  | type: string | description: Price description translated into the buyer's language.  Default: Same as `original`.
           - name: depositAmount  | type: MultiCurrencyPrice | description: Partial payment to be paid upfront during the checkout. Eligible for catalog items with `lineItem.paymentOption` type `DEPOSIT_ONLINE` only.
           - name: selectedMembership  | type: SelectedMembership | description: Selected membership to be used as payment for this item. Must be used with `lineItem.paymentOption` set to `MEMBERSHIP` or `MEMBERSHIP_OFFLINE`. This field can be empty when `lineItem.paymentOption` is set to `MEMBERSHIP_OFFLINE`.
               - name: id  | type: string | description: Membership ID.
               - name: appId  | type: string | description: ID of the app providing this payment option.
           - name: deliveryProfileId  | type: string | description: Delivery profile ID.
           - name: taxGroupId  | type: string | description: Tax group ID for this line item.
           - name: customLineItem  | type: boolean | description: Whether the line item is a custom line item. Custom line items don't trigger the Catalog service plugin.
           - name: consentRequiredPaymentPolicy  | type: string | description: Item payment policy that requires customer consent to complete purchase. The payment policy will be displayed on the checkout page.
           - name: priceUndetermined  | type: boolean | description: Whether the price is not yet defined, and will be updated after the order is created.
           - name: fixedQuantity  | type: boolean | description: Whether the line item quantity is fixed and cannot be changed.
           - name: catalogOverrideFields  | type: CatalogOverrideFields | description: Overriding values for catalog item properties.  To override catalog fields, your app must have the permission scope named "Manage eCommerce - Admin Permissions". Learn more about [permission scopes](https://dev.wix.com/docs/build-apps/develop-your-app/access/authorization/about-permissions.md).
               - name: productName  | type: ProductName | description: Item name.
               - name: price  | type: string | description: Item price **after** discounts.
               - name: fullPrice  | type: string | description: Item price **before** discounts.
               - name: descriptionLines  | type: Array<DescriptionLine> | description: Item description lines. Used when displaying the line item to customers.
               - name: physicalProperties  | type: PhysicalProperties | description: Physical properties of the item.
               - name: image  | type: Image | description: Item image.
               - name: paymentOption  | type: PaymentOption | description: Payment method selected for the item.
               - name: depositAmount  | type: string | description: Only eligible for catalog items with `lineItem.paymentOption.value` type of `DEPOSIT_ONLINE`.
               - name: savePaymentMethod  | type: boolean | description: Whether to save the payment method on the order.  Default: `false`
               - name: inventoryAppId  | type: string | description: ID of the app managing the inventory.
           - name: savePaymentMethod  | type: boolean | description: Whether to save the payment method on the order.  Default: `false`
           - name: taxableAddress  | type: TaxableAddress | description: Address to use for tax calculation purposes.
           - name: extendedFields  | type: ExtendedFields | description: Custom extended fields for the line item object.  [Extended fields](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields.md) must be configured using the 'Checkout & Orders - Line Items Schema Plugin' in the app dashboard before they can be accessed with API calls.
               - name: namespaces  | type: object | description: Extended field data. Each key corresponds to the namespace of the app that created the extended fields. The value of each key is structured according to the schema defined when the extended fields were configured.  You can only access fields for which you have the appropriate permissions.  Learn more about [extended fields](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields.md).
           - name: policies  | type: Array<Policy> | description: Policies to be displayed to the customer on the checkout page.
               - name: title  | type: string | description: Policy title - should be translated
               - name: content  | type: string | description: Policy content - should be translated
           - name: membersOnly  | type: boolean | description: Whether the item can only be purchased by site members.  Default: `false`
           - name: modifierGroups  | type: Array<ModifierGroup> | description: Modifier groups that were added to the item.
               - name: id  | type: string | description: Modifier group ID.
               - name: name  | type: TranslatableString | description: Modifier group name.
               - name: modifiers  | type: Array<ItemModifier> | description: List of modifiers in this group.
           - name: modifiersTotalPrice  | type: MultiCurrencyPrice | description: Total price of all item modifiers. Included in the item price.
       - name: buyerNote  | type: string | description: [Buyer note](https://support.wix.com/en/article/collecting-and-viewing-buyer-notes) left by the customer.
       - name: buyerInfo  | type: BuyerInfo | description: Buyer information.
           - name: contactId  | type: string | description: Contact ID. For more information, see the Contacts API.
           - name: email  | type: string | description: Buyer email address.
       - name: currency  | type: string | description: The site’s default currency, in three-letter [ISO-4217 alphabetic](https://en.wikipedia.org/wiki/ISO_4217#Active_codes) format. This represents the base currency configured for the site and remains constant regardless of the customer’s currency selection.
       - name: conversionCurrency  | type: string | description: The currency [selected by the customer](https://support.wix.com/en/article/multicurrency-an-overview) during the purchase flow, in three-letter [ISO-4217 alphabetic](https://en.wikipedia.org/wiki/ISO_4217#Active_codes) format.  This reflects the customer’s preferred display currency and may differ from the site’s default currency. When no specific currency is selected by the customer, this matches the `currency` property.
       - name: buyerLanguage  | type: string | description: Language for communication with the buyer. Defaults to the site language.  For a site that supports multiple languages, this is the language the buyer selected.
       - name: siteLanguage  | type: string | description: Site language in which original values are displayed.
       - name: taxIncludedInPrices  | type: boolean | description: Whether tax is included in line item prices.
           - name: value  | type: boolean | description: 
       - name: weightUnit  | type: string | description: Weight measurement unit - defaults to site's weight unit.
           enum: UNSPECIFIED_WEIGHT_UNIT, KG, LB
       - name: checkoutId  | type: string | description: ID of the checkout that originated from this cart.
       - name: appliedDiscounts  | type: Array<CartDiscount> | description: Cart discounts.
       - name: createdDate  | type: string | description: Date and time the cart was created.
           - name: seconds  | type: string | description: 
           - name: nanos  | type: number | description: 
       - name: updatedDate  | type: string | description: Date and time the cart was updated.
       - name: contactInfo  | type: AddressWithContact | description: Contact info.
           - name: address  | type: Address | description: Address.
               - name: country  | type: string | description: Two-letter country code in [ISO-3166 alpha-2](https://www.iso.org/obp/ui/#search/code/) format.
               - name: subdivision  | type: string | description: Code for a subdivision (such as state, prefecture, or province) in [ISO 3166-2](https://www.iso.org/standard/72483.html) format.
               - name: city  | type: string | description: City name.
               - name: postalCode  | type: string | description: Postal or zip code.
               - name: streetAddress  | type: StreetAddress | description: Street address.
               - name: addressLine  | type: string | description: Main address line (usually street name and number).
               - name: addressLine2  | type: string | description: Free text providing more detailed address info. Usually contains apt, suite, floor.
               - name: geocode  | type: AddressLocation | description: Geocode object containing latitude and longitude coordinates.
               - name: countryFullname  | type: string | description: Country's full name.
               - name: subdivisionFullname  | type: string | description: Subdivision full-name.
           - name: contactDetails  | type: FullAddressContactDetails | description: Contact details.
               - name: firstName  | type: string | description: First name.
               - name: lastName  | type: string | description: Last name.
               - name: phone  | type: string | description: Phone number.
               - name: company  | type: string | description: Company name.
               - name: vatId  | type: VatId | description: Tax information (for Brazil only). If ID is provided, `vatId.type` must also be set, `UNSPECIFIED` is not allowed.
       - name: overrideCheckoutUrl  | type: string | description: `overrideCheckoutUrl` allows the flexibility to redirect customers to a customized checkout page.  This field overrides the `checkoutUrl` in a cart or checkout. `checkoutUrl` is used in the Abandoned Checkout API to send customers back to their checkouts. By default, a `checkoutUrl` generates for a checkout and directs to a standard Wix checkout page. When `overrideCheckoutUrl` has a value, it will replace and set the value of `checkoutUrl`.
       - name: purchaseFlowId  | type: string | description: Persistent ID that correlates between the various eCommerce elements: cart, checkout, and order.
       - name: selectedShippingOption  | type: SelectedShippingOption | description: Selected shipping option.
           - name: carrierId  | type: string | description: Carrier ID.
           - name: code  | type: string | description: Selected shipping option code. For example, "usps_std_overnight".
       - name: extendedFields  | type: ExtendedFields | description: Fields extended by data extensions
       - name: businessLocationId  | type: string | description: The business location ID associated with the cart.  To learn more, see the Locations API.
       - name: paymentCurrency  | type: string | description: The currency used for payment, in three-letter [ISO-4217 alphabetic](https://en.wikipedia.org/wiki/ISO_4217#Active_codes) format.  This is determined by the [customer's selected currency](https://support.wix.com/en/article/multicurrency-an-overview) and the site’s supported payment currencies. If the customer’s selected currency is supported for payment, this matches the `conversionCurrency` property. If not supported, this falls back to the `currency` property.
       - name: revision  | type: string | description: Revision number, which increments by 1 each time the Cart is updated.
           - name: value  | type: string | description: 

```