checkout.liquid ve Shopify Scripts sonrası ödeme sayfası

Shopify son birkaç yıldır ödeme sayfasını özelleştirmenin iki eski yolunu kademeli olarak kaldırıyor. Birincisi checkout.liquid: Plus mağazaların ödeme sayfasının HTML kodunu doğrudan düzenlemesini sağlayan bir tema dosyası. İkincisi Shopify Scripts: ödeme sırasında fiyatları, kargo ücretlerini ve ödeme yöntemlerini değiştiren küçük Ruby programları.

İkisi de artık kullanımdan kalktı ve tüm son tarihler geride kaldı. Mağazanız otomatik olarak yükseltildiyse sipariş almaya devam ediyor. Yine de özel kurallar, takip kodları ve tasarım değişiklikleri kimse fark etmeden devre dışı kalmış olabilir. Bu yazıda neyin değiştiğini, eski araçların yerine neyin geldiğini ve geçişten sonra bir mağazayı nasıl kontrol ettiğimizi anlatıyoruz.

Önemli tarihler

Eski yazılarda Scripts için daha erken tarihler geçiyor. Shopify bu son tarihi erteledi, bu yüzden okuduğunuz kaynağın tarihine dikkat edin. Yukarıdaki tarihler Shopify'ın değişiklik günlüğünden, geliştirici dokümanlarından ve Yardım Merkezi'nden alındı.

• 13 Ağustos 2024. checkout.liquid, Bilgi, Kargo ve Ödeme adımlarında çalışmayı bıraktı. Shopify bunu ilk kez Şubat 2023'te duyurmuştu.
• 6 Ocak 2025. Shopify, checkout.liquid kullanmaya devam eden ödeme sayfalarını otomatik olarak yükseltmeye başladı ve mağazalara 30 gün önceden e-postayla haber verdi. Özel Liquid, JavaScript ve CSS kodları kaldırıldı. Temadaki marka ayarları yeni ödeme sayfasına aktarıldı.
• 28 Ağustos 2025. Plus mağazalarda Teşekkürler ve Sipariş durumu sayfalarındaki checkout.liquid, ek komut dosyaları (additional scripts) ve script etiketleri kullanımdan kaldırıldı.
• 15 Nisan 2026. Shopify Scripts düzenlenemez ve yayınlanamaz hâle geldi.
• 30 Haziran 2026. Tüm Shopify Scripts çalışmayı durdurdu.
• 26 Ağustos 2026. Plus dışındaki mağazaların Teşekkürler ve Sipariş durumu sayfalarını yükseltmesi gerekiyordu. Yükseltmeyen mağazaları Shopify otomatik olarak yükseltti. Aynı tarihte Plus dışındaki mağazalarda bu sayfalardaki script etiketleri de kullanımdan kaldırıldı.

Hangi araç neyin yerine geçti

Yeni araçların ortak adı Checkout Extensibility. Her biri eski yapının bir bölümünü karşılıyor.

• checkout.liquid ile yapılan görsel değişiklikler, ödeme sayfası düzenleyicisine ve marka ayarlarına taşınır. Eski özelleştirmelerin bir kısmı artık Shopify'ın standart özellikleri arasında yer alıyor, önce bunlara bakın.
• Özel bloklar, alanlar ve mesajlar Checkout UI eklentilerine taşınır. Bilgi, Kargo ve Ödeme adımlarında bu eklentiler için Shopify Plus gerekir. Eklentiler korumalı bir ortamda (sandbox) çalışır, ödeme sayfasının HTML koduna ve ödeme bilgilerine erişemez.
• Sipariş durumu sayfasındaki içerikler müşteri hesabı UI eklentilerine (customer account UI extensions) taşınır.
• Ek komut dosyaları ve takip kodları piksellere taşınır. Uygulama pikselleri, yüklediğiniz uygulamalarla gelir. Özel pikseller daha serbest bir korumalı ortamda (lax sandbox) çalışır ve JavaScript yazabilen birini gerektirir.
• Ürün satırlarına uygulanan (line item) scriptlerin karşılığı genellikle Discount veya Cart Transform Function API'leridir.
• Kargo scriptlerinin karşılığı Delivery Customization fonksiyonlarıdır. Kargo indirimleri için Discount API kullanılır.
• Ödeme yöntemlerini yeniden adlandıran, gizleyen veya sıralayan ödeme scriptlerinin karşılığı Payment Customization fonksiyonlarıdır.
• Adet sınırı gibi bir siparişi durduran kuralların karşılığı Cart and Checkout Validation fonksiyonlarıdır.

Shopify Functions, herkese açık (public) bir uygulamadan geldiğinde tüm planlarda çalışır. Fonksiyon içeren özel bir uygulama ise yalnızca Plus mağazalarda çalışır. Hazır uygulama yüklemek yerine kendi kurallarınızı geliştirmeyi düşünüyorsanız bu fark önemlidir.

Adım adım geçiş listesi

Shopify mağazanızı zaten yükseltmiş olsa bile bu listeyi uygulayın. Yükseltme sırasında neyin kaybolduğunu bu şekilde görürsünüz.

• Yönetim panelinde Ayarlar > Ödeme bölümünü açın ve mağazanıza özel hazırlanan raporu görüntüleyin. Raporu CSV olarak dışa aktarın. Raporda her özelleştirme; kaynak dosyası, kod satırları ve yükseltme önerileriyle birlikte listelenir.
• Script Editor uygulamasını açıp Shopify Scripts özelleştirme raporunu inceleyin. Bu rapor tüm scriptleri listeler, önerilen uygulamalara ve Function API eğitimlerine bağlantı verir.
• Her öğe için bir karar verin: korunacak, Shopify'ın standart bir ayarıyla değiştirilecek ya da kaldırılacak. Artık kullanmadığınız özelleştirmeleri yeniden yapmanız gerekmez.
• Koruduğunuz her öğe için bir uygulama ya da özel bir fonksiyon seçin. Uygulamanın App Store sayfasında hangi Function API'yi kullandığını kontrol edin.
• Takibi önce uygulama pikselleriyle yeniden kurun. Özel pikseli yalnızca kullandığınız aracı karşılayan bir uygulama yoksa yazın.
• Değişiklikleri taslak bir ödeme sayfası yapılandırmasında yapın. Taslağı kontrol edin, ardından yayınlayın.
• Sunduğunuz her indirim, kargo bölgesi ve ödeme yöntemiyle test siparişi verin.
• İlk iki hafta boyunca her reklam ve analiz aracındaki satın alma olaylarını Shopify'daki sipariş sayısıyla karşılaştırın.

Sık yapılan hatalar

• Takip sessizce bozulur. Satın alma olayları reklam platformlarına ulaşmaz ve kampanyalar daha az satış göstermeye başlayana kadar kimse fark etmez. Her değişiklikten sonraki bir gün içinde satın alma olaylarını kontrol edin.
• Olaylar iki kez sayılır. Aynı araç için hem uygulama pikseli hem özel piksel çalışır. Her araç için tek bir kaynak bırakın.
• İndirimler yeni şekillerde birleşir. Eskiden tek bir scriptte duran kurallar artık birkaç fonksiyona ve indirim ayarına dağılmış olabilir. Her indirimi tek başına ve diğer kampanyalarınızla birlikte test edin.
• Fonksiyon içeren özel bir uygulama, Plus dışındaki mağazalarda çalışmaz. Bu mağazalarda herkese açık bir uygulama kullanın.
• Teşekkürler sayfası ile Sipariş durumu sayfası farklı eklenti türleri kullanır. Test siparişinden sonra iki sayfayı da kontrol edin.
• Eski kodlar temada kalır. checkout.liquid ya da eski takip kodları için yazılmış snippet'ler tema dosyalarında durmaya devam edebilir. Artık hiçbir işe yaramazlar ve temada yapılacak sonraki işleri zorlaştırırlar.

Yükseltme sırasında ödeme sayfanızdan neyin kaybolduğundan emin değilseniz birlikte bakabiliriz. Ücretsiz mağaza incelemesi yapıyoruz. Dilerseniz ücretsiz bir görüşmede ödeme sayfanızı ve takip kurulumunuzu birlikte de gözden geçirebiliriz.