Core commerce modules
Mercur is built on top of Medusa’s core commerce modules.These modules provide the foundational commerce primitives used in every Mercur marketplace: products, pricing, carts, orders, customers, payments, fulfillment, inventory, and more. Mercur does not replace these modules.
Instead, it creates additional marketplace domain logic - such as sellers, commissions, order splitting, payouts, requests, reviews, and vendor-level operations. Below is an overview of every Medusa core module, along with a short description and a reference link to the official Medusa documentation where you can learn more about each module.
API Key Module
Handles API key management and authentication for programmatic access.
Auth Module
Provides authentication flows, hashing utilities, and identity management.
Cart Module
Manages carts, line items, promotions, and total calculations. Used by Mercur for multi-vendor cart orchestration.
Currency Module
Defines currencies and formatting rules.
Customer Module
Stores customer profiles, addresses, and preferences.
Fulfillment Module
Handles fulfillment providers and shipping. Mercur extends it with vendor-level fulfillment flows.
Inventory Module
Controls stock levels, reservations, and inventory adjustments.
Order Module
Manages orders, statuses, and returns. Mercur extends it with multi-seller order splitting logic.
Payment Module
Integrates payment providers and transaction flows. Used by Mercur for multi-vendor payments and payouts.
Pricing Module
Defines pricing structures, price lists, and contextual price calculations.
Product Module
Defines products, variants, options, and collections. Mercur adds seller ownership, moderation, and request flows.
Promotion Module
Handles discounts, promotion rules, and coupon codes.
Region Module
Manages regions, currencies, and tax settings for contextual pricing.
Sales Channel Module
Supports product availability across multiple sales channels.
Stock Location Module
Defines physical or virtual locations where inventory is stored.
Store Module
Stores global configuration and metadata for the storefront.
Tax Module
Manages tax rules and region-based tax calculations.
User Module
Handles internal user accounts. Mercur extends this with vendor roles and permissions.
By keeping all Medusa modules intact and fully accessible, Mercur ensures developers retain complete control over both the commerce layer and the marketplace domain layer.