5 Kasım 2026 · 6 dk okuma

Hangi Shopify Function API'si Senin Script'ini Değiştirir: İndirimleri, Teslimatı veya Ödeme Özelleştirmesini

Shopify Scripts 30 Haziran 2026'da durdu. Her Script türünü değiştiren Function API'sinin eksiksiz haritası, limitler ve planlar.

Hangi Shopify Function API'si Senin Script'ini Değiştirir: İndirimleri, Teslimatı veya Ödeme Özelleştirmesini

Script'iniz indirim mantığını çalıştırıyorsa, Discount Function API'sine ait. Kargo oranlarını gizli tuttuysa veya yeniden sıraladıysa, bu Delivery Customization. Ödeme yöntemlerini filtrelediyse, bu Payment Customization. Bu üç Function API'si tüm Shopify Scripts yüzey alanını absorbe etti ve her birinin farklı bir yürütme aşaması, plan gereksinimi ve herhangi bir şeyi dağıtmadan önce anlamanız gereken sabit limitı vardır.

Shopify Scripts, 30 Haziran 2026'da çalışmayı durdurdu. Script Editörü, 15 Nisan 2026'da düzenlemeleri bile kilitlendi, bu nedenle o tarihten sonra hala Script'lere güvenen herhangi bir mağaza, son kapanışa kadar donmuş, değiştirilemez kod çalıştırıyordu.

Ana noktalar

  • Shopify Scripts, 30 Haziran 2026'da tamamen kullanımdan kaldırıldı; Discount, Delivery Customization ve Payment Customization Function API'leri doğrudan değiştiricilerdir.
  • API sürümü 2025-04'te (21 Mayıs 2025'te yayınlandı), Shopify ayrı Product, Order ve Shipping Discount API'lerini tek bir birleştirilmiş Discount Function API'sine daraltmıştır.
  • Özel Functions (kendi uygulamanız, bir mağaza) Shopify Plus gerektirir. Public App Store uygulamaları Functions içeren herhangi bir planda yüklenir.
  • Üç Function API'sinin her biri mağaza başına 25 etkin fonksiyona kadar izin verir.
  • Functions, 5 ms'lik sabit yürütme kapısı ve fonksiyon başına 256 KB bytecode boyut limitine sahip derlenmiş WebAssembly modülleridir.

Kod yazmadan önce harita neden önemli

Script geçişinden sonra gördüğüm en sık hata, eski Script'inde "indirim" kelimesini okuyan ve Script aslında kargo ağırlığına göre kargo oranını gizliyor olsa bile hemen Discount Function API'sine uzanan bir geliştiricidir. Bu yanlış API'dir. Sonuç, derlenip dağıtılan ancak checkout'ta kesinlikle hiçbir şey yapmayan ve göstermesi için bir hata olmayan bir fonksiyondur.

Doğru zihinsel model, Shopify'ın Functions belgelerinde açıklandığı gibi:

  • Cart Transform "sepet ne içeriyor?" sorusunu yanıtlar (paketler, genişleten satır öğeleri)
  • Discount "hangi fiyat ayarlamaları uygulanır?" sorusunu yanıtlar
  • Delivery Customization "hangi kargo seçenekleri gösterilir?" sorusunu yanıtlar
  • Payment Customization "hangi ödeme yöntemleri gösterilir?" sorusunu yanıtlar

Shopify bunları bu sırayla çalıştırır. Bir paketin oluşturduğu Cart Transform, Discount Function'unuz sepeti görmeden önce çalıştırılmıştır. Discount sonuçları Delivery ve Payment Customization çalışmadan önce sonlandırılmıştır.

Tam Script-to-Function haritalaması

Eski Shopify Script türüFunction API değiştirmesiNeler yapabilirPlus gerekli?
Line item Script (fiyat/indirim)Discount Function APIÜrün indirimleri, sipariş alt toplamı indirimleri, kargo indirimleriÖzel uygulama: Plus. Public uygulama: herhangi bir plan
Shipping Script (oran görünürlüğü)Delivery CustomizationKargo oranlarını gizle, yeniden adlandır, yeniden sıralaÖzel uygulama: Plus. Public uygulama: herhangi bir plan
Shipping Script (oran fiyatlandırması)Discount Function API (shipping class)Bir kargo oranı maliyetini azalt veya sıfırlaÖzel uygulama: Plus. Public uygulama: herhangi bir plan
Payment ScriptPayment CustomizationÖdeme yöntemlerini gizle, yeniden adlandır, yeniden sıralaÖzel uygulama: Plus. Public uygulama: herhangi bir plan

Bir kargo Script'inin iki iş yaptığını (bir oranı GİZLEMEK VE indirimlemek) unutmayın; bunun yerine iki ayrı Function API'sine ihtiyaç duyar. Bu, geçişin bire bir değiştirilmediği tek durumdur.

Discount Function API: 2025-04'te ne değişti

21 Mayıs 2025 tarihinden önce üç ayrı Function API vardı: Product Discount, Order Discount ve Shipping Discount. Shopify, sürüm 2025-04'te birleştirilmiş Discount Function API'sini yayınladıktan sonra her üçü de amortisman bildirimlerini taşıdı. Hâlâ eski bireysel API'leri hedefleyen Functions'larınız varsa, geçiş rehberi shopify.extension.toml'de api_version = "2025-04" tabanını ayarlar.

Yeni API her şeyi iki hedefe katlıyor:

  • cart.lines.discounts.generate.run ürün ve sipariş seviyesi indirimleri için
  • cart.delivery-options.discounts.generate.run kargo indirimleri için

Bir function artık ürünleri, sipariş alt toplamını ve kargoyu tek bir geçişte indirimleyebilir. Dönüş şekli de değişti: discounts dizisinin discountApplicationStrategy ile eşleştirilmesi yerine, function bir operations dizisi döndürür.

"100 dolardan fazla siparişlerde yüzde 10 indirim" için minimal bir JavaScript Discount Function şöyle görünür:

// shopify.extension.toml: api_version = "2025-04"
export function run(input) {
  const subtotal = input.cart.cost.subtotalAmount.amount;
  if (parseFloat(subtotal) < 100) return { operations: [] };
  return {
    operations: [
      {
        cartLinesDiscountsApply: {
          targets: input.cart.lines.map(l => ({ cartLineId: l.id })),
          value: { percentage: { value: "10.0" } },
        },
      },
    ],
  };
}

Metafields'da depolanan karmaşık fiyatlandırma tabloları olan bir katalogda seni yakacak bir tuzak: bir metafield değeri 10.000 baytı aşarsa, Function girişi hata değil, o alan için null döndürür. Her yerel test geçer, üretim sessizce hiçbir şey okumaz.

Discount Functions'ların sabit limitleri

  • Mağaza başına maksimum 25 etkin Discount Functions
  • Fonksiyon başına 256 KB Wasm bytecode
  • 5 ms sabit yürütme başlığı (function aşılırsa iptal edilir ve işlemler göz ardı edilir)
  • GraphQL input sorgusu: maksimum 3.000 bytes, hesaplanan maliyet 30'dan fazla olmayan, list-type alan argümanları 100 öğeyle sınırlı

Delivery Customization: kargo Script'i değiştirmesi

Delivery Customization, oran alışveriş adımında çalışır, Shopify mevcut taşıyıcı oranlarını getirdikten sonra ancak alıcı onları görmeden önce. Desteklediği işlemler hide, move (yeniden sırala) ve rename'dir.

Bir Rust snippet'i, hedef bir ülke dışındaki adresler için ücretsiz teslimatı gizler:

#[shopify_function]
fn cart_delivery_options_transform_run(
    input: schema::cart_delivery_options_transform_run::Input,
) -> Result {
    let country = input
        .cart
        .delivery_groups
        .first()
        .and_then(|g| g.delivery_address.as_ref())
        .and_then(|a| a.country_code.as_ref())
        .map(|c| c.as_str())
        .unwrap_or("");

    if country == "US" {
        return Ok(schema::CartDeliveryOptionsTransformRunResult { operations: vec![] });
    }
    // find and hide the free delivery option handle
    // ...
}

Bu model, 10.000+ SKU'su olan mağazalarda sabit gelmektedir; burada bazı ürünler aşırı boyutludur ve belirli taşıyıcılar için uygun değildir. Function, ağırlık da dahil olmak üzere tam teslimat grubu bağlamını alır, bu nedenle mantık düzdür; tuzak, satır öğeleri değil teslimat grupları üzerinde çalışıyor olmaktır, bu nedenle loop yapısı bir Discount Function'undan farklıdır.

Ana Delivery Customization gerçekleri

  • Mağaza başına maksimum 25 etkin Delivery Customization Functions
  • POS'ta uygulanmaz (functions çalışır ancak işlemler göz ardı edilir)
  • Kuralı tetikleyen ülke veya etiket yapılandırması, tüccarlar redeploy'a ihtiyaç duymaksızın değiştirebilsin diye bir metafield'da depolanması en iyisidir (bkz. Functions + metafields deseni)
  • Teslimat seçenekleri, kargo taşıyıcıları, yerel teslimat ve alma seçeneklerini içerir. Üçü de aynı API tarafından adreslenir

Payment Customization: ödeme Script'i değiştirmesi

Payment Customization, checkout render'ında, checkout pipeline'ının 6. aşamasında çalışır, tüm indirimler ve teslimat maliyetleri sonlandırıldıktan sonra. İşlemler hide, move ve rename'dir, artı iki B2B'ye özel: ödeme koşullarını ayarla ve inceleme gereksinimi ekle (sipariş'i taslak olarak gönderir).

export function run(input) {
  const total = parseFloat(input.cart.cost.totalAmount.amount);
  const hideOps = input.paymentMethods
    .filter(pm => /cash on delivery|cod/i.test(pm.name) && total > 500)
    .map(pm => ({ paymentMethodHide: { paymentMethodId: pm.id } }));
  return { operations: hideOps };
}

Resmi API belgelerinden iki önemli uyarı:

  • Payment Customization Functions POS'ta hiç işlem uygulamaz.
  • Shop Pay'de, Payment Customization Functions yalnızca yerel hediye kartı alanında işlemleri uygular. Diğer tüm ödeme yöntemleri bu yüzeyde fonksiyonun erişiminin dışındadır.

B2B için, ödeme koşulları API'si bir depozito yüzdesini (1-99%) ve izin verilen setten bir due-in-days değerini ayarlamanıza izin verir: 7, 15, 30, 45, 60 veya 90 gün.

Payment Customization limitleri

  • Mağaza başına maksimum 25 etkin Payment Customization Functions
  • Bazı işlemler Plus'a özel (inceleme gereksinimleri ve ödeme koşulları)
  • Ağ erişimine sahip Functions (function'ın içinden harici bir API'ye çağrı yapma) Plus ve Shopify onayı gerektirir

Plan gereksinimleri, yan yana

YolDiscountDelivery CustomizationPayment Customization
Public App Store uygulamasıHerhangi bir planHerhangi bir planHerhangi bir plan
Özel uygulama (senin kodun, bir mağaza)PlusPlusPlus
Plus'a özel işlemler (koşullar, inceleme)YokYokPlus
Function'ın içinde ağ erişimiPlus + onayPlus + onayPlus + onay

Plan resmi, çoğu geçiş kılavuzunun üzerinden atladığı detaydır. Scripts, tanım gereği Plus'tu, bu nedenle Script'i çalıştıran her mağaza zaten Plus'tu. Geçişten sonra, Plus'tan düşüren bir tüccar özel uygulamayı kaybeder, yüklü Public uygulamayı değil. Bu, handoff notlarınızda belgelemek için değerdir.

Function'larınızın gerçekten çalıştığını doğrulama

Shopify yöneticisinin Scripts customizations raporu (Ayarlar'ın altında) 30 Haziran 2026'dan önce etkin olan Script'leri Function-API'si karşılıklarıyla eşler ve ilgili uygulamalara bağlar. Bunu tamamlanmanın kanıtı olarak değil, checklist olarak kullanın.

Bir Function'ın çalışıp çalışmadığını doğrulamak için:

  1. Shopify yöneticisini açın, İndirimlere gidin (veya API türüne bağlı olarak Teslimat özelleştirmeleri / Ödeme özelleştirmeleri).
  2. Etkin Function orada bir durum göstergesi ile bir giriş olarak görünür.
  3. Standart checkout'tan, Shop Pay'den ve taslak bir siparişten bir test siparişi verin. Her yüzey farklı davranır.
  4. Delivery ve Payment Customization için, bu kanal etkinse POS'ta da test edin, çünkü her iki API de şu anda POS'ta işlemleri atlıyor.
  5. Discount Functions için, Admin GraphQL API'si aracılığıyla siparişte discountAllocations beklentilerle eşleştiğini kontrol edin (order.discountAllocations { allocatedAmountSet { shopMoney { amount } } discountApplication { ... } }).

Hiçbir Function olay, standart Shopify günlüklerinde görünmez, bu nedenle tek güvenilir doğrulama, sipariş seviyesi veri incelemesi ve geliştirme mağazasına karşı entegrasyon testidir.

JavaScript vs. Rust'ı seçme

İkisi de resmi olarak desteklenmektedir. Rust daha sıkı bytecode'a derler ve kabaca 3-5x daha iyi cold-start gecikmesi sunuyorsa da, basit indirim ve teslimat mantığı için fark 5 ms duvarında zar zor fark edilir. Javy toolchain aracılığıyla JavaScript, çoğunluk gerçek dünya Functions için yeterlidir. Derin iç içe tier hesaplamaları veya yönerge sayısının önemi kazandığı büyük metafield yönlendirme tablolarınız olduğunda Rust'a ulaşın.

İki Functions'a ihtiyaç duyduğu kargo Script'i

Her zaman ikinci bir konuşmaya neden olan harita: belirli oranları gizleyen ve diğerlerini indirimleyen bir kargo Script'i artık bir Delivery Customization Function (gizleme/yeniden sıralama için) ve kargo sınıfını hedefleyen bir Discount Function (oran fiyatını düşürmek için) gerektirir. Ayrı pipeline aşamalarında çalışır ve tek bir API çağrısında birleştirilmez. Scope'u başlangıçta doğru belirleyin; bu tipik olarak kolay bir değil, orta eforta sahip bir geçiştir.

Bu işi dışarıya vermek isterseniz, stüdyom Lintel Shopify Functions geliştirme hizmeti veriyor.

shopify functionsshopify scriptsdiscount functiondelivery customizationpayment customization

Sıkça sorulan sorular

Hangi Shopify Function API'si line item Scripts'i değiştirir?

Line item Scripts, Discount Function API'si tarafından değiştirilir; bu API sürüm 2025-04'ten beri ürün indirimleri, sipariş alt toplamı indirimleri ve kargo indirimlerini tek bir birleştirilmiş API'de işler. Özel Discount Functions Shopify Plus gerektirir; Functions içeren Public App Store uygulamaları herhangi bir planda çalışır.

Shopify Functions'u kullanmak için Shopify Plus'a ihtiyacım var mı?

Yalnızca Functions içeren özel uygulamalar ve ödeme koşulları ve inceleme gereksinimleri gibi belirli Plus'a özel işlemler için. Functions'u sarmalayan Public App Store uygulamaları herhangi bir Shopify planında yüklenirler, ki bu Scripts'ten fark yaratan bir değişikliktir; Scripts'ler tamamen Plus'tu.

Payment Customization Functions Shop Pay ve POS'ta çalışır mı?

Tam olarak değil. POS'ta, Payment Customization Functions çalışır ancak işlemleri uygulanmaz. Shop Pay'de, function yalnızca yerel hediye kartı alanında işlemleri uygular; diğer tüm ödeme yöntemleri o yüzeyde function'ın erişiminin dışındadır.

Yedi yıllık Shopify, tek sayfada.

Roller, projeler, teknoloji yığını ve sertifikalar özgeçmişte.

Özgeçmiş PDF indir LinkedIn