Promotions & Campaign Management
Create, target, and manage complex promotions across products, channels, and customer groups - with a headless promotion engine built on Medusa and extended for marketplaces in Mercur. Mercur’s Promotions module gives you a central place to define how discounts, vouchers, and incentives work across your entire commerce stack. Instead of hard-coding promo logic in frontends or PSPs, you model rules and rewards once, then apply them consistently across all storefronts, markets, and vendors.
How you manage promotions in Mercur
Let growth, marketing, and revenue teams experiment with campaigns, while developers keep a clean, unified promotion engine.
With the Promotions module, you can:
- Define promotion campaigns with clear start/end dates, budgets, and scopes.
- Configure rules and conditions based on cart, products, customers, channels, regions, and more.
- Set actions / rewards such as percentage discounts, fixed amount off, free shipping, and gifts.
- Create and manage promotion codes / coupons (single-use, multi-use, per-customer limits, bulk code batches).
- Control stacking, priority, and exclusivity when multiple promotions are eligible.
- Target specific channels, regions, customer groups, or vendors for precise control.
- Run marketplace-wide campaigns or vendor-specific promos using the same underlying engine.
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 Promotions module delivers for your business
Central control over promotions
All your discounts and incentives are defined in one place and applied consistently across all storefronts and channels, instead of being re-implemented in each frontend.
Precise targeting and segmentation
Build promotions based on who the customer is, what they buy, where they buy, and how they buy. Combine cart, product, and customer conditions to match your real business logic.
Marketplace- and B2B-friendly logic
Support vendor-funded promos, operator-wide campaigns, and contract-based perks for B2B accounts. Decide who pays for the discount and where it applies.
Consistent and auditable discount calculations
Discounts and vouchers are calculated centrally in the backend and recorded on orders, making it easier to reconcile revenue, track performance, and debug edge cases.
API-first experimentation
Because the promotion engine is headless and accessible via API, you can integrate it with analytics, experimentation platforms, or custom dashboards to iterate on your commercial strategy.
Medusa-compatibility
Everything compatible with Medusa platform
Core capabilities
1. Promotion campaigns
Organize your incentives into campaigns that are easy to manage and monitor:
- Define campaigns with names, descriptions, active/inactive status, and validity dates.
- Group related promotion rules under a single campaign (e.g. “Black Friday 2025”).
- Schedule campaigns to start and end automatically, so frontends don’t need manual switches.
- Safely pause or stop campaigns from the admin without deploying new code.
2. Rules & conditions
Describe when a promotion should apply using flexible conditions:
- Cart-based conditions (subtotal thresholds, minimum item count).
- Product-based conditions (specific products, collections, or tags).
- Customer-based conditions (restrict eligibility to certain customer groups or segments).
- Channel & region conditions (limit promotions to specific sales channels or currencies).
3. Actions & rewards
Define what happens when promotion conditions are met:
- Order-level discounts (percentage or fixed amount off).
- Item-level discounts scoped to matching items.
- Quantity-based offers like "buy X get Y" or "3 for 2".
- Shipping promotions for free or reduced shipping rates.
- Gifts & bonuses added to cart via hooks.
4. Promotion codes / coupons
Use codes to control access to particular promotions:
- Create promo codes tied to a promotion or campaign.
- Configure usage limits: per code, per customer, or total redemptions.
- Generate bulk codes for unique one-time vouchers (e.g. loyalty programs).
- Combine code-based promotions with auto-applied rules.
5. Stacking, priority & exclusivity
Control how promotions interact when more than one is eligible:
- Assign priority to promotions to determine which should be evaluated first.
- Mark promotions as exclusive or stackable to prevent discount chaos.
- Ensure customers always receive the correct combination of promotions.
6. Targeting by channels & groups
Make sure the right customers see the right offers:
- Scope promotions to specific sales channels, regions, or currencies.
- Use customer groups to differentiate offers and perks (e.g. wholesale vs VIP).
7. Marketplace & vendor-specific promotions
Bring sophisticated promotion logic to marketplace environments:
- Let vendors run their own promotions on their products.
- Run operator-wide campaigns that apply across multiple vendors.
- Distinguish who funds the discount—vendor, operator, or shared.
8. Observability & audit
Understand how promotions behave:
- See which promotions were applied to each cart and order.
- Track who created or edited promotions and campaigns.
- Use order and promotion data to feed analytics and BI.
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.