Price Lists & Contract Pricing
Model base prices, regional prices, and contract pricing in one headless price list engine - built on Medusa and extended for B2B and marketplaces in Mercur. Mercur’s Price Lists module is where you decide how much you charge for each product in different regions, channels, and customer segments. Instead of hard-coding prices in storefronts or burying them inside ERP, you keep one pricing brain that all channels can query via API.
How you manage price lists in Mercur
Give your commercial and operations teams a flexible way to manage pricing - without shipping a new release every time a price changes.
With the Price Lists module, you can:
- Create base price lists for products and variants that reflect your standard pricing.
- Define regional and currency-specific prices for different markets.
- Attach price lists to customer groups, B2B accounts, or sales channels.
- Manage campaign and sale price lists alongside long-term contract pricing.
- Override or complement default prices defined on products.
- Use price lists as the foundation for B2B contracts and marketplace vendor pricing, keeping clear separation between base, contract, and promotional logic.
Build custom marketplace with Mercur
Create your unique multi-vendor platform with our powerful, flexible marketplace solution that adapts to your business needs.
What the Price Lists module delivers for your business
One pricing model across all channels
Instead of maintaining separate price tables in each storefront, app, or integration, Mercur gives you a single source of truth that every channel can read from.
Support for complex B2B & contract pricing
Price lists can be bound to customer groups, B2B accounts, and regions—making it easy to model contract pricing, volume deals, and key account conditions.
Marketplace-ready vendor pricing
Multiple vendors can share the same product catalog while having their own price lists. Operators can keep reference prices, while vendors maintain their own sell prices.
Safe experimentation & campaigns
Campaign price lists can be layered on top of base and contract pricing, so you can run sales and temporary deals without touching core prices.
API-first integration
Other systems—ERP, billing, CPQ, quoting tools—can query, export, or sync prices directly from the Price Lists engine instead of recalculating them on their own.
Medusa-compatibility
Everything compatible with Medusa platform
Core capabilities
1. Price list data model
A flexible structure for describing pricing in different contexts:
- Price list entity with name, description, and status (draft, active, archived).
- Type of price list (e.g. base, override, contract, campaign/sale).
- Links to products and variants, so each SKU can have multiple context-specific prices.
- Metadata for custom rules (e.g. contract ID, account manager, internal pricing notes).
2. Base & override pricing
Separate your "default" prices from overrides:
- Use product-level prices or a base price list as your standard pricing layer.
- Create override price lists that replace base prices for specific customers, channels, or markets.
- Define priority and resolution rules so Mercur knows which price should be used when multiple lists apply.
- Safely adjust prices for selected segments without touching the underlying product data.
3. Regional & currency-based pricing
Model pricing for multiple regions and currencies:
- Set prices in different currencies for each region you operate in.
- Use region-specific price lists to reflect local positioning, competition, and costs.
- Define how the system should behave when a region-specific price is missing.
- Keep regional and currency differences in the backend instead of multiplying storefront code.
4. Customer group & account pricing
Align pricing with the way you segment customers:
- Attach price lists to customer groups such as wholesale, VIP, partner, or employee.
- Implement B2B account- or contract-specific price lists for key customers.
- Combine region + customer group + channel to create highly targeted pricing rules.
5. Campaign & time-bound price lists
Run sales and promotions on top of your standard pricing:
- Create campaign price lists with start and end dates.
- Temporarily override base or contract prices for the campaign duration.
- Use campaign price lists in combination with the Promotions module.
6. Marketplace & vendor pricing
Handle multi-vendor pricing scenarios cleanly:
- Maintain separate price lists per vendor for shared products.
- Use operator-managed reference prices alongside vendor’s own price lists.
- Lay the groundwork for commission models and payouts.
7. Rounding, taxes & display
Make sure prices look and behave correctly in frontends:
- Decide whether prices in price lists are stored as net or gross amounts.
- Implement rounding rules via hooks, so displayed prices look consistent.
- Expose resolved prices to storefronts in a clean format.
Build custom marketplace with Mercur
Schedule a guided tour of Mercur Marketplace tailored to your specific marketplace requirements. Connect with our team to discuss how we can help bring your marketplace vision to life.