Medusa E-ticaret Geliştirme
Açık kaynak headless e-ticaret. Sıfır komisyon. Kod sizin.
ödeme kuruluşu ücreti ayrı
Shopify her satıştan bir yüzde alır. O komisyon siz büyüdükçe büyür. Türkiye’de Shopify Payments yok; bu ücret, ödeme kuruluşunuzun komisyonunun üstüne her siparişte ayrıca ödenir. Medusa açık kaynaklı, headless bir ticaret motoru. Sunucusu sizin. Kod sizin.
Mimari
Headless e-ticaret nedir?
Headless ticaret motoru
Medusa, Node.js ve TypeScript ile yazılmış bir ticaret backend'idir. Headless olması şu demek: motor — ürünler, siparişler, stok, ödeme, sevkiyat — vitrinden tamamen ayrıdır. Vitrini siz kurarsınız.
MIT lisansı — gerçekten sizin
Çekirdeği MIT lisanslı açık kaynak. Kodu okur, değiştirir, kurar ve isterseniz alıp gidersiniz. Hiçbir sağlayıcı fiyatını değiştirip sizi kabul etmeye ya da baştan yazmaya zorlayamaz. Bir istisna var: 2.19 sürümünden (Ağustos 2026) beri rol bazlı yetkilendirme (RBAC) ve tek oturum açma (SSO), ayrı ticari lisanslı Enterprise özellikleri. Gerekiyorsa bunu kapsamda baştan konuşuruz. Motorun sahibisiniz; ona abone değilsiniz.
Ölçekte üretime hazır
30.970’ten fazla GitHub yıldızı ve yüzlerce mağazada aktif üretim kullanımı. Deneysel değil. Ama bir hafta sonunda kurulacak bir şey de değil — üretim seviyesinde bir Medusa kurulumu ciddi bir mühendislik taahhüdüdür ve sürdürmek için kalıcı TypeScript uzmanlığı ister.
API öncelikli, her kanal
Vitriniz, mobil uygulamanız, toptan portalınız ve kasanız Medusa API’sinin birer istemcisi. Omnichannel burada varsayılan mimari — tek kanala sığmadığınızda sonradan eklediğiniz bir eklenti değil.
Shopify'ın Gerçek Maliyeti
Her yıl Shopify'a bıraktığınız para.
Üretim seviyesinde bir Medusa kurulumu ciddi, tek seferlik bir yatırımdır. Eşik Shopify paketinize göre değişir — Medusa'nın yerleşik olarak yaptığı işler için ayrıca uygulama parası ödüyorsanız daha da erken gelir.
Şunlar için doğru
- Özel B2B ticaret Müşteri segmentine göre kademeli fiyat, satın alma onay akışları, tekliften siparişe giden hatlar, vadeli ödeme ve cari hesap mantığı. Müşteri grupları ve fiyat listeleri Medusa’nın çekirdeğinde var. Şirket hesapları, onay akışı ve teklif yönetimi resmi B2B başlangıç projesiyle gelir; gerisini üstüne kodla yazarız.
- Çok satıcılı pazar yerleri Birden fazla satıcı, bölünmüş ödeme aktarımı, satıcı bazında stok ve sevkiyat. Medusa’da pazar yeri hazır gelmez; resmi dokümanında adım adım anlatılan bir senaryodur. Satıcı yapısı ve sipariş bölme kodla kurulur, bölünmüş ödeme ödeme kuruluşuyla birlikte kurgulanır.
- Standart dışı abonelik mantığı Kullanıma dayalı faturalama, sayaçlı fiyatlandırma, karmaşık deneme yapıları. Özel abonelik mantığı, eklenti taklidini değil, üzerine kod yazabileceğiniz bir ticaret motorunu ister.
- Yüksek ciroda Shopify'dan çıkış Shopify’ın işlem ücreti ciroyla birlikte büyür. Belli bir cironun üstünde bu ücretlerin toplamı, Medusa’ya geçişin tek seferlik maliyetini geçer. O eşiği sizin rakamlarınızla birlikte hesaplarız.
- Omnichannel kurulumlar Web vitrini, mobil uygulama, fiziksel kasa ve toptan portalı; hepsi aynı kataloğu, aynı stoğu, aynı sipariş yönetimini besliyor. Baştan API öncelikli.
Şunlar için değil
- Eşiğin altındaki standart DTC mağazalar Shopify'ın uygulama ekosistemi ve yönetilen altyapısı bu ölçekte gerçek bir avantaj. Medusa'yı eşiğe geldiğinizde değerlendirin — öncesinde değil.
- Kendi geliştiricisi olmayan işletmeler Medusa, TypeScript geliştiricisini proje sırasında değil — projeden sonra, süresiz olarak ister. Platform güncellemeleri, entegrasyon değişiklikleri, yeni özellikler. Onlar olmadan toplam sahip olma maliyeti ciddi biçimde değişir.
- Altı haftalık takvimler Üretim seviyesinde bir Medusa kurulumu 3–6 ay sürer. Backend, frontend, entegrasyonlar, veri göçü, test, staging. Takvim sizin için kritikse bunu en baştan söyleyin.
- İçerik odaklı ticaret Medusa'da CMS katmanı yok. Sayfa içeriği için ayrı bir headless CMS gerekir — ek aylık maliyet ve ek kurulum demek. Modeliniz içerik üzerinden satmaksa, WooCommerce size ticaret motorunun yanında WordPress'in tam CMS’ini verir.
Nasıl Çalışıyoruz
Mimari ve kapsam
Kod yazmadan önce ticaret modelinizi çıkarırız. Ödeme akışları, sevkiyat mantığı, entegrasyon ihtiyaçları, içerik stratejisi — hepsi bu aşamada tanımlanır. Mimaride çıkan sürpriz, koddaki sürprizden pahalıya gelir.
Medusa backend
Çekirdek kurulum, modül yapılandırması, veritabanı şeması, API tasarımı. Özel iş kuralları — fiyat kuralları, indirim yapıları, sipariş akışları — bu katmanda yazılır.
Frontend geliştirme
Vitrini Next.js ile (varsayılanımız) ya da ihtiyaca göre başka bir framework ile yazarız. Tasarımın eksiksiz uygulanması, performans optimizasyonu, Medusa API entegrasyonu. Lighthouse 90+ bizde kabul kriteridir.
Entegrasyonlar
Ödeme altyapıları (Stripe hazır modülle; iyzico, PayTR ve diğerleri özel ödeme modülüyle), kargo firmaları, sevkiyat platformları, ERP bağlantıları. Her entegrasyon demo veriyle değil, sizin gerçek işlem hacminizle test edilir.
Platform geçişi
Shopify ya da WooCommerce'ten taşınma: ürün kataloğu, müşteri verisi, sipariş geçmişi ve mevcut SEO'yu korumak için URL yönlendirme haritası. Geçiş testleri staging ile paralel yürür.
Teslim
Tüm kaynak kodu, kurulum dokümantasyonu, erişim bilgileri, mimari notları. Yayına aldıktan sonra hiçbir şey bizim altyapımıza ya da servislerimize bağlı kalmaz. Sahibi sizsiniz.
Entegrasyon Ekosistemi
Ödemeler
Medusa’nın resmi ödeme modülü Stripe; ama Stripe Türkiye’de kurulu işletmelere açık değil. Yurt içinde ödeme genellikle iyzico ya da PayTR gibi bir kuruluşla alınır: API’si olan her sağlayıcı özel bir Medusa ödeme modülü olarak bağlanır. Çoklu para birimi ve çoklu bölge ödeme akışı frontend'e yamanmaz, backend katmanında çözülür.
Sevkiyat ve kargo
Doğrudan kargo API’leri (Yurtiçi, Aras, MNG, DHL) ve Shippo, EasyPost, ShipStation. 3PL entegrasyonları proje bazında kapsamlandırılır. Bölünmüş gönderi, depo yönlendirme ve dropship mantığı backend'de kurulur — bir frontend bileşeninde taklit edilmez.
ERP ve stok
Logo, Netsis, Mikro, SAP Business One ve REST ya da webhook üzerinden özel ERP bağlantıları. Stok senkronizasyonu, sipariş geri yazımı ve müşteri verisi akışı mimari aşamasında kapsama alınır — maliyeti beş katına çıktığı yayın sonrasında değil.
İçerik yönetimi
Sayfa içeriği, koleksiyon açıklamaları, SEO metinleri ve editoryal için Sanity (varsayılanımız) ya da Contentful. Vitrin, ticaret verisini Medusa'dan, içerik verisini CMS’ten çeker — ayrı işler, en baştan mimari düzeyde doğru ayrılmış.
Müşteri kimlik doğrulama
B2C için Medusa'nın yerleşik müşteri kimlik doğrulaması. SSO gerektiren B2B senaryolarında Auth0, Okta ya da SAML entegrasyonu proje bazında kapsamlandırılır. Çok hesaplı yapılar (ana şirket / bağlı alıcı hesapları) çekirdekte yok; resmi B2B başlangıç projesindeki şirket yönetimiyle ya da özel modülle kurulur. Medusa’nın hazır SSO (OIDC) modülü ise 2.19’dan beri ayrı lisanslı Enterprise sürümünde.
Dürüst Karşılaştırma
Medusa mı, özel WooCommerce mi?
| Medusa | Özel WooCommerce | |
|---|---|---|
| Süre | 3–6 ay | 6–10 hafta |
| Platform komisyonu | Yok | Yok |
| Barındırma | Kendi sunucunuz ya da Medusa Cloud | Kendi hosting’iniz |
| CMS katmanı | Yok — headless CMS gerekir | WordPress CMS dahil |
| Geliştirici olmadan içerik düzenleme | Hayır — CMS kurulumu gerekir | Evet — Gutenberg |
| Özel B2B iş kuralları | Kod düzeyinde, esnek | Eklentilerle mümkün |
| Geliştirici havuzu | TypeScript uzmanları | Geniş küresel PHP havuzu |
Büyüyen mağazaların çoğu için doğru cevap WooCommerce. Karmaşık B2B kuralları, pazar yeri modeli, Shopify komisyonunun canını yaktığı yüksek ciro ya da omnichannel ihtiyacı olan mağazalar içinse Medusa yatırımı hak eder. Teklif vermeden önce hangisinin size uyduğunu açıkça söyleriz.
Geçiş
Shopify → Medusa: dürüst takvim.
Shopify'dan Medusa'ya geçiş — frontend'in yeniden yazılması, veri göçü ve entegrasyon işi dahil — 5–8 ay sürer. Bütçe kapsama göre değişir; kapsam netleşince yazılı olarak veririz.
Shopify'dasınız ve sizi asıl rahatsız eden işlem komisyonlarıysa, headless bir projeye girişmeden önce hesabı yapın. Shopify'dan WooCommerce'e geçiş piyasada tipik olarak 8–12 hafta sürer ve çoğu zaman sizi Shopify'ın işlem ücretinden daha az maliyetle kurtarır. Hangi yolun cironuza uyduğunu size açıkça söyleriz. Bu hesap ücretsiz.
- Ürün kataloğu — başlıklar, açıklamalar, varyantlar, görseller, metafield'lar
- Müşteri hesapları ve sipariş geçmişinin tamamı
- Koleksiyonlar, etiketler ve ürün ilişkileri
- URL yapısı ve 301 yönlendirme haritası — SEO değeriniz olduğu gibi kalır
- Vitrin — tasarımınıza göre yeni bir Next.js frontend
- Tüm uygulama işlevleri; Medusa modülleri ya da özel kodla
- Kasa, ödeme akışları ve vergi yapılandırması
- İşlemsel e-postalar ve bildirim akışları
İşi Kim Yapıyor
Yalnızca kıdemli.
Ara devir yok.
Bu ölçekte bir Medusa kurulumu — özel ödeme mantığı, çoklu bölge desteği, B2B akışları, ERP bağlantıları — bunu daha önce yapmış bir geliştirici ister. Sizin projenizde öğrenen birini değil.
Mimarinizin kapsamını çıkaran geliştirici, projeyi yazan geliştiricidir. Başlangıç toplantısından sonra hiçbir iş juniorlara devredilmez. Çoğu ajanstan daha az proje alıyoruz. Medusa’nın gerektirdiği karmaşıklık tam olarak bunun sebebi.
SSS
Medusa SEO tarafında iyi mi?
Doğru kurulduğunda evet. Medusa headless olduğu için SEO tamamen frontend meselesidir. Düzgün yazılmış bir Next.js vitrini Googlebot'a tamamen render edilmiş HTML verir — istemci tarafı render sorunu yok, LCP hızlı, URL yapısı temiz. Lighthouse 90+ bizde taban değerdir.
Medusa hangi ödeme altyapılarını destekliyor?
Hazır gelen resmi modül Stripe; ancak Stripe Türkiye’de kurulu işletmelere açık değil. iyzico, PayTR, Craftgate gibi API’si olan sağlayıcılar için özel ödeme modülü yazılır. Yeni bir altyapı eklemek eklenti kurmak değil, geliştirme işidir: daha çok esneklik, daha çok geliştirme süresi.
Medusa abonelik yönetebilir mi?
Evet, özel geliştirmeyle: abonelik mantığı koda yazılır, ödeme tarafı tekrarlayan ödemeyi destekleyen bir ödeme kuruluşuna bağlanır. Kutudan çıktığı gibi yerleşik bir abonelik yönetimi yok — bu bir geliştirme işi. WooCommerce Subscriptions karşısındaki gerçek eksiklerden biri budur. Abonelik ihtiyaçlarını, Medusa kararı verilmeden önce ayrıntısıyla kapsama alırız.
İçerik yönetimi nasıl çalışıyor?
Medusa ürünleri, siparişleri, müşterileri ve sevkiyatı yönetir. Sayfa içeriği için headless bir CMS gerekir. Genellikle Sanity ya da Contentful entegre ederiz — ikisinin de pazarlama ekibinizin geliştiriciye ihtiyaç duymadan kullanabileceği bir editör arayüzü var. Bu entegrasyonun kendi maliyeti vardır ve proje kapsamına baştan yazılır.
Sürekli bakım ne kadar iş demek?
Mağazanın karmaşıklığına göre ayda 5–20 saat bekleyin — platform güncellemeleri, bağımlılık yönetimi, ödeme kuruluşu API değişiklikleri, yeni özellik geliştirme. Yazdığımız projeler için bakım anlaşması sunuyoruz.
Sizin kurduğunuz Medusa altyapısını aşarsak ne olur?
Kod sizin. İstediğiniz geliştiriciye ya da ajansa götürün, isterseniz etrafında kendi ekibinizi kurun. Yaptığımız işlerde kapalı, tescilli hiçbir parça yok. Tek istisna Medusa’nın kendi Enterprise özellikleri (RBAC, SSO): onlar ayrı ticari lisansla gelir ve gerekiyorsa kapsamda baştan konuşulur. Mimari dokümantasyonu her entegrasyon noktasını ve süreçte verilen her kararı anlatır.
Platform değişikliği mi düşünüyorsunuz?
Neyi çalıştırdığınızı, size neye mal olduğunu ve neyi yapamadığını anlatın. Dosdoğru bir karşılaştırma yaparız — Medusa, WooCommerce ya da olduğunuz yerde kalmak. Bu hesap ücretsiz.