Skip to main content
POST
Advance the checkout state machine

Authorizations

Authorization
string
header
required

Dashboard JWT token from Clerk

Body

application/json
cart
object
required

Serializable omnichannel cart snapshot. Derived fields (subtotal, itemCount, …) are re-computed server-side and never trusted.

event
enum<string>
required
Available options:
ADD_ITEM,
REMOVE_ITEM,
INITIATE_CHECKOUT,
REQUEST_PAYMENT,
PAYMENT_CONFIRMED,
FULFILL,
ABANDON,
CANCEL,
RESUME

Response

200 - application/json

The cart after the transition.

data
object
required

Serializable omnichannel cart snapshot. Derived fields (subtotal, itemCount, …) are re-computed server-side and never trusted.

meta
object
required