🐙
Docs

OmniCart

Connect your Medusa v2 headless commerce store to manage orders, products, customers, collections, and draft orders — all from the WebOS desktop.

#What's included

  • Orders — list, search, view details, cancel, complete, and archive orders
  • Products — browse your product catalog with variants, options, and pricing
  • Customers — view customer profiles, addresses, and order history
  • Collections — manage product collections and their associated products
  • Draft Orders — create and manage draft orders, convert them to live orders
  • Store Overview — real-time metrics for order count, revenue, customers, and products
  • Store Settings — view store configuration, currencies, and region info

#About OmniCart

OmniCart is a headless commerce platform built on Medusa v2. Unlike traditional ecommerce platforms, Medusa separates the storefront from the backend — giving you full control over your customer-facing experience while Delegate provides the admin panel.

The OmniCart integration connects directly to your Medusa instance's Admin API, so you can manage your entire commerce operation from the Delegate WebOS desktop alongside your other business tools.

#Prerequisites

  • A running Medusa v2 instance (self-hosted or cloud)
  • An admin user account with email and password
  • The base URL of your Medusa instance (e.g. https://api.my-store.com)
ℹ️Note
OmniCart requires the Marketing & Commerce bundle in your workspace subscription. Check Settings → Billing to verify your plan includes this bundle.

#Connecting OmniCart

1

Open the OmniCart app in WebOS

Launch WebOS and find OmniCart in the app launcher under the E-Commerce category. You can also press Cmd+K and type "OmniCart".
2

Enter your Medusa credentials

Fill in the connection form with:
  • Base URL — your Medusa instance URL (e.g. https://api.my-store.com). Do not include /admin at the end.
  • Admin Email — the email address of your Medusa admin user
  • Admin Password — the password for your Medusa admin user
  • Account Label (optional) — a friendly name like "Production Store" or "Staging"
3

Click Connect OmniCart

Delegate validates your credentials by authenticating with your Medusa instance and fetching store info. If successful, you'll see the OmniCart dashboard.
💡Tip
You can connect multiple OmniCart accounts (e.g. production and staging). Use the account selector in the sidebar to switch between them.

#Managing orders

The Orders panel shows all orders from your Medusa store. Use the search bar to find orders by ID or email, and filter by status (Pending, Completed, Cancelled).

Click any order to view its full details including:

  • Line items with quantities and pricing
  • Payment and fulfillment status
  • Shipping address
  • Order timeline

Available actions on an order:

  • Complete — mark the order as completed
  • Cancel — cancel the order (with optional reason)
  • Archive — archive the order to hide it from the default view
⚠️Warning
Cancelling an order cannot be undone. Make sure to process any necessary refunds through your payment provider before cancelling.

#Browsing products

The Products panel displays your product catalog. Each product shows its title, status (Published, Draft, Proposed), and thumbnail.

Click a product to see:

  • Product variants with SKU, pricing, and inventory counts
  • Product options (Size, Color, etc.)
  • Associated collection

#Customer management

The Customers panel lists all customers with their email, name, and registration status. Click a customer to view their saved addresses and order history.

Customers are labeled as Registered (have an account) or Guest (checkout-only).

#Draft orders

Draft orders let you create orders on behalf of customers before processing payment. Use the Convert to Order button to turn a draft into a live order.

ℹ️Note
Draft order creation is done through your Medusa admin or storefront. Delegate provides viewing, management, and conversion capabilities.

#Demo mode

Don't have a Medusa instance yet? Click Try Demo Mode on the connect screen to explore all panels with sample data. Demo mode is read-only and doesn't connect to any real store.

#How authentication works

OmniCart uses JWT-based authentication. When you connect your store, Delegate encrypts and stores your admin credentials. On each API call, Delegate authenticates with your Medusa instance to obtain a short-lived JWT token.

  • Tokens are cached for 55 minutes (Medusa JWTs typically expire after 1 hour)
  • If a token expires mid-session, Delegate automatically re-authenticates
  • Credentials are encrypted at rest using AES-256
⚠️Warning
Your admin password is stored encrypted in Delegate's database. For maximum security, consider creating a dedicated Medusa admin user for the Delegate integration with only the permissions you need.

#Disconnecting

To disconnect an OmniCart account, click the account selector in the app sidebar and select Remove. This deletes the stored credentials from Delegate. Your Medusa store is unaffected.

#Troubleshooting

  • Connection failed (422) — double-check your base URL, email, and password. Make sure the URL doesn't end with /admin.
  • Access denied (403) — verify your workspace has the Marketing & Commerce bundle enabled.
  • Orders not loading — confirm your Medusa instance is running and accessible from the internet. Self-hosted instances behind a firewall may not be reachable.
  • Stale data — click the refresh button in the sidebar to re-fetch data from your Medusa instance.

Previous

Notion

Next

AI Agents

Delegate DocsWas this helpful? Give feedback →