For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /docs/mobile/commerce.md (or send Accept: text/markdown).
Commerce on mobile
Manage store products and orders for the workspace.
Products
GET and POST on /api/mobile/commerce/products list and create products — owner and admin only. A new product starts as a draft; prices enter as strings and store as cents with two-decimal precision, and inventory tracking is optional. Products are never deleted: archived is the removal state, and PATCH updates fields and status — draft, active, archived — together.
Orders move forward only
GET /api/mobile/commerce/orders lists orders; they are created by the store checkout, never by the app. PATCH advances the state forward-only — pending to paid to fulfilled — with cancelled allowed before payment and refunded after. Cancelling restocks tracked inventory in the same transaction, and an illegal transition is a silent no-op rather than an error the user must dismiss.
Verification and troubleshooting
Sell through the public checkout, advance the order on mobile, and confirm stock returns when a pending order is cancelled. Members below admin cannot reach the surface at all — verify they see it as unavailable rather than empty.