Sorun Giderme Rehberi — RUTHH COD Form & Upsells
Amaç ve Beklenen Sonuç
Section titled “Amaç ve Beklenen Sonuç”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.
Ön Koşullar
Section titled “Ön Koşullar”- Shopify Yönetim Paneli’nde RUTHH COD Form & Upsells çalışma alanına erişiminizin olması.
Numaralı Teşhis ve Çözüm Adımları
Section titled “Numaralı Teşhis ve Çözüm Adımları”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”- 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. - Gösterim Yüzeyini (
displaySurface) Kontrol Edin: Settings → Visibility (/app/settings) ekranında Form Display ayarınınDisabledolmadığını ve ürün sayfasını test ederkenCart page only(veya sepeti test ederkenProduct pages only) seçili olmadığını doğrulayın. - Ürün ve Koleksiyon Hedeflemelerini Kontrol Edin: İncelediğiniz ürünün
excludeProductGidslistesinde veyaexcludeCollectionGidsiç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. - Sipariş Tutarı Sınırlarını Kontrol Edin: Settings → Visibility altında
minSubtotalMinorveyamaxSubtotalMinortanı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”- Bu durum genellikle Güvenli Yerel Buton Korumasının (Fail-Safe Guard) tasarlandığı gibi çalıştığını gösterir.
- İ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.
- Ü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”- 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.
- Tarayıcının en güncel
cod_form.v2_snapshotrevizyonunu 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”- Form Builder → Shipping Rates (
/app/form-builder/shipping-rates) sayfasını açın. - Seçilen teslimat ülkesini ve ili kapsayan en az bir aktif kargo kuralı olduğunu doğrulayın.
- Kargo kuralının
minSubtotalMinorvemaxSubtotalMinorsı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”- Fraud Protection (
/app/fraud) sayfasını açın. - Test siparişinizin Order Velocity Limit (varsayılan
24 saatte 3 sipariş), Duplicate Order Detection (varsayılan72 saat) veya Maximum Product Quantity Limit (1..10) kurallarına takılıp takılmadığını kontrol edin. - Ofis veya test IP adresinizi
/app/fraudiçindeki Trusted IP Addresses listesine ekleyip Save butonuna tıklayın.