Medusa.js e-commerce marketplace · 2025

Advanced multivendor e-commerce platform on Medusa.js

Artovnia is a cutting-edge multivendor e-commerce platform based on Medusa.js, purpose-built for artists, makers, and small custom manufacturers. Designed to empower independent creators, it provides them with a modern, reliable, and feature-rich space to showcase and sell their work online.

Mockup prezentujący Artovnia marketpalce zbudowany na Medusa.js
Medusa.jsNext.jsPostgreSQLRedisRailwayNode.js+3 more
Project type
Medusa.js e-commerce marketplace
Year
2025
Technologies
9
Status
Live
Case study

Artovnia – marketplace with a custom billing system, built for scale

Artovnia is a marketplace platform on Medusa.js, for artists, makers, and small brands, designed from the ground up as a system built around the real needs of sellers and e-commerce operations, not as a layer on top of a ready-made solution.

The project started as an MVP but quickly grew into a fully-fledged sales system with its own architecture, financial logic, and a complete toolset for sellers. The core assumption was to build a platform that wouldn't require refactoring as it scaled, just be ready for it from day one.

Payments

Custom payment and marketplace settlement system

One of the hardest and most important parts of the project was implementing a custom settlement system built on Stripe Connect Express.

The platform handles:

  • custom split payment logic across multiple sellers within a single payment
  • delayed payouts tied to the return policy (14 days)
  • fully configurable commission logic, globally and per seller
  • a loyalty points system where the platform covers the cost, not the seller
  • a referral system that automatically reduces commissions for new and referring sellers for a period defined in config

Funds are managed through Stripe and don't reach a bank account until a transaction is fully settled, which simplifies the legal and operational side.

This isn't an off-the-shelf integration, it's a dedicated financial system designed around the marketplace model.

Click to zoom

Architecture

Marketplace architecture and sales logic

Artovnia operates as a multi-vendor platform with full seller separation.

Separate seller accounts

Every seller has their own profile, catalog, and sales configuration.

Individual sales settings

Individual pricing, promotions, shipping, and sales settings.

One cart, split orders

One customer cart, automatically split into per-seller orders.

One payment, many settlements

One payment, multiple settlements in the background.

Seller landing pages

Sellers can also build their own landing pages within the platform, giving them significantly more control over how they present their offer.

Seller panel

Advanced seller dashboard and automations

The platform offers a comprehensive seller panel that supports day-to-day sales and operations:

  • product management (including rich text editor and SEO descriptions)
  • order, customer, and return management
  • promotion system (discounts, free shipping, per-customer offers)
  • abandoned cart detection with the ability for sellers to act on it
  • messaging system and support tickets
  • vacation mode and seller availability
  • sales and earnings analytics
  • onboarding and process automations

This is a level of functionality that goes beyond what most standard marketplace solutions offer.

Click to zoom

Commissions and attribution

Share & Save: a lower commission on traffic you bring yourself

The seller brings the customer, so the seller pays a lower commission. Share & Save combines affiliate links, QR codes, marketing assets, and secure order attribution with the marketplace commission system.

Artovnia rewards sellers who bring in customers on their own. Every seller can share a link to their shop or to a single product, use a QR code, or generate ready-made assets for print and social media. When a customer reaches Artovnia through such a link and completes an attributed purchase, the seller's standard commission drops from 18% to 13% + VAT.

The mechanism works at the level of individual seller products and a single order. Attribution is carried from the storefront all the way to the final commission calculation, with support for multiple sellers in one cart, retries, concurrent orders, and a full audit trail of commission changes.

In the seller dashboard, Share & Save is wired into a marketing asset generator: the link and QR code plus graphics and print-ready materials for social media, parcel inserts, fairs, and market stalls.

Click to zoom

Results

Performance and scaling

~1.4 s

LCP (desktop)

200-300 ms

TTFB on the product page

<100 ms

Most backend requests

Scaling

Architecture built for high traffic

The platform was designed with scaling in mind from day one. Key elements:

Layered caching

Aggressive caching strategies (Redis, layered cache).

On-demand revalidation

On-demand data revalidation triggered by system changes.

ISR for most pages

ISR for most pages (Next.js).

Search on Algolia

Algolia integration for search and listings.

Backend request optimization

Backend request optimization across the whole platform.

During development the backend went through significant optimization, from requests hanging at several seconds to a stable and predictable system.

AI

AI in the CMS and seller panel

The platform uses AI in a practical way:

  • content, SEO, and article generation in the CMS (Sanity)
  • contextual support based on existing content
  • product description generation and optimization in the seller panel
  • content quality audits for SEO

It's not a throwaway feature, it's a tool that genuinely increases seller efficiency.

Click to zoom

Stack

Integrations and supporting systems

The platform has been extended with a number of modules and integrations. The architecture is based on Medusa.js, extended with dozens of dedicated modules handling specific business functions.

Frontend

Next JSReact JSTypescriptCSS + TailwindZod

Backend

Node JSMedusa.jspostgreSQL

Infrastructure

RailwayAWS S3Redis

Integrations

Stripe Connect ExpressAlgoliaBaselinkerResendNotifications and eventsTracking systems
Product approach

A product-first approach, not a platform for everyone

Artovnia wasn't designed as a marketplace built to maximize ad revenue or satisfy investors.

It's a platform that is:

  • focused on sellers and their control over sales
  • transparent about costs
  • compliant with EU requirements (GDPR, Omnibus, KYC/AML, DAC7)
  • free of ads and dark patterns

The goal was to build an environment that genuinely supports creators rather than holding them back.

Click to zoom

My role

Scope of responsibility

As the full-stack developer I was responsible for the entire implementation, including:

01

Backend architecture and marketplace system design

02

Payment and settlement system

Design and implementation of the payment and settlement system.

03

Sales logic and marketplace modules

04

Seller dashboard and user experience

05

Performance optimization and scalability

06

External system integrations

07

AI implementation in the CMS and seller panel

Summary

Artovnia is a project built iteratively, from MVP to a fully-fledged marketplace system, where every technical decision was driven by real constraints and business needs, not by convenience of implementation.

It's an example of building an e-commerce platform from scratch, with its own financial, operational, and product logic, designed with scale in mind.

Planning a marketplace of your own?

Artovnia was built from scratch, with its own financial, operational, and product logic, designed with scale in mind.

Get in touch