Carts

Learn more about the carts resource.

The Carts resource in the Commerce Shopper API lets you manage customer shopping experiences. It lets you retrieve, update, and modify a customer's cart. Understanding how to use the Carts resource effectively ensures your users' seamless and efficient shopping process.

The Carts resource provides access to a customer's cart and cart data. Use the Cart resource to get, update, or modify a cart.

Important: All methods in this API require an anonymous (limited access) or authenticated (full access) token.

Pricing fields

When the value of taxIncludedPrice is true, the listed price information in the response is tax-inclusive. When the value is false, the listed price information in the response is tax exclusive.

• The following fields display prices based on the taxIncludedPrice field's value at the line item level.

  • listPrice
  • listPriceWithQuantity
  • salePrice
  • salePriceWithQuantity: This is the total calculated price for the line item with quantity. The sales price with quantity includes:

    • The line item level discount.

    • The Included in Price fee, an invisible fee, is available if you configure it for the line item.

    • If the price list is tax-inclusive, this price will include tax.

    It does not include the following:

    • The order level discount.

    • The "Excluded from price" fee (a visible fee).

    • If the price is tax-exclusive, this price will not include tax.

• The following fields display prices based on the taxIncludedPrice field's value at the order level.

  • Subtotal: sum(salePriceWithQuantity) + sum(visible fee)
  • subtotalWithDiscount
  • discount
  • shippingAndHandling

The following fields are not taxinclusive/exclusive related. However, they are taxes or include taxes such as orderTotal:

• At the line item level:

  • productTax
  • shippingTax
  • feeTax
  • importTax
  • importDuty
• At the order level:

  • tax
  • importTaxAndDuty