WooCommerce 3D Secure Ödeme Hatası Nasıl Bulunur?
WooCommerce 3D Secure ödeme hatalarında sipariş notu, banka cevabı, callback, log ve eklenti çakışmasını doğru sırayla inceleme rehberi.
3D Secure ödeme sorunu tek bir hata değildir. Müşteri doğrulamayı tamamlamış olabilir; banka işlemi reddetmiş olabilir veya banka başarılı cevap verdiği hâlde WooCommerce siparişi güncelleyememiş olabilir. Bu nedenle ilk iş rastgele ayar değiştirmek değil, işlemin hangi adımda koptuğunu kanıtlamaktır.
Önce üç farklı hata türünü ayırın
- Bankada işlem yok: istek bankaya ulaşmamış, bilgiler yanlış veya yönlendirme başlamamış olabilir.
- Bankada başarısız: banka hata kodu, 3D doğrulama sonucu, kart kuralı veya üye işyeri yetkisi incelenir.
- Bankada başarılı, mağazada beklemede: dönüş bildirimi, imza kontrolü ya da sipariş durumu güncellemesi araştırılır.
“Ödeme alınamadı” ekranı bu üç durumun hangisi olduğunu söylemez. Aynı saate ait banka hareketi bulunmadan eklentiyi değiştirmek, asıl nedeni gizleyebilir.
Sipariş notu ve log nasıl okunur?
WooCommerce sipariş notlarında ödeme yönteminin eklediği durum değişiklikleri ve hata kodları görülebilir. Ayrıntılı kayıt gerekiyorsa ödeme eklentisinin güvenli loglaması kısa süreli açılır. Logda sipariş numarası, işlem kimliği, gönderim zamanı, callback zamanı ve maskelenmiş banka cevabı aranır.
Callback ve imza doğrulaması neden kritik?
3D doğrulama sonrasında banka veya ödeme kuruluşu sonucu belirlenen adrese iletir. Yanlış alan adı, HTTP/HTTPS farkı, güvenlik duvarı, bakım modu veya hatalı yönlendirme bu çağrıyı engelleyebilir. Bildirim ulaştığı hâlde hash ya da imza hesabında alan sırası, karakter kodlaması veya test/canlı anahtar karışıklığı varsa sipariş güvenli biçimde reddedilir.
Çakışma testi nasıl yapılmalı?
- Canlı sitenin yedeğinden staging ortamı oluşturun.
- Aynı PHP, WordPress, WooCommerce ve ödeme eklentisi sürümlerini kaydedin.
- Varsayılan tema ve yalnızca zorunlu eklentilerle test edin.
- Önbellek, güvenlik ve checkout özelleştirmelerini birer birer geri açın.
- Klasik ödeme sayfası ve Checkout Block kullanılıyorsa ikisini ayrı test edin.
- Başarılı, reddedilen, iptal edilen ve zaman aşımına uğrayan işlemlerde sipariş durumunu doğrulayın.
Destek talebinde hangi bilgiler bulunmalı?
Sipariş numarası, deneme zamanı, ödeme yöntemi, WooCommerce durum raporu, banka işlem kimliği ve maskelenmiş hata çıktısı birlikte verilmelidir. “Çalışmıyor” mesajı yerine bu paket gönderildiğinde banka, yazılım ve sunucu tarafı daha hızlı ayrılır. RentonDiji'nin WooCommerce sanal POS entegrasyonu ve özel eklenti geliştirme sayfaları uygulanabilir kapsamı açıklar.
3D Secure hatasını aşama ve referansla teşhis edin
Sipariş, tarayıcı dönüşü ve sağlayıcı callback kaydı aynı zaman çizelgesinde incelenmelidir.
Ödeme entegrasyonunda tarayıcıdaki başarı sayfası tek başına tahsilat kanıtı değildir. Sağlayıcı destekliyorsa sunucudan gelen imzalı callback/webhook doğrulanmalı, tutar ve sipariş kimliği eşleştirilmeli ve aynı bildirim tekrar geldiğinde işlem ikinci kez uygulanmamalıdır. Gizli anahtarlar istemci koduna veya herkese açık loglara yazılmamalıdır.
Test planı başarılı ödeme, doğrulama reddi, kullanıcı iptali, zaman aşımı, bağlantı kesintisi, çift bildirim, kuruşlu tutar, tam/kısmi iade ve manuel mutabakatı kapsar. WooCommerce sipariş notunda sağlayıcı işlem referansı bulunmalı; ancak kart, parola veya gereksiz kişisel veri yer almamalıdır.
Fiyat karşılaştırmasında komisyon dışında sabit ücret, taksit, yabancı kart, valör, erken ödeme, iade, ters ibraz, teknik destek ve bakım dikkate alınır. Hazır eklenti ile özel geliştirme aynı kapsam değildir. Checkout tipi, WooCommerce/PHP sürümü, iade desteği ve güncelleme sorumluluğu lisans satın alınmadan önce doğrulanmalıdır.
- Test ve canlı anahtarlarının ayrılması
- İmzalı bildirim ve tekil işlem
- Hata, iptal ve zaman aşımı senaryoları
- Tam/kısmi iade ile mutabakat
- Eklenti lisansı, sürüm ve bakım kapsamı
Sıkça sorulan sorular
Ödeme bankada başarılı, WooCommerce'te neden beklemede kalır?
Çoğunlukla callback veya sipariş durumu güncellemesi incelenir; kesin neden banka ve mağaza kayıtları eşleştirilmeden söylenemez.
Canlı sitede eklentileri kapatarak test yapılır mı?
Ödeme akışı staging ortamında ve kontrollü test verisiyle denenmelidir.
Loglarda kart bilgisi tutulmalı mı?
Hayır; hassas kart verileri hiçbir uygulama loguna yazılmamalıdır.
Teknik kaynaklar
3D Secure hatasını işlem zaman çizelgesiyle teşhis etme
Kullanıcının bankadan dönmesi, tarayıcı yönlendirmesi ve sunucu bildirimi farklı anlarda gerçekleşebilir. Teşhis için sipariş, sağlayıcı referansı, saat ve durum kodu eşleştirilir; hassas kart verisi hiçbir loga yazılmaz.
Ödeme akışında tarayıcıdaki başarı ekranı tahsilatın tek kanıtı değildir. Sağlayıcı cevabı, imzalı bildirim, tutar, sipariş kimliği, iade ve mutabakat aynı işlem referansı üzerinden izlenmelidir.
Bu konudaki kararı yalnız fiyat veya özellik listesi üzerinden vermek yerine aşağıdaki kontrolleri bir kabul dosyasına dönüştürün. Her satıra mevcut durum, sorumlu, kanıt ve karar tarihi ekleyin. Böylece Aşama ile Referans gibi birbirine bağlı başlıklar görüşme sırasında kaybolmaz; teklif veren ekipler de aynı kapsam üzerinden karşılaştırılır.
Karar ve doğrulama tablosu
| Kontrol alanı | Karar sorusu | Kabul kanıtı |
|---|---|---|
| Aşama | hata doğrulama öncesi mi callback sonrasında mı? | Belge, ekran görüntüsü, test sonucu veya sorumlu kaydıyla doğrulayın. |
| Referans | mağaza ve sağlayıcı aynı sipariş kimliğini taşıyor mu? | Belge, ekran görüntüsü, test sonucu veya sorumlu kaydıyla doğrulayın. |
| İmza | callback doğrulaması doğru anahtar ve algoritmayı mı kullanıyor? | Belge, ekran görüntüsü, test sonucu veya sorumlu kaydıyla doğrulayın. |
| Tekrarlama | aynı bildirim güvenle yeniden işlenebiliyor mu? | Belge, ekran görüntüsü, test sonucu veya sorumlu kaydıyla doğrulayın. |
Uygulamaya geçiş ve ölçüm sırası
Önce başlangıç verisini kaydedin; sonra tek sorumlu ve geri dönüş adımı bulunan küçük bir değişiklik yapın. Aynı anda çok sayıda unsur değişirse hangi müdahalenin sonuç verdiği anlaşılamaz. Canlıya geçiş kararını yalnız “çalışıyor” kontrolüyle değil hata, istisna, mobil kullanım ve gerçek operasyon senaryolarıyla verin.
- Test ve canlı kimlik bilgilerini ayrı, erişimi sınırlı ortamlarda tutun.
- Başarılı, reddedilen, iptal, zaman aşımı ve çift bildirim senaryolarını deneyin.
- Sipariş durumu ile sağlayıcı işlem kaydını günlük mutabakata bağlayın.
- Sürüm güncellemelerinde kritik ödeme testlerini yeniden çalıştırın.
İlk 30 günde izlenecek göstergeler
- Hata kodu dağılımı
- Beklemede kalan ödeme
- Callback gecikmesi
- Tekrar denemede başarı
Göstergeyi yorumlarken yalnız toplam adede bakmayın. Kaynak, cihaz, sayfa veya işlem türü kırılımı sorunun nerede oluştuğunu gösterir. Sonucu başlangıç dönemiyle karşılaştırın; mevsimsellik, kampanya ve ekip kapasitesi gibi eş zamanlı etkileri değişiklik günlüğüne ekleyin. Bir gösterge kötüleşirse önce veri doğruluğunu, ardından kullanıcı akışını ve teknik kayıtları kontrol edin.
Bu rehberi kendi sisteminize uyarlayın
Mevcut altyapınızı, hedefinizi ve kritik bağımlılıkları 60 saniyelik brifle paylaşın; ilk görüşmeden önce doğru teknik ve ticari soruları netleştirelim.
Ücretsiz ödeme entegrasyonu analizi alınİlgili çözümler
Bu konuyu işletmeniz için uygulamaya çevirelim
Kapsamı netleştirip SEO, içerik ve satış akışını birlikte planlayalım.
WhatsApp'tan Yazın · Bilgi Alın+90 534 678 99 27