Shopify Checkout Extensibility: Rehber ve Türkiye Örnekleri

Kısa cevap

Shopify Checkout Extensibility, Shopify ödeme sayfasını kod düzenlemeden değil; uygulama eklentileri (Checkout UI extensions), Shopify Functions, marka ayarları ve web pixel’ler gibi güncellemeye dayanıklı yapı taşlarıyla özelleştirme modelidir. Eski checkout.liquid dosyası bilgi, kargo ve ödeme adımları için Plus mağazalarda 13 Ağustos 2024’te devreden çıktı; teşekkür ve sipariş durumu sayfalarındaki checkout.liquid ve ek komut dosyaları (additional scripts) için son tarih Plus mağazalarda 28 Ağustos 2025, diğer planlarda 26 Ağustos 2026 oldu.

Kısacası 2026 sonu itibarıyla Shopify’da ödeme sayfasını özelleştirmenin tek yolu Checkout Extensibility’dir. Hazır uygulamalarla yapılan basit özelleştirmeler birkaç günde, Türkiye’ye özgü alanlar (TCKN/VKN, KVKK onayı, teslimat tarihi) için özel eklenti geliştirmesi 2–6 haftada tamamlanır.

Bu rehber, 7 yıldır Shopify markalarına hizmet veren Shopify Plus Partner’ı Byte Digital ekibinin saha deneyimiyle hazırlanmıştır.

checkout.liquid’e ne oldu? Önemli tarihler

checkout.liquid artık desteklenmiyor; ödeme sayfasındaki tüm özelleştirmeler Checkout Extensibility yapı taşlarına taşınmak zorundadır. Shopify’ın geliştirici dokümanına göre checkout.liquid bilgi, kargo ve ödeme adımlarında desteklenmez, teşekkür ve sipariş durumu sayfalarında da kullanımdan kaldırılmıştır (Shopify checkout.liquid).

Eski yapıda teşekkür sayfasına eklenen dönüşüm kodları, anket araçları veya özel mesajlar artık eklentiler ve web pixel’lerle yeniden kurulmalıdır. Takip kodlarının yeni yapıya taşınmasını Shopify server-side tracking ve Consent Mode yazımızda ayrıntılı anlattık.

Checkout Extensibility’nin yapı taşları ve plan farkları

Checkout Extensibility dört ana yapı taşından oluşur ve en önemli plan farkı şudur: bilgi, kargo ve ödeme adımlarına eklenti yerleştirmek yalnızca Shopify Plus’ta mümkündür; teşekkür ve sipariş durumu sayfaları ise Starter dışındaki tüm planlarda özelleştirilebilir. Plan farklarının güncel özetine Shopify’ın teknoloji sayfasından bakabilirsiniz (Shopify checkout teknolojileri).

Pratikte bu şu anlama gelir: Plus dışındaki bir mağaza, App Store’daki Functions tabanlı uygulamalarla özel indirim kurallarını veya ödeme yöntemi gizlemeyi kullanabilir, ama ödeme adımına özel bir TCKN alanı ekleyemez. Plus mağazalar ise kendi özel uygulamalarıyla her adımı özelleştirebilir. Eklentiler Shopify’ın arayüz bileşenleriyle çalışır ve paket boyutu sınırlıdır (64 KB); bu yüzden ödeme sayfasında serbest HTML veya ağır script çalıştırılamaz.

Türkiye’deki mağazalar için kullanım senaryoları

Türk Shopify mağazalarında Checkout Extensibility en çok e-fatura bilgisi toplamak, hukuki onayları almak ve ödeme ile teslimat seçeneklerini yerel kurallara göre düzenlemek için kullanılır.

• TCKN/VKN ve e-fatura alanları (Plus): Bireysel veya kurumsal fatura seçimi, TCKN, VKN ve vergi dairesi alanları bilgi adımına eklenir; değerler sipariş metafield’ına yazılır ve ERP veya e-fatura entegrasyonu buradan okur. Plus dışındaki mağazalarda bu bilgi genellikle sepet sayfasında toplanır.

• Format doğrulama: Sepet ve ödeme doğrulama fonksiyonu (cart and checkout validation) ile 11 haneli TCKN veya 10 haneli VKN girilmeden ödemeye geçilmesi engellenebilir.

• KVKK aydınlatma ve açık rıza onay kutusu (Plus): Aydınlatma metni bağlantısı ve ayrı bir açık rıza onay kutusu ödeme sayfasına eklenebilir; pazarlama izni için Shopify’ın kendi e-posta ve SMS izin alanları kullanılmalıdır. Konunun hukuki tarafı için KVKK ve ETBİS uyumluluk rehberimize bakabilirsiniz.

• Hediye notu ve paket seçeneği (Plus): Hediye notu alanı ve hediye paketi tercihi ödeme sayfasına taşınarak sepet sayfasında unutulan notlar azaltılır.

• Teslimat tarihi seçimi (Plus): Shopify’ın resmi örneğinde olduğu gibi, belirli bir kargo seçeneği seçildiğinde tarih seçici gösterilebilir ve seçilen tarih sipariş metafield’ına yazılır.

• Ödeme yöntemi kuralları (tüm planlar, uygulamayla): Belirli tutarın üzerindeki sepetlerde kapıda ödemenin gizlenmesi veya ödeme yöntemlerinin sıralanması Functions ile yapılır. Kart ödemesi tarafı için Shopify iyzico entegrasyonu ve Shopify sanal POS kurulumu yazılarımıza göz atabilirsiniz.

• Teşekkür sayfası (tüm planlar): Kargo süresi bilgisi, WhatsApp destek bağlantısı, anket veya sonraki siparişe özel indirim kodu gösterilebilir.

Checkout Extensibility’ye geçiş ve özelleştirme adım adım

Hazır uygulamalarla yapılan bir özelleştirme 3–5 iş gününde, özel eklenti geliştirmesi gerektiren Plus projeleri 2–6 haftada tamamlanır.

1. Envanter çıkarma (1–2 gün): Ödeme ve teşekkür sayfasındaki tüm özelleştirmeler, ek komut dosyaları, takip kodları ve varsa Shopify Scripts listelenir. Shopify yönetim panelindeki yükseltme raporu bu adımda yol gösterir.

2. Eşleştirme (1–2 gün): Her özelleştirme için karşılık belirlenir: hazır uygulama, Checkout UI extension, Function, web pixel veya artık gerekmiyor.

3. Hazır uygulama kurulumu (1–3 gün): App Store’daki uygulamalar kurulur ve ödeme sayfası düzenleyicisinde (checkout editor) bloklar yerleştirilir.

4. Özel geliştirme (1–4 hafta, gerekiyorsa): TCKN/VKN alanları, KVKK onayı, doğrulama fonksiyonları ve ERP’ye veri aktarımı için özel uygulama geliştirilir.

5. Takip kodlarının taşınması (2–3 gün): Ek komut dosyalarındaki dönüşüm kodları web pixel’lere veya sunucu taraflı takibe taşınır, Consent Mode ayarları doğrulanır.

6. Test ve yayın (2–3 gün): Farklı ödeme yöntemleri, mobil cihazlar, indirimli sepetler ve bireysel ile kurumsal fatura senaryoları test edilerek yeni yapı yayına alınır.

Maliyeti belirleyen başlıca faktörler: mağazanın Plus olup olmaması, özel alan ve doğrulama sayısı, verilerin ERP veya e-fatura sistemine aktarılması, taşınacak takip kodu sayısı ve Shopify Scripts’ten Functions’a taşınacak mantığın karmaşıklığı.

Shopify Checkout Extensibility’de en sık yapılan 6 hata

Checkout Extensibility projelerinde hataların çoğu, eski yapıdaki özelleştirmelerin birebir kopyalanmaya çalışılmasından ve veri akışının uçtan uca test edilmemesinden kaynaklanır.

1. Teşekkür sayfasındaki takip kodlarını unutmak: Ek komut dosyaları kaldırıldığında dönüşüm ölçümü sessizce durur ve reklam performansı düşmüş gibi görünür.

2. Plus’a özgü özellikleri her plana açık sanmak: Bilgi, kargo ve ödeme adımı eklentileri Plus dışında çalışmaz; proje planı buna göre kurulmalıdır.

3. Toplanan veriyi siparişe yazmamak: TCKN veya teslimat tarihi ödeme sayfasında alınıp metafield’a doğru yazılmazsa ERP ve e-fatura tarafı bu veriyi göremez.

4. Format doğrulaması yapmamak: Eksik veya hatalı TCKN/VKN, e-fatura kesiminde geri dönüşlere ve manuel düzeltmeye yol açar.

5. Ödeme sayfasını gereksiz bloklarla doldurmak: Her ek alan dönüşüm oranını etkileyebilir; yalnızca yasal veya operasyonel olarak gerekli alanlar eklenmelidir.

6. Mobilde test etmemek: Ödemelerin büyük kısmı mobilden geldiği için eklentiler küçük ekranlarda ve farklı ödeme yöntemleriyle ayrı ayrı denenmelidir.

Byte Digital ile Shopify Checkout Extensibility

Byte Digital, İstanbul merkezli bir Shopify Plus Partner’ıdır ve 7 yıldır Türkiye’nin önde gelen markalarına Shopify kurulumu, geçiş ve entegrasyon hizmeti verir. Checkout Extensibility projelerinde mevcut özelleştirmelerin envanterinden TCKN/VKN alanları, KVKK onayı ve Functions geliştirmesine kadar süreci yönetiyor, yayın sonrasında Shopify teknik destek ekibimizle ödeme sayfasının sağlığını izliyoruz.

Mevcut planınızı, ödeme sayfasında ihtiyaç duyduğunuz alanları ve kullandığınız ERP veya e-fatura sistemini paylaşın; size uygun çözümü, süreyi ve tahmini bütçeyi içeren ücretsiz bir ön değerlendirme hazırlayalım.

Ücretsiz Checkout Extensibility ön değerlendirmesi talep edin →

Sık sorulan sorular

checkout.liquid hâlâ kullanılabilir mi?

Hayır. checkout.liquid bilgi, kargo ve ödeme adımlarında desteklenmiyor; teşekkür ve sipariş durumu sayfalarında da Plus için 28 Ağustos 2025, diğer planlar için 26 Ağustos 2026 itibarıyla kullanımdan kalktı.

Checkout Extensibility yalnızca Shopify Plus için mi?

Hayır. Teşekkür ve sipariş durumu sayfası eklentileri, Functions içeren App Store uygulamaları ve web pixel’ler Starter dışındaki tüm planlarda kullanılabilir. Bilgi, kargo ve ödeme adımlarına eklenti yerleştirmek ise yalnızca Plus’ta mümkündür.

Shopify ödeme sayfasına TCKN alanı eklenebilir mi?

Shopify Plus mağazalarda Checkout UI extension ile eklenebilir ve değer sipariş metafield’ına yazılır. Plus dışındaki mağazalarda bu bilgi genellikle sepet sayfasında toplanır.

Shopify Scripts yerine ne kullanılıyor?

Shopify Scripts 30 Haziran 2026’da tamamen çalışmayı durdurdu. İndirim, ödeme ve kargo yöntemi mantığı artık Shopify Functions ile kurulur.

Teşekkür sayfasındaki dönüşüm kodları nereye taşınır?

Ek komut dosyalarındaki kodlar web pixel eklentilerine (müşteri olayları) veya sunucu taraflı takibe taşınır. Reklam platformlarının resmi Shopify uygulamaları bu olayların çoğunu kendi pixel’leriyle karşılar.

Ödeme sayfasında serbest HTML veya JavaScript çalıştırılabilir mi?

Hayır. Checkout UI extensions Shopify’ın arayüz bileşenleriyle çalışır ve güvenli bir ortamda yürütülür. Bu kısıt, ödeme sayfasının hızını ve güvenliğini korumak için getirilmiştir.