Use cases

Mercur fits two kinds of business. Pick the one that matches yours; the modules underneath are the same.

Marketplace platform
Marketplace inside your store

You are building a marketplace from scratch, or replacing one. Mercur runs everything: the storefront, the operator admin, the vendor panel sellers log into, and the backend that splits every checkout into one order per seller, computes commissions and pays sellers out.

Three Mercur surfaces stacked back to front: the admin Sellers list, the vendor panel's Offers table for ACME, and the storefront product page for the Linen shirt listing the offers a shopper can buy.

Pick this when

You don’t have a store yet, or you want the marketplace to be the product
Sellers should get their own panel: offers, orders, fulfillment, payouts
You want one shared catalog that every seller lists against

What you get

Surface	Who uses it	Package
Storefront	Shoppers	Any framework on the Store API, or the starter storefront
Admin panel	Operators	`@mercurjs/admin`
Vendor panel	Sellers	`@mercurjs/vendor`
Backend	Everyone	`@mercurjs/core` on Medusa

Install Mercur

Create a marketplace project and run it locally.

Architecture

How the panels, the API and the modules fit together.

You already sell your own products on a platform like Magento. You want third-party sellers next to them, in the same product page and the same checkout, without moving your catalog or your payments. Your store stays the storefront; Mercur becomes the marketplace layer behind it.

A product page in your own store lists your warehouse next to two seller offers from ACME and GLOBEX. A wire leads from the seller rows to a Mercur order group with one order per seller; your own line never leaves your store.

Pick this when

Your store, checkout and payment provider are already live and should stay
You sell first-party stock and want sellers to compete on the same SKUs
Sellers need a panel, but shoppers should never notice a second system

Who runs what

Concern	Your store	Mercur
Catalog, prices, stock of your own products	✔
Storefront, cart, checkout, payment capture	✔
Sellers, their offers, their panel		✔
One order per seller, commissions, payouts		✔

Magento 2 integration

Install the connector and run a mixed first-party and seller order.

Order Group module

How one checkout becomes one order per seller.

Welcome

Legal

Install Mercur

Architecture

Magento 2 integration

Order Group module