DocumentationSetting Up Your Store

Setting Up Your Store

5 minLast updated: 2026-03-31

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-Session header (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]/.

Was this article helpful?