Carts

Create an anonymous cart, add and update line items, and read the current cart with computed totals. Carts are identified by the X-Cart-Token returned when the cart is created.

Feature requirement: the project must have the commerce feature enabled, or these endpoints return 404.

Send X-Cart-Token on every cart and checkout request after the cart is created.
Totals, taxes and discounts are computed server-side — do not calculate them in the client.

POST/api/v1/storefront/projects/{project_slug}/carts

Create Cart

Parameters
Name	Type	In	Description
project_slug	string	path	Required.

Request body · CartCreate
Field	Type		Description
email	string (nullable)	optional	—

Response 201 (list) · CartItemRead[]
Field	Type		Description
id	string	required	—
variant_id	string	required	—
product_id	string	required	—
product_name	string	required	—
variant_title	string	required	—
sku	string	required	—
quantity	integer	required	—
unit_price_minor	integer	required	—
line_total_minor	integer	required	—
currency	string	required	—

Example request

curl -X POST "https://api.webtools.ng/api/v1/storefront/projects/your-project/carts" \
  -H "X-Project-Key: wt_pk_your_key" \
  -H "Content-Type: application/json" \
  -d '{ "email": "…" }'

GET/api/v1/storefront/projects/{project_slug}/carts/current

Get Cart

Parameters
Name	Type	In	Description
project_slug	string	path	Required.
x-cart-token	string (nullable)	header	Optional.

Response 200 (list) · CartItemRead[]
Field	Type		Description
id	string	required	—
variant_id	string	required	—
product_id	string	required	—
product_name	string	required	—
variant_title	string	required	—
sku	string	required	—
quantity	integer	required	—
unit_price_minor	integer	required	—
line_total_minor	integer	required	—
currency	string	required	—

Example request

curl "https://api.webtools.ng/api/v1/storefront/projects/your-project/carts/current" \
  -H "X-Project-Key: wt_pk_your_key"

POST/api/v1/storefront/projects/{project_slug}/carts/current/items

Add Item

Parameters
Name	Type	In	Description
project_slug	string	path	Required.
x-cart-token	string (nullable)	header	Optional.

Request body · CartItemCreate
Field	Type		Description
variant_id	string	required	—
quantity	integer	required	—

Response 200 (list) · CartItemRead[]
Field	Type		Description
id	string	required	—
variant_id	string	required	—
product_id	string	required	—
product_name	string	required	—
variant_title	string	required	—
sku	string	required	—
quantity	integer	required	—
unit_price_minor	integer	required	—
line_total_minor	integer	required	—
currency	string	required	—

Example request

curl -X POST "https://api.webtools.ng/api/v1/storefront/projects/your-project/carts/current/items" \
  -H "X-Project-Key: wt_pk_your_key" \
  -H "Content-Type: application/json" \
  -d '{ "variant_id": "…", "quantity": 0 }'

PATCH/api/v1/storefront/projects/{project_slug}/carts/current/items/{item_id}

Update Item

Parameters
Name	Type	In	Description
project_slug	string	path	Required.
item_id	string	path	Required.
x-cart-token	string (nullable)	header	Optional.

Request body · CartItemUpdate
Field	Type		Description
quantity	integer	required	—

Response 200 (list) · CartItemRead[]
Field	Type		Description
id	string	required	—
variant_id	string	required	—
product_id	string	required	—
product_name	string	required	—
variant_title	string	required	—
sku	string	required	—
quantity	integer	required	—
unit_price_minor	integer	required	—
line_total_minor	integer	required	—
currency	string	required	—

Example request

curl -X PATCH "https://api.webtools.ng/api/v1/storefront/projects/your-project/carts/current/items/{item_id}" \
  -H "X-Project-Key: wt_pk_your_key" \
  -H "Content-Type: application/json" \
  -d '{ "quantity": 0 }'

← All resource groups