Headless E-Ticaret Rehberi 2026: Medusa mı Shopify mı?

“Sitemiz yavaş, tema her güncellemede kırılıyor, kampanya sayfası için üç eklenti kurduk.” Bu cümleyi e-ticaret yapan müşterilerden o kadar sık duyuyoruz ki, artık teşhisi baştan koyuyoruz: sorun tema değil, mimari.

2026’da bu sorunun en net cevabı headless mimari. Ve Türkiye’de karar genelde iki seçeneğe iniyor: açık kaynak Medusa.js mi, yoksa Shopify Headless mı?

Bu yazı o kararı netleştirmek için var. Genel modern stack tartışmasını E-Ticaret Modern Stack 2026 yazısında yapmıştık; burada sadece headless mimariye ve Medusa ile Shopify arasındaki seçime derinleşiyoruz.

Hızlı özet: Headless e-ticaret, ürün-sepet-ödeme motorunu vitrin arayüzünden ayıran mimaridir. Medusa.js komisyonsuz, açık kaynak ve tam esnek ama self-host ile DevOps sorumluluğu ister. Shopify Headless hazır ve stabil altyapı sunar ama aylık lisans, checkout kısıtları ve API sınırlarıyla gelir. Türkiye’de iyzico/PayTR ve Aras/MNG her ikisiyle de çalışır; Medusa’da özel adaptör yazılır.

Headless E-Ticaret Nedir?

Headless e-ticaret, mağazanızın “motoru” ile “vitrinini” birbirinden ayırmaktır. Motor (ürün kataloğu, stok, sepet, sipariş, ödeme) sadece bir API olarak çalışır; vitrin ise Next.js veya Astro gibi modern bir frontend ile ayrıca yazılır ve bu API’dan beslenir.

“Head” burada arayüz demek. Kafayı kestiğinizde geriye saf bir commerce API’ı kalıyor; o API’ın önüne istediğiniz kadar yüz koyabiliyorsunuz. Web sitesi, mobil uygulama, hatta mağaza içi kiosk, hepsi aynı motora bağlanır.

Bunun pratik karşılığı üç şey:

• Hız: Vitrin statik veya edge-render edildiği için LCP <1.5s ve Lighthouse 95+ gerçekçi hedefler haline gelir. Klasik WooCommerce kurulumlarında bu değerlere eklenti yığını altında ulaşmak ciddi iştir.
• Tasarım özgürlüğü: Tema motorunun sınırları yok. Ürün sayfası, sepet akışı, kampanya deneyimi ne istiyorsanız o.
• Çok kanallılık: Aynı backend’den web + mobil + pazaryeri beslemesi.

Bedeli de net: artık bir frontend projeniz var. Frontend tarafında neden Next.js tercih ettiğimizi Next.js ile web sitesi yaptırmak yazısında anlatmıştık; e-ticarette de aynı mantık geçerli.

Klasik WooCommerce/Shopify Temasından Farkı Ne?

En kısa cevap: klasik kurulumda vitrin ve motor tek gövdedir, headless’ta iki ayrı projedir. Bu tek fark, günlük hayatta üç büyük sonuç doğurur.

Birincisi, kırılganlık. WooCommerce’te tema + 20 eklenti + WordPress çekirdeği aynı PHP sürecinde koşar. Bir eklenti güncellemesi sepeti bozabilir. Headless’ta vitrin ayrı deploy edildiği için backend güncellemesi arayüzü, arayüz güncellemesi backend’i etkilemez.

İkincisi, performans tavanı. Klasik temada her sayfa isteği veritabanına iner; cache eklentileriyle idare edersiniz. Headless vitrinde ürün sayfaları build anında veya ISR ile üretilir, kullanıcıya CDN’den statik HTML gider.

Üçüncüsü, geliştirici profili. WooCommerce’i PHP bilen geniş bir havuz yönetebilir. Headless projede JavaScript/TypeScript bilen, API ile çalışmaya alışık bir ekip gerekir. Bu, Türkiye’de maliyet kalemini gerçekten değiştiren bir faktör; saklamanın anlamı yok.

Peki Shopify’ın kendi teması (Liquid) neden yetmiyor? Küçük ve orta ölçek için çoğu zaman yetiyor aslında. Yetmediği yer: tema dilinin sınırlarına takılan özel deneyimler, agresif performans hedefleri ve Shopify dışı sistemlerle (ERP, özel B2B fiyatlama) derin entegrasyon ihtiyacı.

Medusa.js mi, Shopify Headless mı?

Kararın kısa cevabı şu: kontrol ve maliyet optimizasyonu istiyorsanız Medusa.js, operasyonel konfor ve hazır ekosistem istiyorsanız Shopify Headless. Detaya inelim.

Medusa.js Ne Sunuyor?

Medusa.js, Node.js/TypeScript ile yazılmış, MIT lisanslı açık kaynak bir commerce motoru. 2.x sürümleriyle birlikte modüler mimarisi oturdu: ödeme, kargo, vergi, stok gibi her parça değiştirilebilir bir modül. Kendi sunucunuzda (VPS, Docker, PostgreSQL + Redis) çalıştırırsınız.

Öne çıkanlar:

• Satış başına komisyon yok, lisans ücreti yok. Maliyet = sunucu + geliştirme.
• Çoklu para birimi, çoklu depo, B2B fiyat listeleri çekirdekte var.
• Ödeme ve kargo sağlayıcıları provider arayüzüyle takılır: iyzico, PayTR, Aras, MNG için adaptör yazmak mümkün.
• Admin paneli hazır geliyor; müşteriniz ürün ve siparişi oradan yönetir.

Zayıf tarafı da açık: her şey sizin sorumluluğunuzda. Yedekleme, ölçekleme, güvenlik yamaları, PCI kapsamını ödeme sağlayıcısına devretme kurgusu. Ekipte DevOps refleksi yoksa Medusa’nın “bedava” görünen maliyeti sunucu bakımında geri gelir.

Shopify Headless Ne Sunuyor?

Shopify Headless’ta motor Shopify’ın kendisidir; vitrini Storefront API (ve istenirse Hydrogen framework’ü) üzerinden kendi Next.js/Remix projenizle yazarsınız. Barındırma, ölçekleme, güvenlik, sipariş altyapısı Shopify’da kalır.

Öne çıkanlar:

• Sıfır sunucu derdi. Kampanya gecesi trafiği Shopify’ın problemi.
• Olgun admin, raporlama, uygulama ekosistemi.
• Storefront API stabil ve iyi dokümante; frontend ekibi hızlı ilerler.

Zayıf tarafları:

• Aylık plan ücreti (2026 itibarıyla temel planlar aylık ~25-40 $ mertebesinden başlıyor, headless projelerde genelde daha üst planlar tercih ediliyor) ve Shopify Payments Türkiye’de tam anlamıyla yerleşik olmadığı için harici ödeme kullanım koşullarına dikkat gerekiyor.
• Checkout kısıtı: Ödeme adımı Shopify Checkout’ta biter. Tasarımına müdahale sınırlıdır; tam özel checkout istiyorsanız Plus seviyesine bakarsınız, o da bambaşka bir bütçe.
• API rate limit’leri ve veri modelinin size ait olmaması. Ürün verinizin şeklini Shopify belirler.

Karşılaştırma Tablosu

Türkiye Gerçeği: iyzico, PayTR, Aras ve MNG Nasıl Bağlanıyor?

Türkiye’de headless projeyi başarılı ya da başarısız yapan şey mimari tartışması değil, yerel entegrasyonların ne kadar dürüst planlandığı. Burada süslemeden, sahada gördüğümüz haliyle anlatalım.

Ödeme tarafı. Medusa’da iyzico veya PayTR için hazır resmi bir eklenti beklemeyin; payment provider arayüzünü uygulayan bir adaptör yazılır. İşin kritik kısmı 3D Secure akışıdır: kullanıcı banka sayfasına yönlenir, dönüşte callback imzası doğrulanır, sipariş ancak o zaman “ödendi”ye çekilir. Bu akışı uçtan uca test etmeden canlıya çıkmak, para alıp sipariş oluşturmayan bir sistem riski demektir. Shopify tarafında iyzico’nun hazır entegrasyonu işi kolaylaştırır; bedeli, checkout deneyiminin Shopify kalıbında kalmasıdır.

Kargo tarafı. Aras ve MNG’nin API’ları var ama ikisi de “modern REST” beklentisiyle yaklaşırsanız sizi şaşırtır; SOAP kalıntıları, bayi bazlı yetkilendirme ve test ortamı almak için yazışma süreçleri gerçek. 90+ projede gördüğümüz net bir ders var: kargo firmasının gerçek test hesabı elinize geçmeden adaptör yazımına başlamayın; dokümana bakarak yazılan entegrasyon canlıda mutlaka bir sürpriz çıkarır. Medusa’da bu entegrasyon fulfillment modülü olarak eklenir ve barkod/takip numarası siparişe otomatik işlenir. Shopify’da ise ya uygulama mağazasındaki hazır çözümler ya da özel bir app gerekir.

e-Fatura. Türkiye’de e-ticaret yapıyorsanız e-Arşiv fatura zorunluluğu masada. Medusa’da sipariş tamamlandığında entegratör API’sine (birçok GİB entegratörü REST sunuyor) doğrudan istek atan bir subscriber yazarsınız. Shopify’da bu iş üçüncü parti Türk uygulamalarına kalır; çalışır ama aylık ek maliyettir.

Hangi Ciro ve Ekip İçin Hangisi?

Net konuşalım, çünkü bu soruda “duruma göre değişir” cevabı kimseye yardım etmiyor.

Aylık 300 bin TL altı ciro, teknik ekip yok: Headless’a hiç girmeyin. İyi kurulmuş bir Shopify teması veya sade bir WooCommerce daha mantıklı. Headless’ın getirdiği hız farkı, bu ölçekte geliştirme maliyetini karşılamaz.

Aylık 300 bin - 1,5 milyon TL, küçük ekip veya ajans desteği: Shopify Headless tatlı nokta. Operasyon Shopify’da güvende, vitrin tarafında marka deneyimini ve Core Web Vitals’ı istediğiniz seviyeye çekersiniz. Komisyon ve plan maliyeti bu ciroda katlanılabilir.

Aylık 1,5 milyon TL üzeri veya özel iş modeli: Medusa.js ciddi şekilde masaya gelir. Bu ölçekte Shopify’ın plan + uygulama + işlem maliyetleri yıllık anlamlı bir rakama ulaşır; Medusa’da aynı bütçe bir kez geliştirmeye harcanır, işletme maliyeti VPS faturasına iner. B2B fiyat listeleri, abonelik, çoklu depo, pazaryeri modeli gibi ihtiyaçlar varsa Medusa’nın esnekliği ciro eşiğinden bağımsız olarak belirleyici olur.

Ekip sorusu da ciro kadar önemli: İçeride veya ajansınızda TypeScript bilen, sunucu yönetebilen biri yoksa Medusa’yı seçmek, bakımını yapamayacağınız bir makine satın almak gibidir. Bu durumda Shopify Headless’ın “sıkıcı ama güvenli” tarafı kazanır.

Migration Süreci: Mevcut Siteden Headless’a Geçiş Nasıl İşler?

Tipik bir WooCommerce → headless geçişi bizim uyguladığımız haliyle beş fazda ilerler ve veri temizse 6-10 hafta sürer.

1. Veri denetimi (1. hafta): Ürün, varyant, SKU, müşteri ve sipariş verisi taranır. En sık sorun burada çıkar: çift SKU’lar, varyant yerine ayrı ürün açılmış kayıtlar, tutarsız stok. Kendi geçiş projelerimizde öğrendiğimiz kural: hücrenin dolu görünmesi verinin doğru olduğu anlamına gelmez, geçmeden önce ölçün.
2. Backend kurulumu (2-3. hafta): Medusa veya Shopify tarafında katalog kurulur, veri aktarım script’leri yazılır ve deneme aktarımı yapılır.
3. Entegrasyonlar (3-5. hafta): Ödeme (iyzico/PayTR), kargo (Aras/MNG), e-Fatura. Test hesaplarıyla uçtan uca akış doğrulanır.
4. Frontend geliştirme (4-8. hafta): Vitrin Next.js ile paralel yazılır; ürün, kategori, sepet, hesap sayfaları.
5. SEO geçişi ve canlıya alma (son hafta): Eski URL yapısından yenisine eksiksiz 301 haritası, structured data’nın korunması, Search Console doğrulaması. Bu adım atlanırsa yıllarca birikmiş organik trafik birkaç haftada erir; migration projelerinde en pahalı hata budur.

Geçiş boyunca eski site canlıda kalır; yeni sistem staging’de gerçek verinin kopyasıyla test edilir, tek gecelik bir DNS geçişiyle canlıya alınır. Sürecin detaylarını WordPress migration hizmet sayfamızda ayrıca anlattık.

Karar Anı: Sizin İçin Doğru Yol Hangisi?

Özetleyelim. Headless e-ticaret 2026’da artık deneysel değil, belirli bir ölçeğin üzerinde rasyonel bir yatırım. Medusa.js size komisyonsuz, tam kontrollü, Türkiye entegrasyonlarına doğrudan bağlanabilen bir motor verir; karşılığında teknik sahiplik ister. Shopify Headless ise operasyonu sırtınızdan alır; karşılığında aylık maliyet ve checkout kısıtlarını kabul edersiniz.

Hangi yolun sizin ciro, ekip ve iş modelinize uyduğunu masaya yatırmak isterseniz, e-ticaret hizmet sayfamıza göz atın veya iletişim sayfasından ücretsiz 30 dakikalık görüşme planlayın. Mevcut sitenizin verisine bakıp size dürüst bir “geçin / geçmeyin” cevabı veriyoruz.