{"templateId":"markdown","sharedDataIds":{},"props":{"codeGuideFiles":[],"dynamicMarkdocComponents":[],"metadata":{"type":"markdown"},"seo":{"title":"Cart","description":"Fluid is the open e-commerce platform built for direct-sales."},"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"cart"},"children":["Cart"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The FairShare SDK provides a complete set of cart management functions for adding items, managing quantities, handling subscriptions, and processing checkout."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"quick-start"},"children":["Quick Start"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"javascript","header":{"controls":{"copy":{}}},"source":"// Add item to cart\nawait window.FairShareSDK.addCartItems(12345, { quantity: 1 });\n\n// Open the cart drawer\nwindow.FairShareSDK.openCart();\n\n// Proceed to checkout\nawait window.FairShareSDK.checkout();\n","lang":"javascript"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Or use HTML data attributes without JavaScript:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"html","header":{"controls":{"copy":{}}},"source":"<button data-fluid-add-to-cart=\"12345\">Add to Cart</button>\n<button data-fluid-cart=\"open\">View Cart</button>\n","lang":"html"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"cart-widget-control"},"children":["Cart Widget Control"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Control the cart drawer/widget programmatically:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"javascript","header":{"controls":{"copy":{}}},"source":"// Open cart\nwindow.FairShareSDK.openCart();\n// or: window.FairShareSDK.cart.control.open();\n\n// Close cart\nwindow.FairShareSDK.closeCart();\n// or: window.FairShareSDK.cart.control.close();\n\n// Toggle cart\nwindow.FairShareSDK.toggleCart();\n// or: window.FairShareSDK.cart.control.toggle();\n","lang":"javascript"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"html-controls"},"children":["HTML Controls"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"html","header":{"controls":{"copy":{}}},"source":"<button data-fluid-cart=\"open\">Open Cart</button>\n<button data-fluid-cart=\"close\">Close Cart</button>\n<button data-fluid-cart=\"toggle\">Toggle Cart</button>\n","lang":"html"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"adding-items"},"children":["Adding Items"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"javascript-api"},"children":["JavaScript API"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"javascript","header":{"controls":{"copy":{}}},"source":"// Add single item\nawait window.FairShareSDK.addCartItems(12345, { quantity: 1 });\n\n// Add with subscription\nawait window.FairShareSDK.addCartItems(12345, {\n  quantity: 1,\n  subscribe: true\n});\n\n// Add multiple items\nawait window.FairShareSDK.addCartItems([\n  { variant_id: 12345, quantity: 2 },\n  { variant_id: 67890, quantity: 1 }\n]);\n\n// Add a dynamic bundle with bundled items\nawait window.FairShareSDK.addCartItems(278318, {\n  quantity: 1,\n  bundled_items: [\n    { variant_id: 39325, quantity: 1 },\n    { variant_id: 35376, quantity: 1 },\n    { variant_id: 11311, quantity: 1 },\n  ]\n});\n","lang":"javascript"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"html-data-attributes"},"children":["HTML Data Attributes"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"html","header":{"controls":{"copy":{}}},"source":"<!-- Basic add to cart -->\n<button data-fluid-add-to-cart=\"12345\">Add to Cart</button>\n\n<!-- With quantity -->\n<button data-fluid-add-to-cart=\"12345\" data-fluid-quantity=\"2\">\n  Add 2 to Cart\n</button>\n\n<!-- With subscription -->\n<button data-fluid-add-to-cart=\"12345\" data-fluid-subscribe=\"true\">\n  Subscribe\n</button>\n\n<!-- With specific subscription plan -->\n<button\n  data-fluid-add-to-cart=\"12345\"\n  data-fluid-subscription-plan-id=\"99\"\n>\n  Subscribe with Plan\n</button>\n\n<!-- Add multiple items -->\n<button data-fluid-add-to-cart=\"12345,67890\">Add Both</button>\n\n<!-- Dynamic bundle with bundled items -->\n<button\n  data-fluid-add-to-cart=\"278318\"\n  data-fluid-bundled-items='[{\"variant_id\":39325,\"quantity\":1},{\"variant_id\":35376,\"quantity\":1},{\"variant_id\":11311,\"quantity\":1}]'\n>\n  Add Bundle to Cart\n</button>\n\n<!-- Control cart opening after add -->\n<button\n  data-fluid-add-to-cart=\"12345\"\n  data-fluid-open-cart-after-add=\"false\"\n>\n  Add Silently\n</button>\n","lang":"html"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"enrollment-packs"},"children":["Enrollment Packs"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Add enrollment/starter packs to the cart:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"javascript","header":{"controls":{"copy":{}}},"source":"// Simple enrollment pack\nawait window.FairShareSDK.addEnrollmentPack(539);\n\n// Enrollment pack with bundle selections\nawait window.FairShareSDK.addEnrollmentPack(539, {\n  bundleSelections: [\n    {\n      variant_id: 278318,\n      bundled_items: [\n        { variant_id: 39325, quantity: 1 },\n        { variant_id: 35376, quantity: 1 },\n        { variant_id: 11311, quantity: 1 },\n      ]\n    }\n  ]\n});\n","lang":"javascript"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"html"},"children":["HTML"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"html","header":{"controls":{"copy":{}}},"source":"<button data-fluid-add-enrollment-pack=\"100\">Add Enrollment Pack</button>\n\n<!-- Enrollment pack with bundle selections -->\n<button\n  data-fluid-add-enrollment-pack=\"539\"\n  data-fluid-bundle-selections='[{\"variant_id\":278318,\"bundled_items\":[{\"variant_id\":39325,\"quantity\":1},{\"variant_id\":35376,\"quantity\":1},{\"variant_id\":11311,\"quantity\":1}]}]'\n>\n  Add Enrollment Pack\n</button>\n\n<!-- Combined: Enrollment Pack + Items -->\n<button data-fluid-add-combined=\"100+12345,67890\">Add Pack + Items</button>\n","lang":"html"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"data-attributes-reference"},"children":["Data Attributes Reference"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["All available data attributes for no-code HTML integration:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Attribute"},"children":["Attribute"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data-fluid-add-to-cart"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Variant ID(s), comma-separated for multiple"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data-fluid-quantity"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Quantity (default: 1)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data-fluid-subscribe"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"true\""]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"false\""]},", comma-separated for multiple"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data-fluid-subscription-plan-id"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Subscription plan ID"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data-fluid-bundled-items"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["JSON string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Array of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{ variant_id, quantity }"]}," for dynamic bundles"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data-fluid-open-cart-after-add"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Set to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"false\""]}," to prevent cart from opening"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data-fluid-add-enrollment-pack"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Enrollment pack ID"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data-fluid-bundle-selections"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["JSON string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Array of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{ variant_id, bundled_items }"]}," for enrollment pack bundles"]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"managing-cart-items"},"children":["Managing Cart Items"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"update-quantities"},"children":["Update Quantities"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"javascript","header":{"controls":{"copy":{}}},"source":"await window.FairShareSDK.updateCartItems([\n  { variant_id: 12345, quantity: 5 }\n]);\n","lang":"javascript"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"decrease-quantity"},"children":["Decrease Quantity"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"javascript","header":{"controls":{"copy":{}}},"source":"await window.FairShareSDK.decrementCartItem(variantId, { quantity: 1 });\n","lang":"javascript"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"remove-item"},"children":["Remove Item"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"javascript","header":{"controls":{"copy":{}}},"source":"await window.FairShareSDK.removeCartItemById(itemId);\n","lang":"javascript"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"clear-cart"},"children":["Clear Cart"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"javascript","header":{"controls":{"copy":{}}},"source":"await window.FairShareSDK.clearCart();\n","lang":"javascript"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"subscriptions"},"children":["Subscriptions"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Manage subscription status for cart items:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"javascript","header":{"controls":{"copy":{}}},"source":"// Add subscription to item\nawait window.FairShareSDK.subscribeCartItem(itemId, subscriptionPlanId);\n\n// Remove subscription from item\nawait window.FairShareSDK.unsubscribeCartItem(itemId);\n","lang":"javascript"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"reading-cart-data"},"children":["Reading Cart Data"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"get-cart-from-api"},"children":["Get Cart from API"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"javascript","header":{"controls":{"copy":{}}},"source":"const cart = await window.FairShareSDK.getCart();\nconsole.log('Items:', cart.items.length);\nconsole.log('Total:', cart.total);\n","lang":"javascript"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"get-cached-cart-no-api-call"},"children":["Get Cached Cart (No API Call)"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"javascript","header":{"controls":{"copy":{}}},"source":"const localCart = window.FairShareSDK.getLocalCart();\n","lang":"javascript"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"get-item-count"},"children":["Get Item Count"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"javascript","header":{"controls":{"copy":{}}},"source":"const count = window.FairShareSDK.getCartItemCount();\n","lang":"javascript"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"auto-updating-item-count-display"},"children":["Auto-Updating Item Count Display"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The SDK automatically updates any element with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id=\"fluid-cart-count\""]},":"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"html","header":{"controls":{"copy":{}}},"source":"<span id=\"fluid-cart-count\">0</span>\n","lang":"html"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"checkout"},"children":["Checkout"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"standard-checkout"},"children":["Standard Checkout"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"javascript","header":{"controls":{"copy":{}}},"source":"await window.FairShareSDK.checkout();\n","lang":"javascript"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"get-checkout-url"},"children":["Get Checkout URL"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"javascript","header":{"controls":{"copy":{}}},"source":"const url = window.FairShareSDK.getCheckoutUrl();\nwindow.open(url, '_blank');\n","lang":"javascript"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"custom-checkout-handler"},"children":["Custom Checkout Handler"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Override the default checkout behavior:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"javascript","header":{"controls":{"copy":{}}},"source":"window.FairShareSDK.setOnCheckout(async () => {\n  const cart = await window.FairShareSDK.getCart();\n\n  if (cart.items.length === 0) {\n    alert('Your cart is empty!');\n    return;\n  }\n\n  // Custom checkout logic\n  window.location.href = '/custom-checkout';\n});\n\n// Get current handler\nconst handler = window.FairShareSDK.getOnCheckout();\n","lang":"javascript"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"cart-loading-events"},"children":["Cart Loading Events"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Listen for cart loading states in your application:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"javascript","header":{"controls":{"copy":{}}},"source":"window.addEventListener(\"CART_LOADING_START\", (e) => {\n  console.log(\"Loading started:\", e.detail);\n  // Show loading spinner\n});\n\nwindow.addEventListener(\"CART_LOADING_END\", (e) => {\n  console.log(\"Loading ended:\", e.detail);\n  // Hide loading spinner\n});\n","lang":"javascript"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"cart-operation-events"},"children":["Cart Operation Events"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Every cart mutation also emits a uniform ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CART_OPERATION_SUCCESS"]}," / ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CART_OPERATION_ERROR"]}," window event. The CDN can render a built-in toast for them and show a loading spinner on add-to-cart buttons — both are opt-in (off by default), enabled with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data-fluid-toast=\"true\""]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data-fluid-button-loading=\"true\""]}," on the Fluid script tag. The events fire regardless."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"javascript","header":{"controls":{"copy":{}}},"source":"window.addEventListener(\"CART_OPERATION_ERROR\", (e) => {\n  console.log(e.detail.operation, \"failed:\", e.detail.message);\n});\n","lang":"javascript"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/docs/sdk/fairshare/cart/cart-operation-events"},"children":["Cart Operation Events"]}," for the event payloads, the built-in toast's ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data-fluid-toast-*"]}," configuration, and the button loading helpers."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"external-cart-handoff"},"children":["External Cart Handoff"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Adopt a cart created by an external system (e.g., a companion app or backend service):"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"url-parameter-recommended-for-redirects"},"children":["URL Parameter (Recommended for Redirects)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["No JavaScript needed — redirect users with a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cart_token"]}," query parameter:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"https://shop.example.com/?cart_token=TOKEN\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The SDK automatically detects the parameter, validates the cart, saves it, and cleans the token from the URL."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"programmatic-api"},"children":["Programmatic API"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"javascript","header":{"controls":{"copy":{}}},"source":"const cart = await window.FairShareSDK.setCartToken(\"TOKEN\");\n","lang":"javascript"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Both methods validate the token via API, subscribe to Pusher realtime updates, and dispatch events so cart widgets react immediately."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"cart-settings"},"children":["Cart Settings"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Customize cart widget behavior:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"javascript","header":{"controls":{"copy":{}}},"source":"// Set cart settings\nwindow.FairShareSDK.setCartSettings({\n  // your settings\n});\n\n// Get current settings\nconst settings = window.FairShareSDK.getCartSettings();\n\n// Clear settings\nwindow.FairShareSDK.clearCartSettings();\n","lang":"javascript"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"api-reference"},"children":["API Reference"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"cart-operations"},"children":["Cart Operations"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Function"},"children":["Function"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/docs/sdk/fairshare/cart/getcart"},"children":["getCart"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Fetch cart from API"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/docs/sdk/fairshare/cart/refreshcart"},"children":["refreshCart"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Fetch cart from API and update all widgets"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/docs/sdk/fairshare/cart/getlocalcart"},"children":["getLocalCart"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Get cart from cache (no API call)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/docs/sdk/fairshare/cart/createcart"},"children":["createCart"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Create new empty cart"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/docs/sdk/fairshare/cart/clearcart"},"children":["clearCart"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Remove all items from cart"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/docs/sdk/fairshare/cart/getcartitemcount"},"children":["getCartItemCount"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Get total item count"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/docs/sdk/fairshare/cart/setcarttoken"},"children":["setCartToken"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Adopt an externally-created cart"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"adding-items-1"},"children":["Adding Items"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Function"},"children":["Function"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/docs/sdk/fairshare/cart/addcartitems"},"children":["addCartItems"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Add one or more items to cart"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/docs/sdk/fairshare/cart/addenrollmentpack"},"children":["addEnrollmentPack"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Add enrollment pack to cart"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"updating-items"},"children":["Updating Items"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Function"},"children":["Function"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/docs/sdk/fairshare/cart/updatecartitems"},"children":["updateCartItems"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Update item quantities"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/docs/sdk/fairshare/cart/updatecartitemvariant"},"children":["updateCartItemVariant"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Change item variant"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/docs/sdk/fairshare/cart/decrementcartitem"},"children":["decrementCartItem"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Decrease item quantity"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/docs/sdk/fairshare/cart/removecartitembyid"},"children":["removeCartItemById"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Remove item from cart"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"subscriptions-1"},"children":["Subscriptions"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Function"},"children":["Function"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/docs/sdk/fairshare/cart/subscribecartitem"},"children":["subscribeCartItem"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Add subscription to item"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/docs/sdk/fairshare/cart/unsubscribecartitem"},"children":["unsubscribeCartItem"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Remove subscription from item"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"checkout-1"},"children":["Checkout"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Function"},"children":["Function"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/docs/sdk/fairshare/cart/checkout"},"children":["checkout"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Proceed to checkout"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/docs/sdk/fairshare/cart/getcheckouturl"},"children":["getCheckoutUrl"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Get checkout URL without redirecting"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/docs/sdk/fairshare/cart/setoncheckout"},"children":["setOnCheckout"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Set custom checkout handler"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"cart-widget-control-1"},"children":["Cart Widget Control"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Function"},"children":["Function"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/docs/sdk/fairshare/cart/opencart"},"children":["openCart"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Open the cart drawer"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/docs/sdk/fairshare/cart/closecart"},"children":["closeCart"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Close the cart drawer"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/docs/sdk/fairshare/cart/togglecart"},"children":["toggleCart"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Toggle cart open/closed"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"cart-settings-1"},"children":["Cart Settings"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Function"},"children":["Function"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/docs/sdk/fairshare/cart/setcartsettings"},"children":["setCartSettings"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Set cart widget settings"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/docs/sdk/fairshare/cart/getcartsettings"},"children":["getCartSettings"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Get current cart settings"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/docs/sdk/fairshare/cart/clearcartsettings"},"children":["clearCartSettings"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Clear cart settings"]}]}]}]}]}]},"headings":[{"value":"Cart","id":"cart","depth":1},{"value":"Quick Start","id":"quick-start","depth":2},{"value":"Cart Widget Control","id":"cart-widget-control","depth":2},{"value":"HTML Controls","id":"html-controls","depth":3},{"value":"Adding Items","id":"adding-items","depth":2},{"value":"JavaScript API","id":"javascript-api","depth":3},{"value":"HTML Data Attributes","id":"html-data-attributes","depth":3},{"value":"Enrollment Packs","id":"enrollment-packs","depth":2},{"value":"HTML","id":"html","depth":3},{"value":"Data Attributes Reference","id":"data-attributes-reference","depth":2},{"value":"Managing Cart Items","id":"managing-cart-items","depth":2},{"value":"Update Quantities","id":"update-quantities","depth":3},{"value":"Decrease Quantity","id":"decrease-quantity","depth":3},{"value":"Remove Item","id":"remove-item","depth":3},{"value":"Clear Cart","id":"clear-cart","depth":3},{"value":"Subscriptions","id":"subscriptions","depth":2},{"value":"Reading Cart Data","id":"reading-cart-data","depth":2},{"value":"Get Cart from API","id":"get-cart-from-api","depth":3},{"value":"Get Cached Cart (No API Call)","id":"get-cached-cart-no-api-call","depth":3},{"value":"Get Item Count","id":"get-item-count","depth":3},{"value":"Auto-Updating Item Count Display","id":"auto-updating-item-count-display","depth":3},{"value":"Checkout","id":"checkout","depth":2},{"value":"Standard Checkout","id":"standard-checkout","depth":3},{"value":"Get Checkout URL","id":"get-checkout-url","depth":3},{"value":"Custom Checkout Handler","id":"custom-checkout-handler","depth":3},{"value":"Cart Loading Events","id":"cart-loading-events","depth":2},{"value":"Cart Operation Events","id":"cart-operation-events","depth":2},{"value":"External Cart Handoff","id":"external-cart-handoff","depth":2},{"value":"URL Parameter (Recommended for Redirects)","id":"url-parameter-recommended-for-redirects","depth":3},{"value":"Programmatic API","id":"programmatic-api","depth":3},{"value":"Cart Settings","id":"cart-settings","depth":2},{"value":"API Reference","id":"api-reference","depth":2},{"value":"Cart Operations","id":"cart-operations","depth":3},{"value":"Adding Items","id":"adding-items-1","depth":3},{"value":"Updating Items","id":"updating-items","depth":3},{"value":"Subscriptions","id":"subscriptions-1","depth":3},{"value":"Checkout","id":"checkout-1","depth":3},{"value":"Cart Widget Control","id":"cart-widget-control-1","depth":3},{"value":"Cart Settings","id":"cart-settings-1","depth":3}],"frontmatter":{"seo":{"title":"Cart"}},"lastModified":"2026-07-13T21:27:13.000Z"},"slug":"/docs/sdk/fairshare/cart","userData":{"isAuthenticated":false,"teams":["anonymous"]}}