Cart

Module role in sales flow

cart is the first checkout module for both guest and authenticated users.

• Use create when you want an explicit initial cart payload (variants, coupon, and optional form/booking attributes).
• Use addItem for quick add-to-cart UX. If no cart exists, SDK creates it automatically.
• After cart is ready, continue with invoices.create() to move into checkout.

V2 contract notes

• cart.get() always sends required query identifier from stored cart credentials.
• Only send schedulerBookingAttributes when all required booking fields are present.
• updateItem accepts count = 0 to remove the target line-item.

Attribute map (form vs booking)

Methods

Get

Use: cart.get(options?).

Returns: SazitoResponse<Cart>.

const cartRes = await client.cart.get();
if (cartRes.error?.type === 'validation') {
  // No stored cart yet, create one or call addItem.
}

Create

Use: cart.create(input, options?).

const cartRes = await client.cart.create({
  variants: [
    { id: 12001, count: 2 },
    { id: 12009, count: 1, formAttributes: { engraving: 'SAZITO' } },
  ],
  coupon: 'WELCOME10',
});

Add Item

Use: cart.addItem(variantId, count, formAttributes?, options?).

const cartRes = await client.cart.addItem(12001, 1);

Add Item With Attributes

Use: cart.addItemWithAttributes(variantId, count, attributes?, options?).

addItemWithAttributes is the explicit add-to-cart API when you need to pass attributes object(s) in a structured way.

• Use addItem for simple quantity-only add.
• Use addItemWithAttributes when the product requires form answers, booking time fields, or both.
• It can create the cart automatically if no cart exists yet.

const cartRes = await client.cart.addItemWithAttributes(14022, 1, {
  formAttributes: { participantName: 'John Doe' },
  schedulerBookingAttributes: {
    eventEntityId: 987,
    startDateTimeLocal: '2026-03-10T10:00:00',
    endDateTimeLocal: '2026-03-10T11:00:00',
    timezone: 'Asia/Tehran',
  },
});

Update Item

Use: cart.updateItem(cartProductId, variantId, count, formAttributes?, options?).

const cart = await client.cart.get();
const first = cart.data?.items[0];

if (first) {
  await client.cart.updateItem(first.id, first.productVariantId, 3);
}

Update Item With Attributes

Use: cart.updateItemWithAttributes(cartProductId, variantId, count, attributes?, options?).

await client.cart.updateItemWithAttributes('12', 12001, 0, {
  deleteCoupon: true,
});

Remove Item

Use: cart.removeItem(cartProductId, variantId, options?).

const cart = await client.cart.get();
const first = cart.data?.items[0];

if (first) {
  await client.cart.removeItem(first.id, first.productVariantId);
}

Clear Cart

Use: cart.clearCart().

Clears persisted cart credentials only.

client.cart.clearCart();

Cart fields

Known errors

Examples

// app/lib/sazito-client.ts
import { createSazitoClient } from '@sazito/client-sdk';

export const sazito = createSazitoClient({
  domain: process.env.NEXT_PUBLIC_SAZITO_DOMAIN!,
});

// app/[lang]/(home)/page.tsx
'use client';
import { useEffect, useState } from 'react';
import { sazito } from '@/app/lib/sazito-client';

export default function Example() {
  const [data, setData] = useState<any>(null);

  useEffect(() => {
    sazito.cart.addItem(12001, 1).then((res) => setData(res.data ?? null));
  }, []);

  return <pre>{JSON.stringify(data, null, 2)}</pre>;
}

Type Details

The following tables are generated from SDK TypeScript types and include nested object fields.

CreateCartInput

Source: src/types/cart.ts

AddToCartInput

Source: src/types/cart.ts

Cart

Source: src/types/cart.ts

CartProduct

Source: src/types/cart.ts