Co to jest Medusa.js i kiedy warto zbudować na niej sklep?

Co to jest Medusa.js?

Medusa.js to otwarty silnik e-commerce napisany w Node.js i TypeScript, rozwijany przez firmę MedusaJS, Inc. Daje backend sklepu internetowego, czyli dane i reguły produktów, koszyka, zamówień, cen, magazynu i klientów, a do tego panel administracyjny i framework do dopisywania własnej logiki.

Medusa.js nie daje gotowego sklepu, który wystarczy włączyć. Strony, które widzi klient, to osobna aplikacja: buduje ją twój zespół albo partner i łączy z Medusą przez API. To główna różnica wobec Shopera, IdoSell i Shopify, gdzie sklep, hosting i panel kupujesz jako jeden abonament.

Strona główna Medusy pokazuje wśród użytkowników marki takie jak Heineken, Mitsubishi Motors, Spar i Eight Sleep, ale nie mówi, jaka część ich sprzedaży działa na Medusie. Taka lista jest sygnałem, a nie dowodem, że Medusa pasuje do twojej skali.

Nazwę Medusa.js zobaczysz też w pisowni MedusaJS. Jeśli porównujesz już wykonawców, na stronie wdrożenia Medusa.js opisujemy, jak budujemy na niej sklepy.

Jak działa Medusa v2, bez żargonu

Medusa v2 ma trzy warstwy: moduły przechowujące dane, workflowy prowadzące procesy oraz osobny panel i sklep, z których korzystają ludzie.

Moduły to klocki sklepu

Moduł w Medusie to samodzielna część sklepu, na przykład produkty, koszyk, zamówienia, ceny, magazyn albo klienci. Każdy moduł ma własne dane i reguły, a developer może go rozszerzyć, wymienić albo dopisać obok nowy.

Dla firmy modułowa budowa Medusy oznacza, że reguły cen kontraktowych zmieniasz w module cen bez dotykania zamówień i magazynu, a brakująca funkcja, na przykład opinie o produktach, staje się nowym modułem. Na tym przykładzie pokazujemy, co Medusa daje jako szkielet, a co sklep musi dobudować.

Workflowy prowadzą procesy firmy

Workflow w Medusie to wieloetapowy proces biznesowy zapisany w kodzie, na przykład: przyjmij zamówienie, zarezerwuj stan, wyślij zamówienie do ERP, potwierdź klientowi. Każdy krok może określić, jak cofnąć własne zmiany. Gdy późniejszy krok zawiedzie, workflow wycofuje kroki już wykonane i sklep nie trzyma rezerwacji dla zamówienia, które nie dotarło do ERP.

Workflowy Medusy mają największe znaczenie przy integracjach: gdy sklep wymienia z ERP zamówienia, ceny i dane do faktur, każdy błąd ma opisaną ścieżkę naprawy zamiast ręcznej poprawki w dwóch systemach.

Panel i sklep to dwie osobne aplikacje (headless)

Medusa jest platformą headless commerce: backend udostępnia API, panel administracyjny można rozszerzać o własne ekrany, a sklep widoczny dla klienta (storefront) to osobna aplikacja, na przykład w Next.js. Dokumentacja wdrożenia Medusy każe wdrażać storefront osobno od backendu.

Sklep headless na Medusie nie jest związany z systemem motywów, więc ścieżkę zakupu projektujesz bez ograniczeń szablonu. Storefront to jednak druga aplikacja do zbudowania, hostowania i utrzymania, dlatego wpisz ją do budżetu od początku.

Co się zmieniło między v1 a v2

Medusa v2.0.0 wyszła 23 października 2024 roku, ostatnie wydanie v1 (v1.20.11) pochodzi z 20 stycznia 2025, a aktualna wersja to v2.21.2 z 28 września 2026, według listy wydań Medusy. Medusa v2 przebudowała platformę wokół modułów i workflowów, więc to inna architektura, a nie wyższy numer wersji.

Poradniki, kursy i artykuły agencji sprzed października 2024 często opisują Medusę v1. Jeśli masz już sklep na v1, zaplanuj przejście na v2 jak osobny projekt z własnym zakresem i budżetem.

Co Medusa daje w standardzie, a co trzeba zbudować

Medusa daje w standardzie rdzeń sklepu i panel administracyjny, a twój zespół albo partner buduje storefront i te części, którymi twój proces różni się od cudzego.

W sprzedaży B2B przepis Medusy na sklep B2B wymienia grupy klientów, cenniki i kanały sprzedaży jako funkcje wbudowane, a firmy i ich pracowników opisuje jako własny moduł. Model firmy kupującej, czyli kto może zamawiać i kto akceptuje zamówienie, buduje się osobno, co opisujemy na stronie platforma B2B.

Storefront, konta firmowe, integracja z ERP i ekrany panelu to praca do wykonania, dlatego projekt na Medusie kosztuje na starcie więcej niż abonament gotowej platformy.

Medusa.js a polskie integracje: płatności, dostawy, ERP i KSeF

Polskie płatności, dostawy, ERP i KSeF da się podłączyć do sklepu na Medusie, ale tylko część jest gotowa: reszta to wtyczka społeczności albo integracja do zbudowania.

Płatności. Oficjalny moduł Stripe w Medusie rejestruje BLIK i Przelewy24 jako osobne metody płatności, obok kart. Bezpośrednia umowa z Przelewy24, PayU albo Tpay to integracja do zbudowania albo wtyczka społeczności. Prowizję od transakcji pobiera operator płatności, a nie Medusa.

Dostawy i sprzedaż wielokanałowa. Katalog integracji Medusy pokazuje wtyczki do InPostu i BaseLinkera (Base.com), ale obie napisał zewnętrzny autor, a nie MedusaJS, Inc. W rejestrze npm wtyczki InPost i BaseLinker są opisane jako zgodne z Medusą v2 i mają numer wersji poniżej 1.0 (stan na 7 października 2026).

Wtyczka społeczności do Medusy to nie to samo co integracja w cenie abonamentu Shopera albo IdoSell. Autor wtyczki nie ma obowiązku nadążać za kolejnymi wersjami Medusy, a opis wtyczki Przelewy24 w katalogu zastrzega wprost, że nie była testowana na działającym sklepie. Zanim oprzesz na wtyczce sprzedaż, zapytaj wykonawcę, kto ją utrzymuje.

ERP i księgowość. Comarch ERP i Subiekt (InsERT) to przykłady systemów, z którymi polski sklep wymienia zamówienia, stany, ceny i dokumenty. W katalogu integracji Medusy nie znaleźliśmy wtyczek do żadnego z nich (stan na 7 października 2026), więc integrację sklepu z ERP buduje się jako workflow z opisaną ścieżką na wypadek błędu.

KSeF. Medusa nie wystawia w standardzie faktur w Krajowym Systemie e-Faktur. Fakturę na podstawie zamówienia ze sklepu wystawia system księgowy albo ERP, więc KSeF jest częścią integracji z tym systemem, a nie funkcją sklepu. Według harmonogramu Ministerstwa Finansów KSeF obowiązuje największe firmy od 1 lutego 2026, pozostałe od 1 kwietnia 2026, a najmniejsze, ze sprzedażą na fakturach do 10 000 zł miesięcznie, od 1 stycznia 2027.

Gdzie działa sklep na Medusie: Medusa Cloud czy własna chmura

Sklep na Medusie działa albo w Medusa Cloud, zarządzanym hostingu od MedusaJS, Inc., albo na infrastrukturze, którą ty lub twój partner prowadzicie na własnym koncie w chmurze.

Medusa Cloud: miesięczny plan plus zużycie

Medusa Cloud jest rozliczana jako miesięczny plan plus zużycie, a cennik Medusy podaje ceny w dolarach:

W planach Launch i Scale Medusa Cloud godziny obliczeniowe ponad limit kosztują $0,16 za godzinę (źródło, stan na 2026-10). Baza danych ponad limit kosztuje $0,50 za GB miesięcznie (źródło, stan na 2026-10), a osobno płacisz za transfer danych, dodatkowe środowiska i miejsca w panelu Cloud. Rachunek przychodzi w dolarach, więc w budżecie w złotówkach dochodzi kurs.

Własna chmura: odpowiedzialność po twojej stronie

Według dokumentacji wdrożenia Medusy sklep we własnej chmurze to kilka składników do prowadzenia:

• serwer Medusy, który obsługuje też panel administracyjny,
• osobny worker do zadań w tle,
• bazę PostgreSQL i Redis,
• magazyn plików na zdjęcia i dokumenty, dla którego dokumentacja modułu plików zaleca w produkcji dostawcę takiego jak S3,
• hosting storefrontu, wdrażanego osobno.

Dokumentacja Medusy wymaga dla serwera i panelu co najmniej 2 GB pamięci RAM. Cena każdego składnika zależy od dostawcy, regionu i rozmiaru, dlatego nie podajemy tu kwoty.

Większym kosztem własnej chmury niż rachunek za serwery jest odpowiedzialność za aktualizacje, kopie zapasowe, monitoring i reakcję na awarie. Ustal na piśmie przed startem sklepu, kto robi każdą z tych rzeczy.

Medusa Cloud czy własna chmura: jak wybrać

Między Medusa Cloud a własną chmurą wybierz według czterech kryteriów:

1. Lokalizacja danych: gdzie muszą leżeć dane klientów i zamówień.
2. Istniejąca infrastruktura: czy firma ma już własne konto w chmurze.
3. Odpowiedzialność: kto zajmuje się aktualizacjami, kopiami i awariami.
4. Przewidywalność rachunku: opłaty za zużycie albo zasoby, które wymiarujesz samodzielnie.

Evelumo nie zakłada Medusa Cloud domyślnie. Hosting sklepu na Medusie dobieramy do wymagań projektu, a Medusa Cloud wybieramy tylko wtedy, gdy projekt jej potrzebuje.

Ile kosztuje Medusa.js i co jest darmowe

Rdzeń Medusa.js jest darmowy na licencji MIT, bez opłaty licencyjnej i bez prowizji od sprzedaży, ale płacisz za budowę, hosting i utrzymanie sklepu, a dwie funkcje dla większych zespołów wymagają płatnej licencji.

Licencja Medusy zmieniła się 11 sierpnia 2026 roku, gdy MedusaJS, Inc. włączyła do repozytorium pull request #16110. Plik LICENSE mówi teraz, że kod jest na licencji MIT z wyjątkiem materiałów Enterprise Edition, a ENTERPRISE-LICENSE.md wymienia je z nazwy: RBAC (role i uprawnienia) oraz SSO (logowanie firmowe). Korzystanie z RBAC i SSO wymaga umowy komercyjnej z MedusaJS, Inc., a plan Enterprise w Medusa Cloud obejmuje obie funkcje. Prawa nadane na licencji MIT dla wcześniejszych wersji nie są cofane.

Licencja Enterprise ma znaczenie, gdy w panelu Medusy pracuje wiele osób z różnymi uprawnieniami, na przykład magazyn nie powinien zmieniać cen (RBAC), albo gdy zespół loguje się przez firmowego dostawcę tożsamości (SSO).

Koszt sklepu na Medusie przez 24 miesiące to suma sześciu pozycji:

1. Wdrożenie: backend, storefront i rozszerzenia panelu.
2. Hosting: Medusa Cloud ze zużyciem albo własna chmura.
3. Opłaty za płatności: pobiera je operator, nie Medusa.
4. Integracje: ERP, przewoźnicy i księgowość.
5. Utrzymanie i rozwój: aktualizacje, poprawki i nowe funkcje.
6. Licencja Enterprise: tylko jeśli potrzebujesz RBAC albo SSO.

Nie podajemy rynkowych widełek ceny wdrożenia Medusy, bo nie znaleźliśmy ich w wiarygodnym źródle. Liczby Evelumo: działający sklep w 30 dni kosztuje od 40 000 PLN netto, a hosting i utrzymanie sklepu, który zbudowaliśmy, od 400 PLN netto miesięcznie, z integracjami wycenianymi osobno. Żeby zestawić koszt sklepu na Medusie z abonamentem, policz koszt całego sposobu działania przez 24 miesiące.

Mocne i słabe strony Medusy

Medusa jest mocna tam, gdzie proces nie mieści się w gotowej platformie, a słaba tam, gdzie firma potrzebuje gotowych integracji i nie ma partnera technicznego.

Mocne strony Medusy:

• Procesy, które gotowa platforma wygina: ceny B2B, B2B i B2C w jednym sklepie, kilka kanałów na jednym katalogu.
• Własność: kod może należeć do ciebie, więc zmiana wykonawcy nie oznacza zmiany platformy.
• Brak opłaty od obrotu po stronie platformy: rosnąca sprzedaż nie podnosi opłaty za silnik.

Słabe strony Medusy:

• Brak sklepu z aplikacjami na skalę Shopify i brak integracji w cenie abonamentu, które dają Shoper i IdoSell.
• Utrzymanie po twojej stronie: aktualizacje, bezpieczeństwo, hosting i partner, który zna kod sklepu także po starcie.
• Krótka historia v2: doświadczenie agencji bywa tylko z v1.
• Płatne funkcje Enterprise: RBAC i SSO.
• Angielski: dokumentacja Medusy jest po angielsku.

Kiedy Medusa.js to zły wybór

Medusa.js to zły wybór, gdy gotowa platforma obsługuje twój proces bez obejść, bo zapłacisz za zbudowanie tego, co możesz wynająć.

Nie wybieraj Medusy, gdy:

• proces mieści się w Shoperze, IdoSell albo Shopify bez kłócących się aplikacji i ręcznej pracy poza systemem,
• sprzedajesz standardowo, głównie w Polsce, i potrzebujesz gotowych integracji z przewoźnikami, Allegro i płatnościami od pierwszego dnia,
• nie ma budżetu ani partnera na utrzymanie sklepu po starcie,
• model biznesowy jest niesprawdzony: najpierw sprawdź popyt na gotowej platformie.

Gdy proces mieści się w gotowej platformie, Evelumo rekomenduje ją zamiast Medusy i mówi to na pierwszej rozmowie.

Medusa.js a Shoper, IdoSell, Shopify, PrestaShop, WooCommerce i Magento

Platformy sklepowe dostępne w Polsce dzielą się na trzy modele: platformę w abonamencie (Shoper, IdoSell, Shopify), open source w PHP z wtyczkami (PrestaShop, WooCommerce, Magento Open Source) oraz silnik headless budowany pod proces, czyli Medusę.

Shopify kosztuje w Polsce od 79 do 1 630 zł netto miesięcznie (źródło, stan na 2026-10), Shopify Plus od 2 100 EUR miesięcznie (źródło, stan na 2026-10), a przy zewnętrznej bramce płatności Shopify dolicza od 0,2% do 2% wartości transakcji (źródło, stan na 2026-10). Cen Shopera i IdoSell nie podajemy, bo w pierwszym roku są promocyjne. Cennik IdoSell deklaruje brak prowizji od obrotu i stałą opłatę za każde zamówienie, a cennik Shopera każe doliczyć do abonamentu opłaty od metod płatności (stan na październik 2026).

Polskie integracje są przewagą Shopera i IdoSell. Cennik Shopera wymienia w każdym planie integrację z Allegro, przewoźników i wbudowane płatności, a IdoSell deklaruje kurierów, płatności i KSeF w ramach abonamentu. W Shopify te potrzeby obsługują aplikacje: zobacz, ile naprawdę kosztuje sklep na Shopify w Polsce.

Licencje open source sprawdziliśmy w repozytoriach: rdzeń PrestaShop i Magento Open Source są na OSL 3.0, a wtyczka WooCommerce na GPL w wersji 3. Samo oprogramowanie jest bezpłatne, a płacisz za hosting, wtyczki i pracę agencji.

Shoper i IdoSell wygrywają przy standardowej sprzedaży w Polsce, Shopify przy wielu rynkach i standardowym procesie, PrestaShop i WooCommerce przy małym budżecie i gotowych wtyczkach, a Magento wtedy, gdy firma ma już zespół i działające wdrożenie Magento. Medusa wygrywa, gdy proces nie mieści się w żadnym z tych modeli bez obejść. To nasza ocena z pracy przy wdrożeniach, a nie wynik badania rynku. Jeśli zmieniasz platformę, zobacz, jak wygląda migracja z Shopera, WooCommerce, Magento lub PrestaShop.

Jak wygląda wdrożenie sklepu na Medusie

Wdrożenie sklepu na Medusie ma osiem kroków:

1. Krytyczny proces i zakres: jeden proces sprzedaży, który musi obsłużyć pierwsze wydanie.
2. Model danych i moduły: co daje Medusa, a co wymaga własnego modułu.
3. Integracje: integrujemy m.in. SAP, Microsoft Dynamics 365, Oracle NetSuite, Comarch ERP i JTL-Wawi.
4. Storefront: strony, z których korzysta klient.
5. Rozszerzenia panelu: ekrany potrzebne twojemu zespołowi.
6. Testy ścieżek krytycznych i niezależne review przed każdym wydaniem.
7. Start: wdrożenie produkcyjne i monitoring.
8. Utrzymanie i rozwój po starcie.

Zanim podpiszesz umowę z wykonawcą sklepu na Medusie, zapytaj:

• Na której wersji Medusy budujecie i kiedy ostatnio wdrożyliście sklep na v2?
• Co pochodzi z Medusy, co z waszej bazy, a co napiszecie dla nas?
• Kto hostuje sklep, aktualizuje go i reaguje na awarie?
• Czy będziemy potrzebować RBAC albo SSO i kto załatwia licencję Enterprise?
• Do kogo należy kod i konta w chmurze po starcie?
• Które polskie integracje są gotowe, a które budujecie?

Alufix to kompletne rozwiązanie e-commerce zbudowane przez nasz zespół w Medusa.js: katalog, wyszukiwanie, koszyk i przejście do zakupu. Sklep Alufix jest publiczny, więc ścieżkę zakupu sprawdzisz samodzielnie.

Uruchamiamy działający sklep w 30 dni na naszej podstawie z Medusą, B2B i B2C, od 40 000 PLN netto, a po starcie zostajemy przy utrzymaniu i rozwoju.