WordPress PayTR kurulumu; WordPress panelinden PayTR Sanal POS WooCommerce – iFrame API eklentisini kurmak, PayTR Mağaza Panelinden alınan Mağaza No, Mağaza Parola ve Mağaza Gizli Anahtar bilgilerini eklenti ayarlarına girmek ve Mağaza Panelindeki Bildirim URL (Callback) ayarını WooCommerce olarak seçmek işlemlerinden oluşur. Bu üç adım tamamlandığında sepetten ödeme sayfasına geçen müşteri, siteyi terk etmeden iFrame üzerinde kart bilgisini girer ve sipariş otomatik olarak güncellenir. PayTR’ın resmî dokümanına göre canlı moda geçmeden önce 1 veya 2 kere test işlemi yapılması gerekir. Aşağıda WooCommerce ve Easy Digital Downloads (EDD) senaryolarını, iFrame ile Direkt API arasındaki farkı ve en sık karşılaşılan hataların çözümünü sırasıyla bulacaksınız.
Ödeme altyapısını kuracağınız sitenin modeli, kurulumun kapsamını da belirler: kendi ürünlerinizi sattığınız tek satıcılı mağaza için WordPress e-ticaret teması, birden fazla satıcının ürün listelediği komisyonlu yapı için WordPress pazaryeri teması uygundur. Pazaryeri modelinde ödeme bölüşümü ve komisyon akışı devreye girdiği için yapılandırma tek mağazalı kuruluma göre daha fazla kontrol ister.
PayTR nedir, WordPress tarafında ne iş yapar?
PayTR, Türkiye’de faaliyet gösteren bir ödeme ve elektronik para kuruluşudur. WordPress tarafındaki işi tek cümleyle şudur: müşterinin kart bilgisini sizin sunucunuza hiç düşürmeden almak, bankayla 3D Secure doğrulamasını yürütmek ve sonucu sitenize bildirmek. Bu ayrım önemli, çünkü kart verisinin sitenizden geçmemesi hem uyum yükünü hem de olası bir güvenlik olayının sonucunu ciddi biçimde küçültür.
Resmî WordPress.org eklenti sayfasındaki tanım süreci net anlatıyor: müşteri ürünü seçer, ödeme formunu sitede doldurur ya da ortak ödeme sayfasına yönlenir, PayTR’a üyelik yapmadan ödemesini tamamlar, işlem güvenlik altyapısı tarafından doğrulanır ve siteye başarı bilgisi döner. Aynı sayfada eklentinin 10 kullanıcı yorumu ve “aidat ücreti bulunmayan PayTR” ifadesiyle “Ertesi İş Günü” ödeme avantajı da açıkça belirtiliyor.
PayTR ödeme çözümlerini tercih etmeniz için birkaç neden: Çalışma seçenekleri uygundur, aidat veya gizli ücretler yoktur. Entegrasyon süreci kolay ve hızlı işler, hazır modüller ve örnek kodlama sunulur. — PayTR Sanal POS WooCommerce – iFrame API, WordPress.org eklenti sayfası
Pratik sonuç: WordPress mağazanız için PayTR bir “eklenti” değil, bir mağaza hesabı + eklenti + bildirim URL’si üçlüsüdür. Üçünden biri eksikse ödeme akışı yarım kalır — en sık görülen senaryo da tam olarak bu. Kurulum sırasında bu üç bileşeni ayrı ayrı doğrulamak, sonradan “ödeme geçti ama sipariş yok” tipi sorunların önünü baştan kapatır.
Kurulum öncesi kontrol listesi
Eklentiyi kurmadan önce şu maddeleri tamamlamak, sonradan geri dönüp uğraşmayı önler. Deneyimimiz şunu gösteriyor: entegrasyon sorunlarının büyük kısmı eklenti hatası değil, eksik ön hazırlıktır.
- Aktif PayTR mağazası: Eklentinin gereksinimler bölümünde “WooCommerce eklentisi ile birlikte PayTR’da bir mağazanız olması gerekmektedir” yazıyor. Mağaza açılmadan eklenti ayarları anlamlı değildir.
- WooCommerce veya EDD kurulu ve yapılandırılmış olmalı: Para birimi, vergi ve kargo ayarları önceden tanımlanmalı; ödeme adımı bunların üzerine biner.
- SSL sertifikası: Sitede HTTPS aktifse Mağaza Panelindeki protokol seçimi
https://olmalı. Sonradan SSL kurarsanız bu ayarı güncellemeyi unutmayın. - Güncel PHP ve WordPress sürümü: Eklenti yorumlarında eski PHP sürümlerinde kritik hata bildirimleri var; sunucuyu güncel tutmak riski azaltır.
- Yasal sayfalar: Mesafeli satış sözleşmesi, iade/teslimat koşulları ve iletişim bilgileri yayında olmalı.
Somut örnek: SSL’i kurulumun sonunda alan bir mağaza, protokolü http:// bırakırsa bildirimler yanlış adrese gider ve ödeme başarılı olsa da sipariş “Beklemede” kalır. Beş saniyelik bir ayar, günlerce süren “ödeme geliyor sipariş düşmüyor” şikâyetine dönüşür. Bu listeyi kurulumdan önce tek tek işaretlemek, ilk gerçek siparişin sorunsuz düşmesi için en ucuz sigortadır.
Adım 1 — PayTR mağaza başvurusu ve API bilgileri
Başvuru PayTR’ın kendi sitesi üzerinden yapılır. Şirket türü, vergi/kimlik bilgisi, banka hesabı ve IBAN istenir; şahıs şirketi ve esnaf başvuruları da kabul edilir. Onay sonrası kullanacağınız üç değer Mağaza Panelinde Bilgi sayfasındaki API Entegrasyon Bilgileri alanında yer alır. PayTR geliştirici dokümanı bu bilgilere paytr.com/magaza/bilgi adresinden ulaşılabileceğini belirtir.
Bu üç değeri kopyalarken en yaygın hata, başında veya sonunda görünmez boşluk bırakmaktır. Tarayıcıdan çift tıklayarak seçmek yerine alanı manuel olarak baştan sona seçmek, bu hatayı büyük ölçüde önler. Değerleri paylaşımlı bir not uygulamasında da tutmayın; gizli anahtar, sitenizin ödeme imzasını üreten değerdir ve sızması işlem güvenliğini doğrudan etkiler.
PayTR kendi içeriklerinde sanal POS’un hızlı devreye alınabildiğini vurguluyor; “2 saatte Sanal POS’unuzu kullanmaya başlayın” ifadesi ürün tanıtımlarında geçiyor. Yine de pratikte belge kontrolü ve mağaza onayı süreci sizin evrak hazırlığınıza bağlı ilerler; bilgileri eksiksiz yüklemek en hızlı yoldur. Başvuru beklerken WooCommerce tarafındaki vergi, kargo ve para birimi ayarlarını tamamlamak, onay geldiğinde aynı gün canlıya çıkmanızı sağlar.
Adım 2 — WooCommerce eklentisinin kurulumu
PayTR’ın resmî dokümanındaki akış şu sırayı izler: WordPress yönetim paneline girin, Eklentiler → Yeni Ekle adımını takip edin, arama çubuğuna “PayTR” yazın ve sonuçlar içinden PayTR Sanal POS WooCommerce – iFrame API modülünü “Şimdi Kur” ile kurun. Kurulum bitince “Etkinleştir” butonuna basarak modülü aktif edin.
Ardından Eklentiler → Yüklü Eklentiler listesinden aynı modülün Ayarlar bağlantısına tıklayın. Alternatif yol WooCommerce → Ayarlar → Ödemeler sekmesinden PayTR satırındaki “Yönet” butonudur; ikisi de aynı ekrana çıkar. Kurulum öncesinde modülün sürüm bilgisine bakmak da iyi bir alışkanlık: değişiklik günlüğündeki 3.1.2 sürümü 14.05.2026 tarihinde yayınlandı ve aynı sayfada eklentinin son 3 ana WordPress sürümüyle test edilmediğine dair bir uyarı bulunuyor. Bu uyarı “çalışmaz” demek değildir; güncellemeyi önce test ortamında denemenin gerçek bir ihtiyaç olduğunu gösterir.
Eklenti ayar ekranında karşılaşacağınız alanlar ve ne işe yaradıkları resmî dokümanda şöyle tanımlanmış:
| Alan | İşlevi | Pratik öneri |
|---|---|---|
| Aktif / Devre Dışı | Modülü çalışır hâle getirir | Test bitene kadar bakım modunda tutun |
| Başlık | Ödeme yöntemleri listesinde müşterinin gördüğü ad | “Kredi / Banka Kartı” gibi anlaşılır bir metin |
| Açıklama | Yöntemin altındaki açıklama satırı | 3D Secure vurgusu dönüşüme yardım eder |
| Logo | PayTR logosunun gösterilmesi | Güven sinyali olarak açık bırakın |
| Sipariş Durumu | Başarılı ödemede siparişin alacağı durum | Fiziksel üründe “İşleniyor” |
| Vade Farkı | Taksitten doğan vade farkını siparişe yansıtır | Fiyat politikanıza göre karar verin |
| Dil | Ödeme sayfası dili | Çok dilli sitede müşteri diline eşleyin |
| Taksit Ayarları | Maksimum taksit sayısı; kategoriye göre düzenlenebilir | Dijital üründe taksiti kısıtlamak yaygın |
Taksit ayarının kategori bazında düzenlenebilmesi çoğu mağazanın gözden kaçırdığı bir esneklik: düşük kârlı kategorilerde taksiti kapatıp yüksek sepetli kategorilerde açık bırakarak komisyon yükünü dengeleyebilirsiniz. PayTR’ın WooCommerce sanal POS entegrasyonu içeriğinde de eklenti ayarlarının yapılandırılmasının mağaza işleyişi ve müşteri deneyimi için önemli olduğu vurgulanıyor.
Adım 3 — Bildirim URL’sini (Callback) ayarlamak
Bu adım atlandığında ödeme bankadan geçer ama sipariş güncellenmez; “para çekildi sipariş yok” şikâyetlerinin neredeyse tamamı buradan çıkar. PayTR dokümanındaki sıra şöyledir: Mağaza Paneline girin, menüden Ayarlar bağlantısına tıklayın, Bildirim URL Ayarı (Callback URL) bölümündeki Değiştir butonuna basın, açılan bölümde WooCommerce seçeneğini seçin ve kaydedin.
Protokol seçimi ayrı bir satır: sitede SSL varsa https://, yoksa http:// seçilir. Sonradan SSL kurulduğunda bu alanın https:// olarak güncellenmesi gerekir — doküman bunu açıkça hatırlatıyor.
Bildirimin çalıştığını doğrulamanın en hızlı yolu bir test işlemi sonrası sipariş durumunu izlemektir. Sipariş otomatik olarak seçtiğiniz duruma geçtiyse callback çalışıyor. Geçmiyorsa sırayla şunlara bakın: Mağaza Panelinde platform seçimi doğru mu, protokol doğru mu, hosting güvenlik duvarı gelen isteği engelliyor mu, sitede bakım modu veya giriş koruması aktif mi. Bazı barındırma sağlayıcılarının bot koruması, dışarıdan gelen POST isteklerini sessizce düşürebilir; bu durumda sağlayıcıdan PayTR isteklerine izin verilmesini istemek gerekir.
Adım 4 — Test modu ve canlıya geçiş
PayTR dokümanı test aşamasını atlanmaz bir adım olarak tanımlıyor: sepete ürün ekleyip ödeme sayfasına ilerlediğinizde mağazanız canlı değilse test modu ekranını görürsünüz ve canlı moda geçmeden önce 1 veya 2 kere test işlemi yapmanız gerekmektedir. Canlı mağazalarda ise doğrudan canlı mod ekranı gelir.
Test sırasında kontrol edilecekler:
- iFrame ödeme sayfası sepet tutarıyla aynı tutarı gösteriyor mu?
- Başarılı ödemede müşteri doğru “sipariş alındı” sayfasına dönüyor mu?
- Sipariş durumu eklentide seçtiğiniz duruma geçti mi?
- Sipariş e-postaları hem müşteriye hem yöneticiye gitti mi?
- Başarısız/iptal senaryosunda kullanıcı anlamlı bir mesajla dönüyor mu?
Doküman ayrıca sipariş tarafında bırakılan izleri anlatıyor: modülle alınan siparişlerin Özel Alanlar bölümüne paytr_order_id parametresi eklenir ve bu değer PayTR Mağaza Paneli → Satışlar içindeki sipariş numarasıyla aynıdır; veriyi yalnızca yönetici görebilir. Muhasebe mutabakatında iki tarafı eşleştirmenin en kısa yolu bu alandır. Sipariş notlarına da ödeme durumuna göre kayıt düşüldüğü için, bir işlem tartışmalı hâle geldiğinde ilk bakılacak yer sipariş detay ekranıdır.
iFrame mi, Direkt API mi? Karar tablosu
Bu soru arama sonuçlarındaki hemen her kaynakta geçiyor, çünkü seçim hem kurulum yükünü hem uyum sorumluluğunu değiştirir. PayTR geliştirici merkezinde iFrame API, Link API ve Direkt API için ayrı entegrasyon başlıkları ve ayrı canlı moda geçiş süreçleri tanımlanmış durumda.
| Kriter | iFrame API | Direkt API | Link ile Ödeme |
|---|---|---|---|
| Kart bilgisi nerede girilir | PayTR’ın gömülü çerçevesinde | Sitenizdeki kendi ödeme formunuzda | PayTR’ın ödeme linkinde |
| Teknik hazırlık yükü | Düşük — hazır WordPress modülü | Yüksek — kod düzeyinde entegrasyon ister | Çok düşük |
| Site içinde kalma | Evet | Evet, tam kontrol | Hayır |
| Kart saklama / tekrarlayan ödeme | Standart akış | Kart saklama API’si mevcut | Uygun değil |
| Tipik kullanım | WooCommerce ve EDD mağazaları | Kendi ekibinizin kurguladığı ileri düzey ödeme akışları | Web sitesi olmayan satış |
Pratik sonuç: standart bir WooCommerce mağazası için iFrame API doğru başlangıçtır — resmî modül zaten bu yöntemi kullanır. Direkt API’ye ancak kayıtlı karttan ödeme, BIN sorgulama, taksit oranı sorgulama gibi akışları kendi arayüzünüzde kurgulamanız gerekiyorsa geçmek mantıklıdır; PayTR geliştirici merkezinde bu servisler ayrı başlıklar hâlinde belgelenmiştir. Link ile ödeme ise sosyal medyadan satış yapan, henüz mağazası olmayan işletmeler için ara çözümdür.
PayTR’ın WordPress mağazasında kullanılabilen ödeme yöntemleri
PayTR’ın ürün ailesi tek bir sanal POS’tan geniştir ve bunların bir kısmı WordPress mağazanızın akışına doğrudan bağlanır, bir kısmı ise mağaza dışındaki satış kanallarınız için işe yarar. Kurulum kararını verirken hangi yöntemi gerçekten kullanacağınızı önceden netleştirmek, ayar ekranında gereksiz denemeyi önler.
- Sanal POS (iFrame): Müşteri siteyi terk etmeden kart bilgisini gömülü ödeme çerçevesinde girer; WooCommerce modülünün kullandığı yöntem budur.
- Linkle Ödeme: Web sitesi olmadan da ödeme almayı sağlar; WhatsApp veya e-posta ile gönderilen link üzerinden tahsilat yapılır.
- Havale / EFT: Banka transferiyle gelen ödemelerin takibini kolaylaştıran ayrı bir akış olarak sunulur.
- Abonelik Yönetimi: Düzenli, tekrarlayan ödemelerin yönetimi için tasarlanmış çözümdür.
- Ön Provizyon: Tutarın bloke edilip sonradan tahsil edildiği akış; stok veya onay süreci olan satışlarda kullanılır.
- Pazaryeri Çözümü: Alt satıcılarla aranızdaki nakit akışını yönetmeye odaklı yapıdır.
- Mobil operatörle ödeme ve dijital cüzdan: Alternatif tahsilat kanalı arayan işletmeler için ek seçeneklerdir.
Eklenti sayfasındaki tanıma göre ödeme sayfası sitenizin tasarımına göre özelleştirilebiliyor ve mobil uyumlu çalışıyor. Pratik sonuç: mobil trafiğin ağırlıklı olduğu bir mağazada ödeme adımını mutlaka telefondan test edin — masaüstünde sorunsuz görünen bir sepet düzeni, dar ekranda iFrame’i sıkıştırıp terk oranını yükseltebilir.
EDD (Easy Digital Downloads) ile PayTR kullanmak
Dijital ürün satıyorsanız — tema, eklenti, e-kitap, kurs — sepet ve teslim akışı fiziksel üründen farklıdır: kargo yoktur, teslim indirme bağlantısı veya lisans anahtarıyla yapılır. Bu yüzden EDD tarafında ödeme onayının anında ve doğru işlenmesi daha kritiktir; bildirim gecikirse müşteri ödediği dosyayı göremez.
EDD kurulumunda mantık WooCommerce ile aynıdır: mağaza bilgileri (Mağaza No, Parola, Gizli Anahtar) ödeme sistemi ayarlarına girilir, test modu açılarak deneme satın alımı yapılır ve sipariş “Tamamlandı” durumuna geçince canlı moda geçilir. Bildirim URL’si tarafında platform seçiminin sitenizin kullandığı altyapıya uygun ayarlanması gerekir; yanlış platform seçimi bildirimin karşılıksız kalmasına yol açar.
Site24’ün WooCommerce e-ticaret teması ürün sayfasında belirtildiği gibi tema paketi PayTR ve iyzico uyumluluğuyla gelir; ödeme sayfası, sepet ve hesabım şablonları bu senaryolar düşünülerek hazırlanmıştır. Dijital ürün satan mağazalarda ayrıca lisans veya indirme e-postalarının ödeme onayına bağlı tetiklendiğini test etmek şarttır — tek bir test satın alımı bu zinciri baştan sona doğrular. Test satın alımını gerçek bir müşteri gibi yapmak, yani ödeme sonrası e-postayı da açıp indirme linkine tıklamak, en güvenilir doğrulama yöntemidir.
Pazaryeri modelinde ödeme akışı ve komisyon
Tek satıcılı mağazada para tek bir hesaba akar; pazaryerinde ise aynı sepette birden fazla satıcının ürünü olabilir ve tahsil edilen tutarın bir kısmı komisyon olarak platformda, kalanı satıcıda kalmalıdır. Bu nedenle pazaryeri kurulumunda ödeme entegrasyonu yalnızca “kart çekmek” değil, aynı zamanda bölüşüm ve mutabakat işidir.
PayTR tarafında bu ihtiyaç için ayrı bir pazaryeri çözümü ve platform transfer talebi başlığı bulunuyor; geliştirici dokümanında transfer talimatının verilmesi, sonucunun alınması ve geri dönen ödemelerin listelenmesi ayrı servisler olarak belgelenmiş. Yani satıcıya yapılacak aktarımın kaydı sistem tarafında izlenebilir durumdadır.
Tema tarafında ise satıcı paneli, ürün onayı ve komisyon yönetiminin hazır gelmesi işi kısaltır. Site24’ün WordPress pazaryeri teması ürün sayfasında belirtildiği üzere paket Dokan uyumlu satıcı paneli, ürün onay süreci ve komisyon yönetimiyle sunulur; ödeme tarafında PayTR ve iyzico odaklı bir deneyim hedeflenir. Somut senaryo: 20 satıcılı bir pazaryerinde komisyon oranını sabit tutup ödeme bölüşümünü sistematik izlemezseniz, ay sonunda hangi satıcıya ne kadar borçlu olduğunuzu elle hesaplamak zorunda kalırsınız — bu da büyümenin en sık takıldığı operasyonel duvardır.
Taksit, vade farkı ve komisyon: fiyatlandırmaya etkisi
Türkiye’de sepet terkinin önemli bir bölümü taksit seçeneğinin olmamasından kaynaklanır. PayTR modülünde taksit yönetimi iki yerden kontrol edilir: eklentideki Taksit Ayarları ile maksimum taksit sayısı ve kategori bazlı düzenleme, Vade Farkı seçeneğiyle de taksitten doğan farkın siparişe yansıtılıp yansıtılmayacağı.
Komisyon oranları kart türü, taksit sayısı ve işlem hacmine göre değiştiği için bu yazıda rakam vermiyoruz — güncel oranları PayTR’ın kendi tarife sayfasından doğrulamanız gerekir. Ancak karar mekaniği sabittir: taksitli işlemin maliyeti tek çekimden yüksektir ve bu farkı ya fiyata gömerek ya da vade farkı olarak alıcıya yansıtarak karşılarsınız. İkisinin ortası olan yaygın uygulama, belirli bir sepet tutarının üzerinde taksiti “farksız” sunmaktır.
Somut örnek: ortalama sepeti düşük, kâr marjı ince bir aksesuar mağazasında 12 taksidi açık bırakmak brüt kârı eritir. Aynı mağaza yüksek fiyatlı kategoride 6 taksidi farksız sunarak dönüşümü artırabilir. Karar, kategori bazlı taksit ayarıyla teknik olarak uygulanabilir durumdadır; yani “taksit açık mı kapalı mı” ikilisi yerine kategori kategori bir taksit politikası kurmak mümkündür.
Güvenlik ve bakım: kurulumdan sonra yapılacaklar
Ödeme entegrasyonu “kur ve unut” işi değildir. PayTR’ın WordPress sanal POS kurulumu içeriğinde PCI DSS 4.0 ayrı bir başlık olarak ele alınıyor; yani kart verisi güvenliği standardı entegrasyonun ayrılmaz parçası olarak konumlanıyor. iFrame yöntemi kart verisini sizin tarafınızdan geçirmediği için bu yükün büyük kısmını devreder, ama sitenizin kendi güvenliği hâlâ sizin sorumluluğunuzdadır.
- SSL’i sürekli açık tutun: Sertifika süresi dolarsa ödeme sayfası çalışmaz. Otomatik yenilenen sertifika kullanın ve yenilenmeyi izleyin.
- Gizli anahtarı paylaşmayın: Destek talebi açarken ekran görüntüsünde API bilgilerini maskeleyin.
- Eklenti güncellemelerini takip edin: Eklentinin değişiklik günlüğünde hata günlükleri sayfası gibi bakım güncellemeleri yayınlanıyor; güncellemeyi önce staging ortamında deneyin.
- Test modunu kapatmayı unutmayın: Canlıya geçtikten sonra ilk gerçek siparişi kendiniz vererek doğrulayın.
- Yedek alın: Ödeme eklentisi güncellemeden önce veritabanı ve dosya yedeği alın.
- Sunucu ortamını güncel tutun: PHP ve WordPress sürümünüz eskidikçe uyumsuzluk riski artar.
Bir de operasyonel not: eklentinin WordPress.org sayfasındaki kullanıcı yorumlarında PHP sürüm uyumsuzluğu ve banka yönlendirme hataları bildirilmiş. Bu tür bildirimler eklentinin kullanılamaz olduğunu göstermez; gösterdiği şey sunucu ortamınızı güncel tutmanın ve güncellemeyi önce test ortamında denemenin gerçek bir ihtiyaç olduğudur.
Sık karşılaşılan hatalar ve çözümleri
Aşağıdaki tablo, kurulum sonrası en çok karşılaşılan durumları belirti → olası neden → kontrol edilecek yer mantığıyla özetliyor.
| Belirti | Olası neden | Ne yapılmalı |
|---|---|---|
| Ödeme sayfası (iFrame) açılmıyor | SSL/protokol uyumsuzluğu veya tema-eklenti çakışması | HTTPS’i doğrulayın, Mağaza Panelindeki protokolü kontrol edin, tarayıcı konsolundaki hatayı okuyun |
| Mağaza bilgileri hatalı uyarısı | Kopyalamada boşluk veya yanlış alan | Mağaza No, Parola ve Gizli Anahtarı Bilgi sayfasından yeniden alın |
| Ödeme başarılı, sipariş “Beklemede” | Bildirim URL’si ayarlanmamış veya engellenmiş | Mağaza Paneli → Ayarlar → Bildirim URL’de WooCommerce seçimini ve protokolü doğrulayın |
| Test modu ekranı canlıda çıkıyor | Mağaza canlıya alınmamış veya eklentide test açık | Mağaza durumunu ve eklenti test ayarını kontrol edin |
| Taksit seçenekleri görünmüyor | Taksit ayarı kapalı veya kategori kısıtlı | Eklentideki Taksit Ayarları ve kategori tanımlarını gözden geçirin |
| Belirli banka kartında hata | Kart/banka özel yönlendirme sorunu | İşlem numarasıyla PayTR destek kaydı açın, hata kodunu paylaşın |
Sorun giderirken en verimli yaklaşım tek değişken kuralıdır: aynı anda birden fazla ayarı değiştirmeyin. Bir ayarı değiştirin, test işlemi yapın, sonucu not edin. Böylece hangi ayarın sorunu çözdüğünü gerçekten bilirsiniz. PayTR geliştirici merkezinde hata kodları ayrı bir başlık altında listelendiği için, destek kaydı açarken işlem numarasıyla birlikte hata kodunu iletmek çözüm süresini kısaltır.
Tema seçimi, resmî modül ve ileri düzey entegrasyon ihtiyacı
Ödeme eklentisi çalışsa bile sepet ve ödeme sayfasının düzeni dönüşümü belirler. Ağır kurucu eklentilerle üretilmiş checkout sayfaları, mobilde iFrame’in dar alana sıkışmasına ve kullanıcı kaybına yol açabilir. Bu nedenle PayTR ile birlikte kullanılacak temanın sepet/ödeme şablonlarının hafif ve test edilmiş olması önemlidir. Site24 tema koleksiyonunda e-ticaret ve pazaryeri paketleri PayTR ve iyzico uyumluluğu düşünülerek hazırlanır; paketler indirilebilir tema dosyası, dokümantasyon, güncelleme erişimi ve Türkçe destek paneli erişimiyle sunulur. Proje türünüze göre seçim yapmak için WordPress tema kategorisini inceleyebilirsiniz.
Resmî modül tarafında dürüst cevap şu: PayTR’ın WooCommerce modülü WordPress.org üzerinden ücretsiz dağıtılıyor ve çoğu mağaza için fazlasıyla yeterlidir. Kurulum panel içinden yapılır, ayarlar tek ekrandadır, bildirim akışı hazır gelir. Standart bir mağaza kuruyorsanız resmî modülün dışına çıkmanız için bir sebep yoktur — ücretsiz olması bir eksiklik değil, PayTR’ın entegrasyonu yaygınlaştırma tercihidir.
İleri düzey API entegrasyonu yalnızca şu durumlarda gündeme gelir: kayıtlı karttan tekrarlayan tahsilat, ön provizyon akışı, pazaryerinde satıcılara aktarım talimatının otomatikleştirilmesi, muhasebe sistemine anlık aktarım veya kendi arayüzünüzde BIN ve taksit oranı sorgulama. PayTR geliştirici merkezi bu servisleri ayrı başlıklarla belgeliyor; yani ihtiyaç varsa yol açıktır. Karar için basit bir eşik: resmî modülün ayar ekranındaki alanlarla iş akışınızı kurabiliyorsanız devam edin. Kuramadığınız ilk noktada, yalnızca o ihtiyacı tanımlayıp onun için çalışmak, tüm entegrasyonu sıfırdan kurmaktan hem daha hızlı hem daha güvenlidir.
Kurulum sonrası mağaza içi deneyimi güçlendirmek isterseniz — Ajax arama, gelişmiş ürün filtreleme, marka yönetimi gibi — Essentials24 eklentisi bu işlevleri tek pakette sunar. Ödeme altyapısı trafiği paraya çevirir; arama ve filtreleme ise ziyaretçinin doğru ürünü bulmasını sağlar. İkisi birlikte çalıştığında sepet oluşma oranı yükselir.
Sık Sorulan Sorular
PayTR entegrasyonu nasıl yapılır?
Üç adımda yapılır: WordPress panelinden “PayTR Sanal POS WooCommerce – iFrame API” eklentisini kurup etkinleştirin, eklenti ayarlarına Mağaza Panelindeki Mağaza No, Mağaza Parola ve Mağaza Gizli Anahtar bilgilerini girin, ardından PayTR Mağaza Paneli → Ayarlar → Bildirim URL Ayarı bölümünde platformu WooCommerce olarak seçip protokolü sitenizin durumuna göre https:// veya http:// yapın. Canlı moda geçmeden önce 1 veya 2 kere test işlemi yapılması resmî dokümanda zorunlu adım olarak belirtilir.
PayTR yüzde kaç komisyon alıyor?
Komisyon oranı kart türü, taksit sayısı ve işlem hacmine göre değişir; sabit tek bir oran yoktur. Bu nedenle güncel oranı PayTR’ın kendi tarife sayfasından doğrulamanız gerekir. Eklenti sayfasında belirtildiği üzere PayTR’da aidat ücreti bulunmaz ve üye işyerleri “Ertesi İş Günü” ödeme avantajından faydalanır.
WordPress kurulumu nasıl yapılır?
WordPress, çoğu hosting panelinde tek tıkla kurulur; alternatif olarak wordpress.org’dan indirilen dosyalar sunucuya yüklenip veritabanı bilgileriyle kurulum sihirbazı tamamlanır. Kurulumdan sonra kalıcı bağlantı ayarı, SSL ve tema yüklemesi yapılır. Tema yüklemesi yönetici panelinde Görünüm → Temalar → Yeni Tema Ekle → Tema Yükle yolundan zip dosyası yüklenerek gerçekleştirilir.
WordPress WooCommerce nedir?
WooCommerce, WordPress’in açık kaynak kodlu e-ticaret eklentisidir; siteye ürün kataloğu, sepet, ödeme ve sipariş yönetimi ekler. PayTR gibi sanal POS eklentileri WooCommerce’in ödeme yöntemleri katmanına bağlanarak çalışır. Dijital ürün satan mağazalarda WooCommerce yerine Easy Digital Downloads da kullanılabilir.
PayTR WooCommerce olmadan çalışır mı?
Evet. PayTR’ın Link ile Ödeme çözümü web sitesi olmadan da ödeme almaya olanak tanır; müşteriye gönderilen ödeme linki üzerinden tahsilat yapılır. Ancak WordPress mağazanızda sepet, sipariş ve otomatik teslim akışı istiyorsanız WooCommerce ya da Easy Digital Downloads kullanmak en pratik yoldur.
Ödeme başarılı ama sipariş neden “Beklemede” kalıyor?
Neredeyse her zaman bildirim (callback) URL ayarı kaynaklıdır. PayTR Mağaza Paneli → Ayarlar → Bildirim URL Ayarı bölümünde platform seçiminin WooCommerce olduğunu ve protokolün sitenizle uyumlu olduğunu doğrulayın. Ayar doğruysa hosting güvenlik duvarının PayTR’dan gelen bildirim isteklerini engelleyip engellemediğini kontrol edin.
