WooCommerce Sanal POS Entegrasyonu Sorunları ve 2026 Çözüm Rehberi
Siteniz harika görünüyor. Ürünler yüklü, SSL sertifikanız yeşil yanıyor ve reklam bütçeniz eriyor. Ancak müşteri ödeme adımına geldiğinde o meşhur “Ödeme işlemi gerçekleştirilemedi” uyarısıyla baş başa kalıyor. Sorun bankanızda değil. Sorun genellikle kodun derinliklerinde veya gözden kaçırdığınız küçük bir sunucu yapılandırmasında gizli.
E-ticaretin en kritik saniyesi ödeme anıdır. Bu anı kaybettiğinizde sadece bir satışı değil, müşterinin güvenini de kaybedersiniz. Bugüne kadar yüzlerce e-ticaret altyapısı kurduk, en çok takıldığımız nokta hep burası oldu. Entegrasyon süreçleri kağıt üzerinde basit görünse de, işin içine callback URL’ler, 3D Secure yönlendirmeleri ve PHP güvenlik duvarları girdiğinde işler karışıyor. Bu rehberde, WooCommerce sitenizdeki sanal POS hatalarını ayıklamanın ve ödeme akışını stabilize etmenin yollarını saha notlarımızla inceleyeceğiz.
WooCommerce Ödeme Hatalarının Temel Sebebi Nedir?
WooCommerce sanal pos hataları çoğunlukla API kimlik bilgilerinin yanlış girilmesi, SSL sertifikasındaki uyumsuzluklar veya hosting tarafındaki allow_url_fopen gibi kısıtlamalardan kaynaklanır. Ödeme aracı kurumları (iyzico, PayTR, Lidio vb.) sitenizle sürekli bir veri alışverişi içindedir. Eğer bu döngüde bir kesinti olursa işlem başarısız sayılır.
İşlem başarısız olduğunda ilk bakmanız gereken yer WooCommerce > Durum > Günlükler sekmesidir. Burada “fatal-errors” veya kullandığınız ödeme yönteminin özel loglarını bulmalısınız. Hata kayıtları yalan söylemez. Çoğu geliştirici paneli kontrol etmek yerine bankayı arayarak vakit kaybeder. Oysa hata kodu orada, bir json verisinin içinde sizi bekliyor.
API Anahtarı ve Secret Key Uyuşmazlığı
Sanal POS panelinden aldığınız API anahtarlarını kopyalarken bazen görünmez bir boşluk bırakıyorsunuz. Bu boşluk tüm entegrasyonu geçersiz kılar. “Invalid Signature” veya “Yetkisiz Erişim” hatalarının %90’ı manuel kopyalama hatalarıdır.
Ayarları yapmak için:
- WordPress panelinden WooCommerce > Ayarlar > Ödemeler yolunu izleyin-
- İlgili ödeme yönteminin yanındaki “Yönet” butonuna tıklayın-
- API anahtarlarını silip tekrar yapıştırın ve başında/sonunda boşluk olmadığından emin olun-
- Test modu (Sandbox) açıksa, canlı anahtarların çalışmayacağını unutmayın-
Callback URL ve Webhook Sorunları
Ödeme başarılı olduktan sonra banka sitenize “Hey, bu para ödendi, siparişi onayla” mesajı gönderir. Bu mesajın ulaştığı adrese Callback URL denir. Eğer sitenizde bir güvenlik eklentisi (Wordfence vb.) bu isteği bot saldırısı sanıp engelliyorsa, para çekilir ama sipariş “Ödeme Bekliyor” durumunda kalır.
Bu durumu çözmek için firewall ayarlarınızda ödeme kuruluşunun IP adreslerine beyaz liste (whitelist) tanımlamalısınız. Sunucu tarafında mod_security açıksa, bu bazen dışarıdan gelen POST isteklerini bloklar. Müşteri ödemeyi yapar, banka sayfasına gider, döner ama site hiçbir şey olmamış gibi davranır. Sinir bozucudur. Ama çözümü basittir.
PHP Limitleri ve Curl Hataları
Sanal POS entegrasyonları PHP’nin cURL kütüphanesini kullanır. Eğer sunucunuzda cURL güncel değilse veya PHP bellek limiti (memory_limit) 256MB altındaysa, karmaşık ödeme sorguları yarıda kesilebilir.
Sunucu yapılandırmanızı şu seviyelere çekin:
max_execution_time: 300-memory_limit: 512M-post_max_size: 64M-upload_max_filesize: 64M-
Düşük limitler demek, yoğun trafikte ödeme modülünün “timeout” hatası vermesi demektir. Sunucunuz nefes alamıyorsa, ödeme alamazsınız. Hosting firmanıza bu değerleri yükseltmesi için baskı yapın veya kendiniz php.ini ve .htaccess dosyasından müdahale edin.
3D Secure ve Yönlendirme Döngüleri
Bazı temalar sepet sayfasını “AJAX” ile yeniler. Müşteri “Ödeme Yap” dediğinde sayfa yenilenmediği için 3D Secure ekranı açılmaz. Sadece bir yükleme ikonu döner durur. Sabır testidir.
Tema ayarlarınızda “Checkout” sayfasında AJAX kullanımını devre dışı bırakmayı deneyin. Özellikle Elementor veya benzeri sayfa yapıcılarla özel ödeme sayfaları tasarladıysanız, standart WooCommerce form yapısını bozmuş olabilirsiniz. Standart [woocommerce_checkout] kısa kodunu kullanmak her zaman en güvenli limandır. Fanteziye gerek yok.
SSL Sertifikası ve TLS Versiyonu
Bankalar artık TLS 1.0 ve 1.1 protokollerini desteklemiyor. Eğer siteniz eski bir sunucudaysa ve TLS 1.2 veya 1.3 desteği yoksa, banka sunucusuyla “el sıkışamazsınız”. Bu da doğrudan bağlantı hatasına yol açar.
SSL sertifikanızın sadece var olması yetmez, aynı zamanda zincirleme sertifikalarının (CA Bundle) doğru kurulmuş olması gerekir. “Sertifika geçersiz” hatası alıyorsanız, WhyNoPadlock gibi araçlarla sertifika kurulumunuzu test edin. Yeşil kilit her şeyin yolunda olduğu anlamına gelmez. Arka planda kırık linkler kalmış olabilir.
Eklenti Çakışmaları: Gizli Suçlular
Bazen yüklediğiniz bir kargo eklentisi veya “fiyat yuvarlama” aracı, ödeme modülünün gönderdiği veri yapısını bozar. Sepet toplamı ile POS’a gönderilen tutar arasında 0.01 kuruşluk bir fark bile olsa, banka işlemi reddeder.
Hata ayıklama adımları:
- Sadece WooCommerce ve Sanal POS eklentisini aktif bırakın-
- Varsayılan bir WordPress temasına (Storefront gibi) geçin-
- Sorun düzelirse, suçluyu bulmak için diğer eklentileri tek tek açın-
- Genellikle “Checkout Field Editor” tarzı eklentiler zorunlu alanları sildiği için bu hatalara neden olur-
Veritabanı Tablo Sorunları
WooCommerce ödeme sırasında veritabanına geçici kayıtlar atar. Eğer wp_options veya wp_woocommerce_order_items tablolarınız “overhead” yapmışsa veya bozulmuşsa, sipariş numarası oluşturulamaz. Sipariş numarası oluşmayan bir işlemi banka onaylamaz.
phpMyAdmin üzerinden tüm tabloları seçip “Optimize table” demeniz bazen mucizeler yaratır. Veritabanı bakımı yapmak lüks değil, zorunluluktur. Şişmiş bir veritabanı, ağır bir ödeme sayfası demektir. Müşteri beklemeyi sevmez.
Sıkça Sorulan Sorular (SSS)
WooCommerce ödeme ekranında ‘Geçersiz Ödeme Yöntemi’ hatası neden olur?
Bu hata genellikle ödeme yönteminin ayarlarında bir eksiklik olduğunda veya WooCommerce’in o ödeme yöntemini o anki para birimiyle eşleştirememesi durumunda ortaya çıkar. Ayarlar sekmesinden yöntemin aktifliğini ve desteklenen para birimlerini kontrol ederek, gerekirse API anahtarlarını tazeleyerek sorunu giderebilirsiniz.
Ödeme başarılı ancak sipariş ‘Ödeme Bekliyor’ olarak kalıyor, ne yapmalıyım?
Siparişin onaylanmaması, bankadan gelen dönüş sinyalinin (IPN/Callback) sitenize ulaşamadığını gösterir. Hosting tarafındaki güvenlik duvarınızın veya Wordfence benzeri eklentilerin banka IP adreslerini engellemediğinden emin olun. Ayrıca sitenizin kalıcı bağlantı ayarlarını (Permalinks) ‘Yazı İsmi’ olarak güncelleyip kaydederek yönlendirme hatalarını çözebilirsiniz.
Sanal POS kurulumundan sonra sepet sayfası neden çok yavaş açılıyor?
Sepet sayfasındaki yavaşlık genellikle dış sunucularla yapılan hatalı API sorgularından veya PHP bellek limitinin yetersizliğinden kaynaklanır. Sunucu tarafında PHP memory_limit değerini 512MB seviyesine çıkarmanız ve cURL kütüphanesinin güncelliğini kontrol etmeniz gerekir. Veritabanındaki eski sessions kayıtlarını temizlemek de sayfa yüklenme hızını doğrudan artıracaktır.
Sonuç
Sanal POS entegrasyonu bir kez kurulup unutulacak bir sistem değildir. WordPress güncellemeleri, PHP sürüm değişiklikleri veya bankaların API güncellemeleri her an işleyişi bozabilir. Bu rehberdeki adımları uyguladıktan sonra sitenizde mucizevi bir değişim olmayacak; ancak ödeme hatalarınızın %95 oranında azaldığını ve sepetten kaçan müşteri sayısının stabilize olduğunu göreceksiniz.
Kim uğraşmalı? Profesyonel bir e-ticaret deneyimi sunmak isteyen ve “Yarın ödeme alabilecek miyim?” korkusu yaşamak istemeyen her site sahibi. Teknik kurulumlar sabır ister, ancak karşılığını kesintisiz bir nakit akışı olarak verir.
İçeriği Paylaş
