WordPress Site
WooCommerce

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

18 Ağustos 2026 · adaptedijital
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.

1Başvuru + evrak2iFrame eklentisi3Üçlü bilgi4Bildirim URL5Test provası6Canlı mikro test

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.

PayTR Canlı Geçiş KontrolüÜçlü bilgi doğru alanlardaBildirim URL panele tanıtıldıTest siparişi üç noktada yeşilÖdeme sayfası önbellek dışıMobil iFrame denendiMikro sipariş + iade çalıştı

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.

PayTR Arıza Kaynakları (destek vakaları, temsili)Bildirim URL eksik50Üçlü bilgi hatası30Önbellek/iFrame çakışması20

İ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

Saha notu: PayTR kurulum destek taleplerinin açık ara birincisi ‘para çekildi, sipariş düşmedi’ vakasıdır ve neredeyse tamamı Bildirim URL eksiğidir. Kurulum listenizin en üstüne yazın: üçlü bilgi + Bildirim URL, ikisi birlikte tek iştir — biri olmadan diğeri yarımdır.
Onay ipucu: iyzico’ya da PayTR’ye de başvuracaksanız evrak setini tek klasörde hazırlayın: aynı belgeler iki başvuruda da kullanılır. Çift başvuru, ileride çift altyapı sigortasına geçişin kapısını da bugünden açar — evrak bir kez yorulur, iki kapı açılır.
Üçlü bilgi dersi: merchant_id / key / salt üçlüsünü şifre kasanıza TEK kayıt olarak, etiketleriyle girin: hangi değerin hangi alana gittiği karışırsa kimlik hatası kaçınılmazdır. Kopyala-yapıştır disiplini: baştaki-sondaki boşluk, bu kurulumun görünmez düşmanıdır.
iFrame tecrübesi: iFrame’in dönüşüm avantajını test gününde mobilde de doğrulayın: küçük ekranda çerçevenin taşmadan, kaydırmadan çalıştığını görün. Masaüstünde kusursuz görünen ödeme ekranı, siparişlerin çoğunun geldiği telefonda sınanmadan onaylanmış sayılmaz.
Önbellek uyarısı: ‘Ödeme sayfası bozuldu’ şikâyetlerinin gizli faili çoğu zaman dünkü hız optimizasyonudur: yeni açılan script erteleme, birleştirme veya agresif önbellek kuralı iFrame’i kırar. Hız ayarı her değiştiğinde ödeme sayfasında bir test siparişi — bu refleks, kampanya gecesi krizlerinin aşısıdır.
Strateji notu: Çift altyapıya geçmeden tek soruyla karar verin: ‘bir saatlik ödeme kesintisi bana kaç liraya mal olur?’ Rakam, ikinci sağlayıcının yıllık maliyetini geçiyorsa sigortayı kurun; geçmiyorsa sadelikte kalın. Karar duyguyla değil, bu tek satırlık matematikle verilir.

Kısa Sözlük

iFrame Ödeme: Kart ekranının site içindeki güvenli çerçevede açılması.
Üçlü Bilgi: PayTR kimliği: Mağaza No + Parola + Gizli Anahtar.
Bildirim URL: Ödeme sonucunun PayTR’den mağazaya döndüğü adres.
Çift Altyapı: Kesintiye karşı iki ödeme sağlayıcısını birlikte kullanmak.

Hızlı Özet

PayTR bağlantısı dört aşamadır: mağaza başvurusu + evrak (site ön şartları: sözleşme-iade-iletişim-SSL), resmî iFrame API eklentisinin kurulumu, üçlü bilginin (No+Parola+Gizli Anahtar) işlenmesi VE Bildirim URL’nin PayTR paneline tanıtılması (atlanırsa siparişler beklemede kalır — bir numaralı arıza), test kartıyla prova + canlı mikro test + iade kontrolü. iFrame ödemesi site içinde akar; önbellek istisnası şarttır. Yüksek ciroda ikinci altyapı (iyzico+PayTR) kesinti sigortasıdır — karar, bir saatlik kesinti maliyetinin matematiğiyle verilir.

Sıradaki Adım

Başvurunuzu bugün yapın, evrak setini iki sağlayıcı için tek klasörde hazırlayın. Kurulum günü bu rehber + kardeş iyzico rehberi yanınızda; ödeme katmanının tamamını testli-teslimli kurduralım derseniz mağaza paketleri ve iletişim hattı hazır.

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.

WooCommerce kategorisinden devam edin