Medusa js: headless commerce uitgelegd

Wat is Medusa precies?

Medusa is een gratis, open source e-commerceplatform dat draait op Node.js, dezelfde technologie waarmee moderne webapplicaties worden gebouwd. Het project ontstond als antwoord op een bekende frustratie: Shopify is fijn tot het moment dat je iets wilt dat Shopify niet standaard kan. Medusa geeft ontwikkelaars volledige vrijheid om elke winkelfunctie naar wens aan te passen, zonder licentiekosten, zonder maandelijkse platformkosten en zonder transactiefees aan een platform.

De term headless verdient uitleg. Bij een traditioneel webshopplatform zijn de winkelmotor en de vormgeving één geheel. Bij een headless platform is dat losgeknipt: Medusa levert de motor (producten, voorraad, bestellingen, betalingen) als een verzameling API's, koppelpunten waar andere software mee kan praten. De winkel die jouw klant ziet, bouw je er los bovenop. Vandaar de naam: het platform heeft zelf geen kop, die maak jij.

De architectuur, simpel uitgelegd

Denk aan een restaurant. De keuken is de Medusa-backend: daar liggen de recepten, de voorraad en de bestellingen. De eetzaal is jouw frontend: de webshop die bezoekers zien, meestal gebouwd in een modern framework zoals Next.js. De obers zijn de API's, die bestellingen van de zaal naar de keuken brengen en gerechten terug. Wil je de eetzaal verbouwen, dan hoeft de keuken niet dicht, en andersom net zo.

Het grote voordeel: één keuken kan meerdere zalen bedienen. Dezelfde Medusa-backend voedt tegelijk je webshop, je mobiele app, een kassasysteem in je fysieke winkel en een B2B-bestelportaal, allemaal met dezelfde actuele voorraad en prijzen. Voor content werkt dat net zo: veel Medusa-shops combineren de commerce-backend met een apart systeem voor teksten en pagina's, zoals beschreven in beste headless CMS. Dat scheelt dubbel werk en voorkomt fouten in voorraad en prijzen.

Wanneer Medusa een slimme keuze is

Medusa loont wanneer standaardplatformen gaan knellen. Denk aan een unieke checkout-flow: abonnementen, productconfiguratoren, offerteaanvragen of een bestelproces in meerdere stappen dat precies jouw werkwijze volgt. Dit soort eisen kost bij Shopify een stapel apps en compromissen; in Medusa bouw je het exact zoals jouw proces werkt, omdat de broncode gewoon van jou is. Denk aan een meubelmaker met een configurator voor maatwerkkasten, of een groothandel die offertes automatisch wil omzetten in bestellingen.

De tweede sterke kant is B2B-logica. Klantspecifieke prijslijsten, staffelkortingen, bestellen op rekening, goedkeuringsflows binnen het bedrijf van je klant: zakelijke verkoop stelt eisen waar consumentenplatformen niet voor zijn ontworpen. En verkoop je via meerdere kanalen, van webshop tot app tot marktplaats, dan bedient één Medusa-backend ze allemaal vanuit dezelfde voorraad en productdata. Medusa heeft die B2B-bouwstenen standaard aan boord, waar je ze bij consumentenplatformen met losse apps moet nabootsen.

Ook financieel kan het kloppen. Medusa rekent geen platformkosten en geen transactiefees, alleen je eigen hosting. Een shop met flinke omzet betaalt bij een huurplatform ieder jaar meer, terwijl de kosten van een eigen platform stabiel blijven. En alles is eigendom: code, data en klanten staan op jouw infrastructuur, niet op de servers van een Amerikaans platform dat zijn voorwaarden kan wijzigen.

Wanneer Medusa overkill is

Eerlijk is eerlijk: voor de meeste mkb-webshops is Medusa niet nodig. Verkoop je producten met een standaard winkelmandje, standaardverzending en iDEAL, dan ben je met WooCommerce sneller live, goedkoper uit en flexibeler in het dagelijkse beheer. Een standaardshop op Medusa bouwen is een raceauto kopen voor woon-werkverkeer. De volledige afweging tussen de gevestigde platformen lees je in WooCommerce, Shopify of Magento. Reken jezelf dus niet rijk aan techniek die je niet nodig hebt.

Houd ook rekening met de afhankelijkheid van ontwikkelaars. Medusa kent geen pluginwereld zoals WordPress; elke aanpassing, hoe klein ook, is ontwikkelwerk. Je team kan producten, prijzen en bestellingen prima zelf beheren via het beheerpaneel, maar een extra veld in de checkout of een nieuwe kortingsregel loopt via een developer. Zonder vaste technische partner of eigen developer wordt dat op termijn frustrerend en duur. Plan die capaciteit dus vooraf in, niet achteraf.

Wat kost een Medusa-traject?

De software is gratis, het werk zit in de bouw. Een Medusa-traject is maatwerk: backend inrichten, koppelingen leggen met betaalprovider en verzendpartij, en een eigen frontend ontwerpen en bouwen. Bij Volstoom valt zo'n traject onder webapplicatie laten maken en begint het vanaf €6.500. Een complete webshop met eigen design en meerdere koppelingen komt realistisch uit tussen de €10.000 en €25.000, afhankelijk van de eisen. Vraag altijd een vaste prijs op basis van een duidelijke scope, zodat je niet voor verrassingen komt te staan.

Daar staat tegenover dat de maandlasten laag zijn: hosting vanaf enkele tientjes per maand, en geen fees die met je omzet meegroeien. Voor een shop met serieuze omzet kan de rekensom daardoor verrassend snel positief uitvallen. Vergelijk daarom altijd over drie tot vijf jaar, niet alleen op de bouwprijs. Hoe je zo'n vergelijking opzet, inclusief alle verborgen kosten, lees je in wat kost een webshop. Zeker als je huidige platform maandelijks honderden euro's aan fees kost, loont die rekensom.

Ecosysteem en volwassenheid anno 2026

Medusa is inmiddels een volwassen platform. Versie 2 bracht een herbouwde, snellere kern, er is een grote internationale community van ontwikkelaars en voor gangbare behoeften zoals betaalproviders, zoekfuncties en e-mail bestaan kant-en-klare modules. Ook grotere merken durven het aan voor hun maatwerk-commerce, wat het ecosysteem verder versterkt. Het is geen experiment meer, maar een serieuze bouwsteen voor wie maatwerk-commerce wil. Vraag je bouwer wel naar eerdere Medusa-projecten en referenties, want ervaring maakt hier het verschil.

De eerlijke kanttekening: het ecosysteem is nog altijd veel kleiner dan dat van WooCommerce of Shopify. Er zijn minder Nederlandse bureaus met aantoonbare Medusa-ervaring, minder kant-en-klare integraties met Nederlandse pakketten en minder antwoorden op internet als iets stuk gaat. Kies je voor Medusa, kies dan vooral ook voor een partner die het platform aantoonbaar kent en die er over vijf jaar nog is.