WooCommerce’e PayTR Nasıl Bağlanır? Kurulum ve Test

Net cevap: PayTR bağlantısı da dört aşamalık standart yolu izler — (1) PayTR mağaza başvurusu + evrak onayı, (2) PayTR’nin WooCommerce (iFrame API) eklentisinin kurulumu, (3) mağaza panelinden alınan ÜÇLÜ bilginin (Mağaza No, Mağaza Parola, Mağaza Gizli Anahtar) eklentiye işlenmesi + Bildirim URL’sinin PayTR paneline tanıtılması, (4) test modu ödemesi ve canlıya geçiş. iyzico’dan pratik farkları: kimlik üç parçadır (ikili değil), ödeme sayfası iFrame ile sitenizin İÇİNDE açılır ve Bildirim URL adımı atlanırsa siparişler ‘beklemede’ takılır — kurulumun bir numaralı destek talebi budur.
Bu rehber dört aşamayı PayTR’ye özgü ayrıntılarla verir. Kardeş kurulum iyzico rehberinde, altyapı kıyası ödeme altyapıları yazısında.
Aşama 1: PayTR Mağaza Hesabı
Onay süreci burada da takvimin patronudur.
Başvuru Düzeni
PayTR üzerinden mağaza başvurusu: firma bilgileri, yetkili evrakı, banka hesabı — süreç birkaç iş günü sürebilir; site projesiyle paralel başlatın.
Site Ön Şartları
İyzico’dakiyle aynı dörtlü burada da denetlenir: iletişim, mesafeli satış sözleşmesi, iade-teslimat sayfaları, SSL — eksiksiz site, hızlı onaydır.
Komisyon ve Hakediş
Onayla netleşen komisyon oranı ve hakediş vadesini fiyat hesabınıza işleyin: vade, nakit akış planınızın gerçek girdisidir.
Kaynak ve resmî belge: PayTR
Aşama 2: Eklenti Kurulumu (iFrame API)
Resmî modül; ödeme sitenizin içinde akar.
Doğru Paketi Bulmak
PayTR’nin WooCommerce iFrame API eklentisini mağaza panelindeki entegrasyon bölümünden/dokümandan edinin ve Eklentiler → Yeni Ekle → Yükle yoluyla kurun: üçüncü el paketlerden uzak durun.
iFrame’in Anlamı
Müşteri kart bilgilerini SİZİN sayfanızın içindeki güvenli PayTR çerçevesine girer: yönlendirme kopması yok, sepet terki daha az — tasarım bütünlüğü korunur.
Ödeme Satırı Kontrolü
Kurulum sonrası WooCommerce → Ayarlar → Ödemeler’de PayTR satırını etkinleştirin; başlığı müşteri diliyle yazın: ‘Kredi/Banka Kartı (Güvenli Ödeme)’.
Aşama 3: Üçlü Bilgi + Bildirim URL
PayTR kurulumunun kalbi ve en çok atlanan vidası.
Üçlü Kimlik
PayTR panel → Bilgi sayfasından: Mağaza No (merchant_id), Mağaza Parola (merchant_key), Mağaza Gizli Anahtar (merchant_salt) — üçü birden, boşluksuz ve doğru alanlara.
Bildirim URL Ayarı
PayTR panelindeki Bildirim URL alanına eklentinin verdiği geri dönüş adresini tanıtın: ödeme sonucu bu kanaldan gelir — tanıtılmazsa para çekilir ama sipariş ‘beklemede’ kalır; destek taleplerinin şampiyonu budur.
Taksit ve Limitler
Taksit seçenekleri, tek çekim zorunlu kategoriler ve alt limitler PayTR panelinden yönetilir: sepetinizle uyumunu kurulum günü kontrol edin.
Aşama 4: Test ve Canlıya Geçiş
Prova düzeni iyzico’yla aynı disiplinde koşulur.
Test Modu
Eklentide test modunu açıp PayTR’nin test kart bilgileriyle deneme siparişi verin: ödeme ekranının iFrame içinde açıldığını ve akışın tamamlandığını görün.
Üç Kontrol Noktası
Sipariş WooCommerce’te ‘işleniyor’a düştü mü, mailler gitti mi, PayTR panelinde işlem görünüyor mu: üç yeşil, köprünün kanıtıdır.
Canlı Mikro Test
Test modunu kapatın, kendi kartınızla düşük tutarlı gerçek sipariş + panelden iade: iade akışının siparişe yansımasını da izleyin — iyzico rehberindeki mikro test ritüeli burada da aynen geçerli.
Sık Sorunlar: PayTR’ye Özgü Arıza Haritası
Üç klasik arıza, üç net çözüm.
Sipariş ‘Beklemede’ Takılıyor
Bir numaralı şüpheli Bildirim URL’dir: PayTR panelindeki adresi eklentinin verdiğiyle karakter karakter karşılaştırın; ikinci şüpheli, güvenlik katmanının PayTR bildirimlerini engellemesidir.
‘PAYTR_TOKEN’ / Kimlik Hatası
Üçlü bilgiden biri yanlış veya boşluklu kopyalanmıştır: üçünü de panelden yeniden kopyalayıp yapıştırın — elle yazmayın.
iFrame Boş/Yüklenmiyor
Önbellek ve optimizasyon eklentileri iFrame scriptini erteliyor olabilir: ödeme sayfasını önbellek DIŞI tutun — hız rehberindeki ‘sepet-ödeme istisnası’ kuralı tam bu an içindir.
İki Altyapı Bir Arada: Strateji Notu
iyzico mu PayTR mi — bazen cevap ‘ikisi de’dir.
Tek Altyapı Sadeliği
Tek sağlayıcı: tek panel, tek muhasebe, sade sepet — çoğu mağazanın doğru başlangıcı; seçim kriterleri kıyas yazısında.
Çift Altyapı Sigortası
Yüksek ciro ve kampanya bağımlı mağazalarda ikinci sağlayıcı yedek kanaldır: birinde kesinti, diğerinde satış — sepette ikisini de sunmak da mümkündür.
Kurulumu Devretmek
Başvurudan çifte teste tüm ödeme katmanını tek elden kurduruyoruz: mağaza paketlerinin kapsamı fiyat sayfasında, sorular iletişim hattında.
PayTR Bağlandı, Mağaza Satışa Hazır mı? Son Üç Kontrol
Ödeme bağlantısı mağazanın son adımı değil, ortasıdır. Canlıya geçmeden önce üç kontrol, ilk gün yaşanan sorunların çoğunu önler.
Kargo ve vergi ayarları
Ödeme çalışıyor ama kargo ücreti yanlış hesaplanıyorsa müşteri sepeti bırakır. Kargo bölgeleri, ücretsiz kargo eşiği ve KDV ayarı ödeme testiyle birlikte denenmelidir.
Sipariş e-postaları
Müşteriye ve mağazaya giden sipariş e-postaları gerçekten ulaşıyor mu? Hosting üzerinden giden e-posta çoğu zaman spam’e düşer; kurumsal bir e-posta hesabı ve SMTP ayarı bu sorunu çözer.
Yedek ve güvenlik
Ödeme alan site hedef olur. Günlük yedek, güvenlik duvarı ve güncel eklentiler canlıya geçmeden kurulmalıdır. Alternatif altyapıyı WooCommerce iyzico entegrasyonu rehberinde anlattık; mağazayı uçtan uca kurduracaksanız ödeme, kargo ve güvenliği birlikte kuran WooCommerce ekibimize göz atın.
Sahadan Notlar
Kısa Sözlük
Hızlı Özet
Sıradaki Adım
Sık Sorulan Sorular
PayTR’yi WooCommerce’e bağlamak için ne gerekiyor?
Dört şey: onaylı PayTR mağaza hesabı, resmî WooCommerce iFrame API eklentisi, panelden alınan üçlü bilgi (Mağaza No + Parola + Gizli Anahtar) ve PayTR paneline tanıtılmış Bildirim URL. Test kartıyla prova + canlı mikro test yapmadan açılış yapılmaz.
PayTR bağlandıktan sonra mağaza canlıya alınabilir mi?
Önce üç kontrol yapılır: kargo bölgeleri ve KDV ayarı ödeme testiyle denenir, sipariş e-postalarının ulaştığı SMTP ile doğrulanır, günlük yedek ve güvenlik duvarı kurulur. Sonra canlıya geçilir.
Ödeme alınıyor ama siparişler ‘beklemede’ kalıyor, neden?
PayTR kurulumlarının bir numaralı arızası: Bildirim URL, PayTR paneline tanıtılmamış veya yanlış girilmiş demektir — ödeme sonucu mağazaya dönemiyor. Adresi eklentinin verdiğiyle karakter karakter eşleyin; ikinci şüpheli, güvenlik katmanının PayTR bildirimlerini engellemesidir.
iyzico mu PayTR mi seçmeliyim?
Çoğu mağaza için ikisi de sağlam yoldur; karar komisyon-hakediş koşulları ve panel alışkanlığıyla verilir. Yüksek cirolu ve kampanya bağımlı mağazalarda ikisini birlikte kurmak kesinti sigortasıdır: bir saatlik kesintinin maliyeti ikinci altyapının yıllık bedelini geçiyorsa çift kanal kurun.
