Stores are the top-level entity for organizing products, orders, and checkout experiences. Each merchant can own up to 20 stores, and each store has its own webhook, notification, and checkout theme settings.Documentation Index
Fetch the complete documentation index at: https://docs.waffo.ai/llms.txt
Use this file to discover all available pages before exploring further.
Store Status Values
| Status | Description |
|---|---|
active | Store is live and operational |
inactive | Store is disabled by the merchant; data is preserved but checkout is unavailable |
suspended | Store is suspended by the platform; merchant cannot reactivate |
Role-Based Access Control
Each merchant in a store is assigned one of three roles. The store creator is automatically assignedowner.
| Permission | owner | admin | member |
|---|---|---|---|
| Read store details | Yes | Yes | Yes |
| Update store settings | Yes | Yes | No |
| Delete store | Yes | No | No |
| Create store | — | — | — |
Store creation is not role-gated — any authenticated merchant can create a new store (up to the 20-store limit). Roles only apply to operations on existing stores.
Endpoints
Create Store
Create a new store for the authenticated merchant.
Update Store
Update store name, status, or configuration settings.
Delete Store
Soft-delete a store (owner only).