Skip to main content
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.

​
Store Status Values

StatusDescription
activeStore is live and operational
inactiveStore is disabled by the merchant; data is preserved but checkout is unavailable
suspendedStore is suspended by a platform admin; merchant cannot reactivate

​
Role-Based Access Control

Each merchant in a store is assigned one of three roles. The store creator is automatically assigned owner.
Permissionowneradminmember
Read store detailsYesYesYes
Update store settingsYesYesNo
Delete storeYesNoNo
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).