WooCommerce PayTR Taksit Ayarlarını Yapılandırma

WooCommerce PayTR Taksit Ayarlarını Yapılandırma

WooCommerce altyapılı e-ticaret sitelerinde ödeme dönüşümlerini artırmanın en etkili yolu, PayTR taksit seçeneklerini doğru ve hatasız bir şekilde entegre etmektir. Güncel 2026 yılı API altyapısı sayesinde, müşterilerinize sunduğunuz taksit tablosunu doğrudan ürün sayfalarında ve ödeme ekranında dinamik olarak gösterebilirsiniz.

• API Entegrasyonu: Güvenli ödeme akışı için PayTR Mağaza Paneli üzerinden alınan API Key ve API Salt bilgilerinin WooCommerce paneline hatasız girilmesi gerekir.
• Taksit Tablosu Gösterimi: Ürün sayfalarında dinamik taksit tablosunun aktif edilmesi, müşterilerin satın alma kararını doğrudan hızlandırır.
• Komisyon Oranları: PayTR panelindeki komisyon oranları ile WooCommerce üzerindeki ek ücret tanımlamalarının senkronize edilmesi kârlılığı korur.
• Test Modu Kullanımı: Canlı ödeme almaya başlamadan önce test modu aktif edilerek başarılı ve başarısız sipariş senaryoları mutlaka simüle edilmelidir.
• Uzaktan Profesyonel Destek: Teknik yapılandırmada sorun yaşamanız durumunda, süreci uzaktan bağlantı ile sizin adınıza biz tamamlıyoruz.

PayTR API Bilgilerinin WooCommerce Sistemine Tanımlanması

PayTR taksit ayarlarını yapılandırmanın ilk adımı, mağaza panelinizden alacağınız API bilgilerini WooCommerce entegrasyon ekranına doğru şekilde aktarmaktır. Bu bilgiler, web siteniz ile ödeme kuruluşu arasındaki veri trafiğini şifreleyerek güvenli alışveriş altyapısını kurmanızı sağlar.

• Mağaza paneline giriş yaparak Bilgi sekmesinden API Key değerini kopyalayın ve WooCommerce panelindeki ilgili alana yapıştırın.
• Aynı menüde yer alan API Salt değerini WooCommerce ödeme ayarlarına eksiksiz ve boşluk bırakmadan aktarın.
• Entegrasyonun sağlıklı çalışması için Mağaza No bilgisini ilgili alana doğru bir şekilde girerek değişiklikleri kaydedin.

API Bağlantı Sorunlarının Çözümü

• Sunucunuzda cURL kütüphanesinin aktif ve güncel olduğundan emin olun.
• PayTR paneli üzerinde kayıtlı olan web sitesi adresinizin, WooCommerce kurulu olan güncel adresinizle birebir eşleştiğini kontrol edin.
• SSL sertifikanızın (HTTPS) aktif ve geçerli olduğunu doğrulayın, aksi takdirde API bağlantısı güvenlik protokolleri nedeniyle reddedilecektir.

WooCommerce Ürün Sayfalarında Taksit Tablosunu Aktif Etme

Müşterilerinizin satın alma kararını kolaylaştırmak için taksit seçeneklerini doğrudan ürün detay sayfasında göstermeniz gerekir. Bu dinamik tablo, ziyaretçilerin ödeme sayfasına gitmeden önce hangi kartla kaç taksit yapabileceklerini görmelerini sağlar.

• Eklenti ayarları içerisinden “Ürün Sayfasında Taksit Tablosunu Göster” seçeneğini aktif hale getirin.
• Tablonun görüneceği konumu (fiyat altı, sepete ekle butonu altı veya sekmeler içi) temanızın yerleşimine göre seçin.
• Tasarım uyumu için tablonun sınır, yazı ve arka plan renklerini sitenizin CSS yapısıyla senkronize edin.

Taksit Tablosu Tasarım Özelleştirmeleri

• Tablo başlıklarının yazı boyutunu ve yazı tipini temanızın genel tipografisine uygun hale getirin.
• Mobil cihazlarda tablonun taşmasını önlemek için responsive (duyarlı) tasarım ayarlarını kontrol edin.
• Yalnızca belirli fiyat eşiğinin üzerindeki ürünlerde taksit tablosunun görünmesi için minimum tutar kuralı tanımlayın.

Maksimum Taksit Sınırlandırması ve Kategori Bazlı Kurallar

Yasal mevzuatlar gereği bazı ürün gruplarında taksit sınırlandırması veya tamamen taksit yasağı uygulanması zorunludur. WooCommerce üzerinde bu kuralları doğru tanımlayarak yasal risklerin önüne geçebilir ve sepeti koruyabilirsiniz.

• Gıda, kozmetik, ofis malzemeleri ve kuyumculuk gibi sektörler için maksimum taksit sınırını sıfır olarak belirleyin.
• Elektronik ürünlerde ve beyaz eşyalarda mevzuatın izin verdiği maksimum taksit sayısını aşmayacak şekilde sınırlama getirin.
• Kategori bazlı taksit kurallarını uygulamak için PayTR eklentisinin gelişmiş ayarlarını veya ek sepet kuralı eklentilerini kullanın.

Yasal Mevzuata Uygun Taksit Sınırları

• Cep telefonu satışlarında uygulanan taksit sınırlarını güncel BDDK kararlarına göre güncelleyin.
• Kozmetik ve doğrudan tüketim ürünlerinde taksit seçeneğini tamamen devre dışı bırakın.
• Farklı taksit kurallarına sahip ürünler aynı sepete eklendiğinde, sepetteki en düşük taksit sınırının geçerli olmasını sağlayın.

PayTR Komisyon Oranlarının Fiyata Yansıtılması

Ödeme kuruluşunun uyguladığı komisyon oranlarını doğrudan kâr marjınızdan düşebilir veya bu maliyeti müşteriye yansıtabilirsiniz. WooCommerce PayTR eklentisi, taksitli işlemlerde oluşacak ek komisyonları dinamik olarak sepete ekleme imkanı sunar.

• Taksit komisyon oranlarını eklenti panelindeki “Taksit Komisyonu Ekle” seçeneğiyle aktifleştirin.
• Her banka kartı ailesi için belirlenen güncel komisyon yüzdelerini manuel olarak girin veya API üzerinden otomatik çekilmesini sağlayın.
• Müşteriye yansıtılacak ek maliyetin ödeme sayfasında şeffaf bir şekilde listelendiğinden emin olun.

Komisyon Hesaplama Yöntemleri

• Tek çekim işlemlerinde komisyonu kendi üzerinize alıp, taksitli işlemlerde komisyonu müşteriye yansıtacak senaryolar kurun.
• Belirli bir sepet tutarının üzerindeki alışverişlerde taksit komisyonunu tamamen sıfırlayarak sepet tutarını artırmaya yönelik kampanyalar düzenleyin.
• Vade farkı oranlarının bankaların güncel oranlarıyla eşleştiğini belirli periyotlarla kontrol edin.

Başarılı Ödeme Dönüşümleri İçin Test Modu Yapılandırması

Entegrasyon işlemlerini tamamladıktan sonra, gerçek kartlarla işlem yapmadan önce sistemin hatasız çalıştığını doğrulamak gerekir. PayTR sandbox (test) modunu kullanarak sipariş süreçlerini uçtan uca simüle edebilirsiniz.

• PayTR eklenti ayarlarından “Test Modu” seçeneğini “Evet” olarak işaretleyin ve kaydedin.
• PayTR dokümantasyonunda yer alan test kart numaraları, son kullanma tarihi ve CVV kodlarını kullanarak örnek siparişler oluşturun.
• Başarılı ödeme senaryosunun ardından sipariş durumunun WooCommerce panelinde “İşleniyor” veya “Tamamlandı” olarak değiştiğini gözlemleyin.

Test Aşamasında Kontrol Edilmesi Gereken Senaryolar

• Yetersiz bakiye veya yanlış kart bilgisi girildiğinde sistemin verdiği hata mesajlarının kullanıcı dostu olup olmadığını test edin.
• 3D Secure yönlendirmesinin test ortamında sorunsuz çalışıp çalışmadığını kontrol edin.
• Sipariş başarılı bir şekilde tamamlandığında müşteriye ve yöneticiye giden e-posta bildirimlerinin tetiklendiğinden emin olun.

Bildirim URL (Callback URL) Ayarlarının Doğru Yapılması

Ödeme tamamlandığında PayTR sisteminin web sitenize “ödeme başarıyla alındı” bilgisini iletmesi için bildirim URL adresinin doğru tanımlanması şarttır. Bu ayarın eksik veya hatalı olması, siparişlerin WooCommerce panelinde “Ödeme Bekliyor” durumunda takılı kalmasına neden olur.

• WooCommerce PayTR ayarlarında size verilen özel Callback URL adresini kopyalayın.
• PayTR Mağaza Paneli > Bilgi sekmesindeki “Bildirim URL Ayarları” alanına bu adresi yapıştırıp kaydedin.
• Protokolün HTTPS olduğundan ve sitenizin harici istekleri (POST isteklerini) engellemediğinden emin olun.

Callback Hatalarını Önleme Yolları

• Güvenlik eklentilerinizin (Wordfence, iThemes Security vb.) veya sunucu tabanlı firewall sistemlerinin PayTR IP adreslerini engellemediğinden emin olun.
• Sitenizde aktif olan önbellek (cache) eklentilerinde Callback URL adresini önbelleğe alma işlemlerinden hariç tutun.
• Cloudflare kullanıyorsanız, PayTR’den gelen isteklerin bot korumasına takılmaması için özel bir WAF kuralı oluşturun.

WooCommerce ve PayTR Entegrasyonunda Sık Karşılaşılan Hatalar

Yapılandırma sürecinde yapılan küçük teknik hatalar, ödeme aşamasında müşterilerin hata almasına ve sipariş kaybına yol açabilir. Sık karşılaşılan bu sorunları önceden bilmek, sistem güvenliğini ve sürekliliğini korumanıza yardımcı olur.

• Geçersiz API anahtarı kullanımı nedeniyle oluşan “Güvenlik Hatası (Hash Doğrulanamadı)” uyarısı ve çözümü.
• Sunucu güvenlik duvarının (Firewall) PayTR IP adreslerinden gelen bildirimleri engellemesi sonucu siparişlerin askıda kalması.
• Para birimi uyuşmazlığı nedeniyle ödeme formunun yüklenememesi veya boş sayfa açılması sorunu.

Hata Günlüklerinin (Log) İncelenmesi

• WooCommerce > Durum > Günlükler adımlarını takip ederek PayTR eklentisine ait hata kayıtlarını inceleyin.
• PayTR mağaza panelindeki “Başarısız İşlemler” menüsünden reddedilen ödemelerin teknik nedenlerini kontrol edin.
• Hataların kalıcı çözümü için PHP bellek limitini (memory_limit) en az 256M seviyesine yükseltin.

Analiz: Callback URL (Bildirim URL) tanımlamasında HTTPS yerine HTTP protokolü kullanıldığında veya sunucudaki güvenlik duvarı (ModSecurity) PayTR IP adreslerini engellediğinde, ödeme başarılı olsa dahi sipariş durumu WooCommerce üzerinde "Ödeme Bekliyor" olarak kalır ve otomatik onaylanmaz.

Sıkça Sorulan Sorular

WooCommerce PayTR taksit tablosu neden görünmüyor?

Taksit tablosunun görünmemesi genellikle API bilgilerinin yanlış girilmesinden, eklenti ayarlarında ilgili seçeneğin aktif edilmemesinden veya tema uyumsuzluğundan kaynaklanır. API bağlantısının doğruluğunu ve eklenti ayarlarını kontrol etmeniz gerekir.

Kategori bazlı taksit sınırlandırmasını nasıl yapabilirim?

WooCommerce varsayılan olarak kategori bazlı taksit sınırı sunmaz; ancak PayTR eklentisinin gelişmiş ayarları veya ek sepet kuralı eklentileri kullanarak belirli kategorilerdeki ürünler için maksimum taksit sınırını yasal mevzuata göre belirleyebilirsiniz.

PayTR test modunda gerçek kredi kartı kullanılır mı?

Hayır, test modu etkinken gerçek kredi kartları çalışmaz. PayTR tarafından sağlanan ve gerçek bakiye düşürmeyen özel test kartı bilgilerini kullanmanız gerekmektedir.

Taksit komisyon oranlarını müşteriye yansıtmak yasal mıdır?

Evet, e-ticaret sitelerinde taksitli alışverişlerde oluşan vade farkı ve komisyon oranlarını müşteriye yansıtmak yasal bir uygulamadır ve WooCommerce PayTR eklentisi bu hesaplamayı otomatik olarak yapar.

Ödeme başarılı olmasına rağmen sipariş neden “Ödeme Bekliyor” durumunda kalıyor?

Bu durum tamamen Bildirim URL (Callback URL) ayarının yapılmamasından veya sunucunuzun PayTR sunucularından gelen onay bildirimini engellemesinden kaynaklanır. Callback adresinizi PayTR paneline doğru kaydetmeli ve güvenlik duvarı izinlerini kontrol etmelisiniz.

Sonuç

WooCommerce PayTR taksit ayarlarının hatasız yapılması, ödeme süreçlerinizin kesintisiz çalışması ve müşteri memnuniyeti için büyük önem taşır. Eğer bu teknik yapılandırma adımlarında sorun yaşıyorsanız veya entegrasyonu profesyonel ellere bırakmak istiyorsanız, bu işlemi uzaktan biz yapıyoruz; kapsamı ve süreyi ön analiz sonrasında baştan bildiriyoruz.

Özetle
Bu rehberde WooCommerce sitelerinde PayTR API entegrasyonu, taksit tablosu gösterimi, komisyon ayarları, kategori bazlı sınırlandırmalar ve Callback URL yapılandırması gibi kritik adımları detaylıca inceledik.

AI-Powered Analysis by MeoMan Bot