TR

Sorun Giderme Rehberi — RUTHH COD Form & Upsells

Mağaza ön yüzündeki COD formu, sunucu kabul kapıları, kargo kuralları, sahte sipariş engelleri ve entegrasyonlarda karşılaşabileceğiniz yaygın yapılandırma sorunlarını hızla teşhis edip çözmek.

  • Shopify Yönetim Paneli’nde RUTHH COD Form & Upsells çalışma alanına erişiminizin olması.

1. COD Butonu veya Gömülü Form Mağazada Görünmüyor

Section titled “1. COD Butonu veya Gömülü Form Mağazada Görünmüyor”
  1. Tema Uygulama Uzantısını (App Embed) Kontrol Edin: Home (/app) sayfasını açın ve Theme App Embed rozetinin Active olduğunu doğrulayın. Değilse Enable in Theme Editor butonuna tıklayıp canlı temanızı kaydedin.
  2. Gösterim Yüzeyini (displaySurface) Kontrol Edin: Settings → Visibility (/app/settings) ekranında Form Display ayarının Disabled olmadığını ve ürün sayfasını test ederken Cart page only (veya sepeti test ederken Product pages only) seçili olmadığını doğrulayın.
  3. Ürün ve Koleksiyon Hedeflemelerini Kontrol Edin: İncelediğiniz ürünün excludeProductGids listesinde veya excludeCollectionGids içindeki bir koleksiyonda yer almadığından emin olun (Hariç Tutma Her Zaman Önceliklidir). Dahil etme listeleri doluysa ürünün bu listelerde bulunduğunu kontrol edin.
  4. Sipariş Tutarı Sınırlarını Kontrol Edin: Settings → Visibility altında minSubtotalMinor veya maxSubtotalMinor tanımladıysanız ürün veya sepet ara toplamının bu aralıkta olduğunu doğrulayın.

2. Buton Gizleme Açık Olmasına Rağmen Yerel Shopify Butonları (Sepete Ekle / Ödeme) Görünüyor

Section titled “2. Buton Gizleme Açık Olmasına Rağmen Yerel Shopify Butonları (Sepete Ekle / Ödeme) Görünüyor”
  1. Bu durum genellikle Güvenli Yerel Buton Korumasının (Fail-Safe Guard) tasarlandığı gibi çalıştığını gösterir.
  2. İlgili ürün, sepet içeriği, ülke veya ara toplam kapıda ödemeye uygun değilse mağaza koordinatörü normal satış kaybını önlemek için yerel Shopify butonlarını gizlemez.
  3. Ürün ve sepet tüm COD görünürlük koşullarını sağladığında yerel buton gizleme kuralı otomatik olarak devreye girer.

3. Sipariş Gönderiminde FORM_CONFIG_REVISION_MISMATCH Hatası Alınıyor

Section titled “3. Sipariş Gönderiminde FORM_CONFIG_REVISION_MISMATCH Hatası Alınıyor”
  1. Bu durum, alıcıda (veya kendi test sekmenizde) formun eski bir versiyonu açıkken yönetim panelinde bir değişiklik kaydedildiğinde oluşur.
  2. Tarayıcının en güncel cod_form.v2_snapshot revizyonunu yüklemesi için mağaza sayfasını yenileyip tekrar gönderin.

4. Uygun Kargo Seçeneği Çıkmıyor / Sipariş Kargo Kapısında Reddediliyor

Section titled “4. Uygun Kargo Seçeneği Çıkmıyor / Sipariş Kargo Kapısında Reddediliyor”
  1. Form Builder → Shipping Rates (/app/form-builder/shipping-rates) sayfasını açın.
  2. Seçilen teslimat ülkesini ve ili kapsayan en az bir aktif kargo kuralı olduğunu doğrulayın.
  3. Kargo kuralının minSubtotalMinor ve maxSubtotalMinor sınırlarını kontrol edin; bu sınırların indirim öncesi fiyata değil, Adet İndirimi sonrasındaki net ürün ara toplamına uygulandığını unutmayın.

5. Mağaza Testleri Sırasında Test Siparişleri Engelleniyor

Section titled “5. Mağaza Testleri Sırasında Test Siparişleri Engelleniyor”
  1. Fraud Protection (/app/fraud) sayfasını açın.
  2. Test siparişinizin Order Velocity Limit (varsayılan 24 saatte 3 sipariş), Duplicate Order Detection (varsayılan 72 saat) veya Maximum Product Quantity Limit (1..10) kurallarına takılıp takılmadığını kontrol edin.
  3. Ofis veya test IP adresinizi /app/fraud içindeki Trusted IP Addresses listesine ekleyip Save butonuna tıklayın.