Backend

​

Backend overview

The backend is a robust, modular system built on top of MedusaJS that serves as the core engine of the platform. It’s designed to handle complex business logic, data management, and API integrations while providing a secure and scalable foundation for the entire application.

​

Architecture

Mercur backend comes as a set of plugins you can install into plain Medusa application. This plugin-based architecture was intentionally designed to make Mercur highly modular and easy to update. By breaking down functionality into discrete plugins, you can selectively install only the features your marketplace needs, maintain each component independently, and seamlessly adopt new updates without disrupting your entire system. After plugin installation and configuration, you can start the backend and use Mercur, or extend, modify and override its behaviour like you normally do in Medusa applications.

​

Customization

​

Workflows

Some of the Mercur workflows expose workflow hooks. You can utilize them to inject custom features into existing logic.

​

API

You can change the API content of Mercur in two ways. First, is to override by creating exactly the same route in the customization layer, and modify the behaviour. Second, you can create other endpoint and create your own logic. More on that topic can be found in Medusa docs.

​

Data models

Existing models created in Mercur can be extended by creating a separate module in your customization layer, and then linking them together. This approach is covered in Medusa docs.

​

API

The backend exposes three main APIs:

• Admin API: Provides administrative capabilities and system management.
• Vendor API: Built to resemble Admin API, this interface enables sellers to manage their own resources including orders, products, customer groups, promotions, and other marketplace-specific features. Each seller has access only to their own data and operations.
• Store API: Handles customer-facing operations and e-commerce functionality.

​

Actors

MercurJS recognizes three types of actors:

• User: this actor has all administrative privileges, and is the only actor type who can use the administration panel.
• Seller has access to the vendor panel. Each seller account is assigned to only one store it can manage.
• Customer is a regular marketplace user.

Using authentication middleware provided by Medusa, each API is protected from being used by incorrect actor.

​

Admin Panel Overview

The admin panel is built on top of Medusa’s admin framework, providing a powerful and extensible interface for managing your marketplace.

​

Custom Features

​

Commission System

Our platform includes a sophisticated commission management system that allows for flexible commission structures:

​

Marketplace commission settings

• Multiple Rule Types:
  • Seller-specific rules
  • Product category-based rules
  • Product type-based rules
  • Site-wide default rules
• Calculation Methods:
  • Percentage-based commissions
  • Flat-rate commissions
  • Tax-inclusive/exclusive options
  • Minimum and maximum commission limits

​

Marketplace Configuration

The marketplace configuration section allows administrators to manage global marketplace settings and rules:

​

Configuration Rules

• Product Request System: Toggle the product request submission system
• Product Approval Requirements: Enable/disable mandatory product approval
• Product Import: Control product import functionality

​

Requests Panel

The requests panel is a communication interface between sellers and marketplace administrator. They can request certain actions to be performed:

• New Seller Applications: Review a new seller account.
• New Product Submissions: Review a new product listings.
• Product Collection Request: Review a new product collection.
• Product Category Request: Review a new product category.
• Review Remove Request: Review a submission to remove unfair review.
• Product Type Request: Review a new product type.
• Product Tag Request: Review a new product tag.

Requests are submitted by sellers to the marketplace administrator for review. Once the administrator makes a decision, the action is automatically executed by the Mercur backend.

​

Sellers Panel

The sellers panel provides tools for managing marketplace vendors:

• Seller Profiles: View and manage seller information
• Store Suspension: Activate or suspend seller accounts
• Product Management: Oversee seller product listings
• Order Management: List seller orders
• Customer groups Management: List seller customer groups