Setting Up Your Store
Creating a Store
A storefront is a customer-facing online shop. Create one in Dashboard → Storefront or via API:
POST /api/v1/storefront/stores
{
"name": "PetCenter Serbia",
"slug": "petcenter-rs",
"catalog_id": 1,
"theme": {
"primaryColor": "#2563eb",
"logo": "https://..."
},
"checkout_config": {
"guest_checkout": true,
"require_phone": true
}
}
Your store will be available at: /store/petcenter-rs
Linking a Catalog
Each store is linked to one product catalog. The store displays all active products from that catalog. Organize products into store categories (which can differ from catalog structure).
Payment Methods
Storefronts use invoice-based payments (no Stripe for end customers):
- Bank Transfer (Virman): Customer receives an invoice with bank account details. After payment, merchant verifies manually or via bank statement upload.
- Cash on Delivery (COD / Pouzeće): Payment collected at delivery. Order is auto-confirmed.
Configure accepted payment methods in your store's checkout settings.
Customer Accounts
Customers can create accounts to track orders, save addresses, and manage wishlists. Customer authentication uses a separate JWT (type: customer): completely isolated from platform tokens.
- Registration with email + password
- Login returns customer JWT (8h expiry)
- Guest checkout available via
X-Cart-Sessionheader (no account needed)
Store Pages
The storefront includes 16 customer-facing pages: home, category listing, product detail, cart, checkout, order confirmation, order tracking, account, addresses, wishlist, reviews, and more, all at /store/[slug]/.