WordPress PayTR entegrasyonu, WooCommerce veya EDD kullanan e-ticaret sitelerinin Türk kullanıcılardan güvenli ödeme almasını sağlar. PayTR, Türkiye’nin köklü ödeme kuruluşlarından biridir ve link ile ödeme, sanal pos, taksit seçeneği gibi özelliklerle öne çıkar. Bu rehberde WordPress’e PayTR entegrasyonunu adım adım anlatıyoruz.
PayTR ödeme altyapısını kullanacağınız sitenin modeli önemlidir: tek satıcılı mağaza için WordPress e-ticaret teması, satıcı panelli yapı için WordPress pazaryeri teması tercih edilmelidir.
PayTR Nedir?
PayTR, 2009’dan bu yana hizmet veren Türkiye lisanslı bir ödeme kuruluşudur. Kredi kartı, banka kartı, havale/EFT ve link ile ödeme yöntemlerini destekler. Türkiye’deki tüm büyük bankalarla entegrasyonu mevcuttur; 3D Secure altyapısıyla güvenli ödeme sağlar. Küçük işletmelerden büyük kurumsal markalara geniş bir müşteri tabanına sahiptir.
WordPress PayTR Entegrasyonu Nasıl Yapılır?
1. PayTR Merchant Hesabı Açın
paytr.com üzerinden üye işyeri başvurusu yapın. Başvuru için şirket tipi, vergi numarası, banka hesabı ve IBAN bilgileri gerekir. Bireysel (Esnaf) başvurular da kabul edilmektedir. Onay süreci 1-3 iş günüdür.
2. Merchant ID ve Token Bilgilerini Alın
PayTR merchant paneline (merchant.paytr.com) giriş yapın. Entegrasyon → API Bilgileri menüsünden Merchant ID, Merchant Key ve Merchant Salt değerlerini kopyalayın. Bu üç değer WordPress entegrasyonunun temelidir.
3. WooCommerce PayTR Eklentisini Kurun
WordPress Admin → Eklentiler → Yeni Ekle menüsünden “PayTR” aramasını yapın. PayTR’ın resmi WooCommerce eklentisini kurun ve etkinleştirin. WooCommerce → Ayarlar → Ödemeler → PayTR iFrame seçeneğini aktif edin.
4. API Bilgilerini Girin ve Test Edin
Eklenti ayarlarına Merchant ID, Merchant Key ve Merchant Salt değerlerini girin. Test modunu etkinleştirerek PayTR’ın test kartı (4355 0840 0000 0001, CVV: 000, SKT: 12/30) ile deneme ödemesi yapın. Sipariş “İşleme alındı” durumuna geçmeli.
PayTR’ın Öne Çıkan Özellikleri
- iFrame entegrasyonu: Müşteri siteyi terk etmeden güvenli ödeme yapar
- Link ile ödeme: Fatura veya WhatsApp üzerinden ödeme linki gönderin
- Taksit seçenekleri: Tüm büyük bankalarda 2-12 taksit
- 3D Secure: Zorunlu veya isteğe bağlı 3D doğrulama
- Otomatik iade: WooCommerce üzerinden tek tıkla iade
- Abonelik desteği: WooCommerce Subscriptions ile tekrarlayan ödeme
PayTR Komisyon Oranları (2026)
PayTR komisyon oranları işlem hacmine ve kart türüne göre değişir. Genel olarak %1,5 – %2,5 + KDV aralığındadır. Yüksek hacimli işlemler için özel oran görüşmesi yapılabilir. Güncel oranlar için paytr.com/tarifeler sayfasını kontrol edin.
EDD ile PayTR Entegrasyonu
Easy Digital Downloads kullanıyorsanız, Site24 e-ticaret teması PayTR + EDD kombinasyonunu yerleşik olarak destekler. Dijital ürün (tema, eklenti, e-kitap) satışlarında PayTR iFrame entegrasyonu sorunsuz çalışır.
PayTR mi, İyzico mu?
- PayTR: Hızlı onay, link ile ödeme, abonelik desteği, iFrame ödeme
- İyzico: Kapsamlı API, kurtarma akışları, marketplace özellikleri
İkisini birden entegre etmek mümkündür ve müşteriye seçim sunmak dönüşüm oranını artırabilir. Site24 temaları her iki sistemi de destekler.
Sık Karşılaşılan Sorunlar
PayTR ödeme sayfası açılmıyor
Sitenizin HTTPS (SSL) ile çalıştığını doğrulayın. PayTR iFrame’i HTTP üzerinde çalışmaz. Ayrıca sunucu IP adresinizin PayTR tarafından engellenip engellenmediğini kontrol edin.
Merchant bilgileri hatalı uyarısı
Merchant ID, Key ve Salt değerlerini yeniden kopyalayın — başında veya sonunda boşluk olmamasına dikkat edin. Test modu açıkken canlı API bilgilerini girmeyin.
Sıkça Sorulan Sorular
PayTR başvurusu için ne gerekir?
Vergi kimlik numarası veya T.C. kimlik numarası, banka hesabı/IBAN, aktif web sitesi (e-ticaret içeriği) gereklidir. Esnaf ve şahıs şirketleri de başvurabilir.
PayTR eklentisi ücretsiz mi?
PayTR resmi WooCommerce eklentisi ücretsizdir. Ödeme yalnızca başarılı işlem başına komisyon olarak alınır; aylık abonelik veya kurulum ücreti yoktur.
PayTR ile taksit sunabilir miyim?
Evet. Merchant panelinizden taksit seçeneklerini aktif edin. WooCommerce ürün sayfasında otomatik olarak taksit seçenekleri görüntülenir.
EDD (Easy Digital Downloads) ile PayTR Kurulumu
Dijital ürün (tema, eklenti, e-kitap, kurs) satan mağazalar için Easy Digital Downloads + PayTR kombinasyonu ideal bir çözümdür. Site24 temaları bu kombinasyonu yerleşik olarak destekler. EDD ile PayTR entegrasyonu için şu adımları izleyin:
EDD PayTR Eklentisini Edinin
EDD için resmi PayTR eklentisi edd-paytr-payment-gateway adıyla mevcuttur. Eklentiyi kurun ve EDD → Ayarlar → Ödeme Sistemleri → PayTR sekmesinden yapılandırın. Merchant ID, Merchant Key ve Merchant Salt bilgilerini girerek test modunu açın; test kartıyla deneme satın alımı yapın. Sipariş “Tamamlandı” durumuna geçince canlı moda geçebilirsiniz.
EDD Lisans Ödemelerinde PayTR
EDD Software Licensing eklentisiyle lisanslı ürün satıyorsanız PayTR ile satın alım sonrası lisans anahtarı otomatik olarak üretilir ve müşteriye e-posta ile gönderilir. Taksitli satın alımlarda lisans ilk ödeme onayının ardından aktif olur. Bu özellik özellikle premium WordPress tema ve eklenti satışlarında kullanışlıdır.
PayTR Webhook Yapılandırması
PayTR, ödeme durumunu sitenize bildirmek için webhook (bildirim URL’si) kullanır. WordPress sitenizde WooCommerce kullanıyorsanız bildirim URL’si otomatik olarak oluşturulur: https://siteniz.com/wc-api/paytr_iframe. Bu URL’yi PayTR merchant panelinde Entegrasyon → Bildirim URL alanına girin. Bildirim URL’si doğru ayarlanmadığında ödemeler başarılı olsa da siparişler “Beklemede” kalır.
Webhook Test Etme
Webhook’u test etmek için PayTR merchant panelinde Test Bildirim Gönder özelliğini kullanın. Sunucu yanıtı 200 OK ise entegrasyon doğru çalışıyor demektir. 500 veya boş yanıt durumunda hosting güvenlik duvarı ayarlarını kontrol edin; bazı hosting sağlayıcıları PayTR IP adreslerini engelleyebilir.
PayTR Güvenlik Ayarları ve İpuçları
- IP kısıtlama: PayTR webhook bildirimlerini yalnızca PayTR IP aralığından kabul etmek için .htaccess veya hosting güvenlik duvarı kullanın.
- Merchant Salt değişikliği: Salt değerini düzenli aralıklarla değiştirin, eski değeri eklentiye hemen güncelleyin.
- SSL zorunluluğu: PayTR iFrame yalnızca HTTPS üzerinde çalışır; Let’s Encrypt sertifikası ücretsiz ve otomatik yenilenebilir.
- Sandbox modunu kaldırmayı unutmayın: Canlıya geçişten önce eklenti ayarlarında test modunu mutlaka kapatın.
PayTR ile Taksitli Satış Yapma
Türk tüketiciler taksit seçeneğini ödeme kararlarında önemli bir kriter olarak değerlendirir. PayTR, Garanti, Yapı Kredi, Akbank, İş Bankası, Ziraat ve diğer büyük bankaların kartlarında 2-12 taksit imkânı sunar. WooCommerce ürün sayfasında taksit tablosunu görüntülemek için PayTR eklentisinin taksit görüntüleme seçeneğini aktif edin. Taksit sayısını ve uygulanabilecek bankaları merchant panelinizden yönetebilirsiniz.
Taksitli satışlarda komisyon oranı tek çekim işlemlere göre biraz daha yüksek olabilir. Ürün fiyatlandırmanızı belirlerken taksit komisyonunu hesaba katın ya da PayTR’ın taksit farkını alıcıya yansıtma seçeneğini kullanın.
PayTR müşteri kimlik doğrulamasını reddederse ne yapmalıyım?
Bu durumda önce PayTR merchant hesabınızın canlı ortam onayını aldığını doğrulayın. Ardından eklentide Merchant ID ve Merchant Salt bilgilerinin doğru girildiğini kontrol edin. Sorun devam ederse PayTR destek hattına başvurun; IP beyaz listesi gerekebilir.
PayTR WooCommerce olmadan çalışır mı?
Evet. PayTR’ın Link ile Ödeme özelliği WooCommerce gerektirmez; müşteriye ödeme linki göndererek işlem tamamlanabilir. Ancak WordPress mağaza entegrasyonu için WooCommerce veya EDD kullanmak en kolay yoldur.
WordPress e-ticaret siteniz için PayTR entegrasyonu veya doğru tema seçimi konusunda yardım almak ister misiniz? Teknik destek ekibimize ulaşabilir ya da Site24 E-Ticaret Teması‘nı inceleyebilirsiniz.
İlgili Kaynaklar
- WordPress İyzico Kurulumu ve Entegrasyonu
- WooCommerce ile İyzico Kullanmak
- WordPress E-Ticaret Teması
- Teknik Destek
Site24 Önerisi: PayTR ile ödeme altyapınızı güçlendirdiniz; şimdi sıra müşteri deneyiminde. Essentials24 eklentisi, WooCommerce sitenize Ajax arama, gelişmiş ürün filtreleme ve marka yönetimi ekler — tek eklentiyle.
