Medusa.js × Next.js — Refonte headless open source souverain France

#Quand choisir Medusa.js plutôt que Shopify Hydrogen ou CommerceLayer

C'est la première question qui revient en cadrage e-commerce headless. Voici notre filtre de décision, basé sur 2 projets Medusa.js livrés en 2024-2025 (un distributeur B2B industriel et une DNVB cosmétique custom) et 6 migrations Shopify Hydrogen sur la même période.

Medusa.js est le bon choix si l'un de ces trois critères est rempli. Premièrement, ton projet impose un stack 100 % open source ou un hébergement souverain France. Marchés publics, opérateurs de service essentiel, loi SREN, exigence OVHcloud Qualified Cloud, gouvernance interne anti-GAFAM : Hydrogen (lié au Storefront API Shopify propriétaire) et CommerceLayer (SaaS américain) ne passent pas. Medusa, en revanche, tourne sur ton infra OVHcloud, Scaleway ou Outscale sans dépendance à un acteur tiers.

Deuxièmement, tu es un distributeur B2B avec tarifications complexes par compte client (grilles tarifaires multiples, remises volumiques, conditions de paiement spécifiques, contrats négociés, multi-établissements, accès catalogue restreint). Medusa expose un modèle data flexible permettant de modéliser ces règles métier sans contorsion. Shopify B2B reste limité ; CommerceLayer demande une couche de logique applicative custom équivalente.

Troisièmement, tu refuses la facture cumulée Shopify Plus. À partir de 30-49,6 M€ de CA, le ticket annuel Shopify Plus (2 300 $/mois + transaction fees 0,15 % au-dessus seuils) devient un argument de migration. Sur 3 ans, l'économie cumulée vs Medusa self-hosted peut dépasser 600 k€ à 131 k€ — ce qui finance largement la refonte initiale.

#Cas marketplace verticale ou modules custom illimités

Medusa redevient incontournable dès que ton modèle impose des workflows commande très spécifiques : panier multi-étapes B2B avec validation hiérarchique, devis en ligne avec versioning, EDI fournisseurs, fiscalité intracommunautaire complexe, marketplace verticale multi-vendeurs avec commissionnement custom, modèle d'abonnement non-standard (B2B contrats annuels révisables). Hydrogen plafonne sur ces cas car le backend Shopify reste verrouillé. CommerceLayer demande de la custom équivalente. Avec Medusa, tu codes ton workflow directement dans le backend en TypeScript.

#Architecture technique Medusa.js détaillée

Medusa.js repose sur un stack technique simple, mature et souverain. Backend Node.js + framework Medusa core (modules métier natifs catalogue, panier, commande, paiement, fulfillment, fiscalité multi-pays). Base de données Postgres 16 (modèle data relationnel solide pour e-commerce, transactions ACID, performance lecture/écriture excellente). Cache Redis 7 (sessions, panier, queues asynchrones via BullMQ). APIs REST et GraphQL exposées nativement.

Frontend Next.js 16 (App Router, Server Components, ISR, PPR, Suspense streaming). Les Server Components consomment l'API GraphQL Medusa côté serveur, le navigateur ne reçoit qu'un HTML statique optimisé + îlots interactifs. Core Web Vitals top 5 % marché out-of-the-box (LCP <1,8 s, INP <150 ms typique sur un projet correctement architecturé).

Intégrations natives ou faciles. Paiements : Stripe, Mollie, Adyen, PayPlug, Lyra (cartes 3DS2, SEPA, virement, BNPL Alma/Klarna). Recherche produit : Algolia, Meilisearch (souverain, hébergeable OVHcloud), Typesense. PIM : Akeneo (l'intégration native est mature, voir notre page dédiée intégration Akeneo PIM). ERP : SAP S/4HANA, Sage X3, Cegid, Divalto via connecteurs REST/GraphQL custom. Email : Postmark, SendGrid, Brevo. Analytics : GA4, Matomo (souverain), Plausible. Tag management : GTM ou Snowplow (souverain).

Déploiement OVHcloud souverain. Infrastructure recommandée Nehos : OVHcloud Public Cloud (Managed Kubernetes pour Medusa core), Postgres managé OVHcloud, Redis managé, stockage objet S3-compatible OVHcloud Object Storage, CDN OVHcloud, certificats SSL Let's Encrypt automatiques. Hébergement physique France (Roubaix, Strasbourg, Gravelines). Conformité RGPD native, pas de transfert hors UE.

#Avantages économiques et stratégiques de Medusa.js

Open source MIT, gratuit. Pas de licence à payer. Pas de frais commercial sur les transactions (vs Shopify Payments 2-2,9 %, ou Shopify transaction fees 0,15 % si tu utilises un autre provider). Pas d'engagement contractuel multi-année. Tu peux forker le code, modifier le core, contribuer à l'upstream. Le code Medusa appartient à ton entreprise — pas à un éditeur SaaS.

Pas de vendor lock-in. Le frontend Next.js consomme des APIs REST et GraphQL standardisées. Tu peux changer de PIM, d'ERP, de provider paiement, sans réécrire la couche front. Tu peux migrer ultérieurement vers un autre framework headless sans coût catastrophique (15-25 % du codebase typiquement, vs 60-80 % depuis un Shopify Hydrogen verrouillé Storefront API).

Hébergement souverain France. OVHcloud Public Cloud, Scaleway, Outscale, Clever Cloud : toutes les options souveraines françaises sont compatibles. Aucune donnée hors UE. Conformité RGPD native. Réponse aux exigences marchés publics, loi SREN, opérateurs de service essentiel. C'est un argument commercial différenciant pour les marques B2B servant des clients publics ou industriels souverains.

Modules custom illimités. Tu codes ce que tu veux directement dans le backend Medusa en TypeScript. Tarifications B2B par compte avec grilles multiples, remises volumiques, conditions de paiement négociées : 2-4 semaines de dev typique. Connecteur EDI fournisseurs : 3-6 semaines selon protocole (EDIFACT, XML, API). Marketplace verticale multi-vendeurs avec commissionnement custom : 6-10 semaines. Workflow devis B2B avec versioning et validation hiérarchique : 4-6 semaines. Tu n'es pas limité par les capacités d'un SaaS.

#Limites honnêtes de Medusa.js

Nécessite une équipe tech compétente. Medusa demande de la maîtrise Node.js + TypeScript + Postgres + Redis + DevOps Kubernetes. Une équipe junior ou une absence d'équipe tech interne rend Medusa risqué : la maintenance demande des compétences. Si ton entreprise ne dispose pas d'au moins un CTO ou Lead Dev e-commerce, on déconseille honnêtement Medusa et on oriente vers Shopify Hydrogen (plus simple à maintenir).

Time-to-market plus long vs Shopify Hydrogen. Refonte Medusa.js B2C complète : 16-26 semaines. Refonte B2B distributeur : 20-32 semaines. À comparer aux 12-20 semaines d'une migration Shopify Liquid → Hydrogen. Cet écart s'explique par le développement backend nécessaire (modules custom, intégrations ERP, workflows métier) que Hydrogen ne demande pas (le backend Shopify est déjà là).

Écosystème app store limité vs Shopify. Shopify App Store : 8 000+ apps, beaucoup de plug-and-play (Klaviyo, Yotpo, Loop Returns, ReCharge installées en quelques clics). Medusa : 30-50 plugins officiels en 2026, plus quelques dizaines de modules communauté. Pour intégrer Klaviyo, Yotpo ou ReCharge dans Medusa, il faut souvent coder le connecteur (1-3 semaines selon scope). C'est tenable, mais c'est du dev — pas du clic.

Équipe Nehos disponible. On a aujourd'hui 2 développeurs seniors Medusa.js sur l'effectif (Nadhem Lead Dev frontend qui maîtrise le couple Next.js + Medusa, et Ahmed Hadrich Fullstack Dev JS expert e-commerce et intégrations marketplaces). On peut donc enclencher 1-2 projets Medusa en parallèle, pas 5. Si on est en pleine charge, on est transparent : on décale ou on oriente vers Hydrogen si c'est aussi pertinent.

#Méthode Nehos de refonte Medusa.js

Une méthode éprouvée sur 2 projets livrés en 2024-2025. Quatre phases, 16 à 26 semaines au total pour un B2C, 20 à 32 semaines pour un B2B distributeur.

Phase 1 — Audit existant et cadrage architecture (2 à 3 semaines). Audit du stack actuel (Magento 2, custom PHP, Shopify Liquid, BigCommerce). Crawl Screaming Frog exhaustif. Audit data (modèle catalogue, structures clients, historique commandes, tarifications). Cadrage architecture cible Medusa : modules natifs vs custom, intégrations PIM/ERP, choix providers paiement, choix hébergement souverain. Output : rapport chiffré + scope définitif + chiffrage précis.

Phase 2 — Design system et modélisation data (3 à 4 semaines). Design system Figma complet (tokens, composants atomiques, templates principaux). Modélisation data détaillée : catalogue produit (variantes, options, attributs PIM), tarifications B2B (grilles multiples, remises, contrats), workflows commande spécifiques (devis, validation, EDI). Output : Figma + schéma data + plan modules custom à développer.

Phase 3 — Développement Medusa core + modules custom + frontend Next.js 16 (10 à 16 semaines pour B2C, 14 à 22 semaines pour B2B). Setup Medusa backend. Développement des modules custom (tarifications B2B, EDI, marketplace selon scope). Setup Postgres + Redis. Implémentation frontend Next.js 16 avec App Router, Server Components, streaming. Intégrations Stripe/Mollie, Algolia/Meilisearch, Akeneo PIM, ERP. Tests E2E Playwright sur les parcours critiques. Setup tracking GA4 + Matomo souverain. Output : staging Medusa complet sur medusa.staging.client.com.

Phase 4 — Intégrations finales, déploiement OVHcloud et hyper-care (2 à 3 semaines). Déploiement production OVHcloud Public Cloud (Managed Kubernetes). Setup monitoring (Sentry, Grafana, Loki). Plan de redirections 301 exhaustif activé en amont. Bascule progressive avec rollback instantané possible. Hyper-care quotidien les 30 premiers jours, hebdomadaire jusqu'à 90 jours.

#Cas clients Medusa.js — résultats mesurés

Distributeur B2B industriel français, 28,8 M€ CA, 12 000 SKU, 3 200 comptes clients pro avec tarifications négociées individuelles. Stack précédent : Magento 2 custom (maintenance lourde, technical debt accumulée sur 7 ans, performance dégradée). Pain points : pages catalogue lentes (LCP 5,2 s), tarifications complexes mal gérées (saisie manuelle commerciale), intégration ERP Sage X3 fragile (synchronisation stocks différée 24h).

Refonte livrée en 28 semaines. Stack Nehos : Medusa.js + Next.js 16 + Postgres 16 + Redis 7 + Algolia + Akeneo PIM 12 000 SKU + connecteur Sage X3 custom (synchro stocks temps réel) + Stripe + virement SEPA. Hébergement OVHcloud Public Cloud souverain. Modules custom développés : tarifications B2B par compte (grilles multiples, remises volumiques), workflow devis en ligne avec versioning, EDI fournisseurs (EDIFACT), accès catalogue restreint par compte client.

Résultats mesurés à 12 mois post-launch. Commandes en ligne : 32 % → 71 % du CA total (charge service commercial téléphonique -42 %, soit 1,8 ETP commercial réalloué prospection). LCP : 5,2 → 1,4 s. Conversion compte client pro : +58 % vs Magento. Synchronisation stocks ERP : passée de 24h à temps réel (rupture stock affichée immédiatement). Économie licence Magento Commerce (envisagée comme alternative) : ~à partir de 51 k€/an. Budget total refonte : 131 k€ HT.

En analogie, voir aussi notre cas DNVB cosmétique Shopify Hydrogen (architecture différente mais ROI conversion mobile comparable) et notre cas retailer omnicanal Akeneo PIM (intégration PIM avec stack composable).

#Tarification Nehos pour une refonte Medusa.js

Fourchette Nehos. Refonte Medusa.js B2C complète : 11,5 k€ HT sur 16-26 semaines. B2B distributeur avec tarifications complexes, EDI et intégration ERP : 621 k€ HT sur 20-32 semaines. Décomposition typique d'un projet B2B 131 k€ : audit + cadrage (à partir de 48 k€), design + modélisation data (2,5 k€), développement Medusa core + modules custom (à partir de 120 k€), intégrations PIM/ERP/paiement (111 k€), déploiement OVHcloud + hyper-care 90 jours (711 k€).

Diagnostic e-commerce headless1 12 416 € HT fixe sur 5 jours pour cadrer le scope, valider l'architecture cible (Medusa vs Hydrogen vs CommerceLayer vs custom), chiffrer précisément. Pas d'engagement après le diagnostic — tu repars avec un rapport actionnable.

Facturation 30 % au lancement, 40 % à mi-projet (validation Figma + premier sprint Medusa en staging), 30 % au go-live validé. MCO post-launch en option : à partir de 864 € / mois selon scope (B2C ou B2B). TJM développeur senior Medusa : à partir de 848 € HT selon profil.