API Reference

Storefront checkout

Public storefront checkout for a published store slug.

POST/api/storefront/{slug}/checkout

Place a storefront order (guest or logged-in customer).

Auth: Public

Field	Type	Description
`items`required	array	Cart lines with price and quantity.
`totalAmount`required	number	Client-reported total (server recalculates with coupons).
`customerInfo`required	object	email (required), firstName, lastName, phone.
`shippingAddress`	object	name, phone, address fields.
`paymentMethod`	string	e.g. cod, vodafone_cash, instapay.
`couponCode`	string	Optional coupon.
`attribution`	object	Optional attribution payload merged into notes.

Email and phone are required. Optional storefront auth cookie can enrich the customer.