VakıfBank WooCommerce sanal POS entegrasyonu

Bir bakışta

Altyapı

Innova PayFlex: provizyon için VPOS 7/24, 3D Secure için GET 7/24 MPI.

Ödeme akışı

Kart mağazanızın formunda girilir, Invum POS kartın 3D kaydını sorgular, müşteri VakıfBank’ın 3D ekranında doğrular, provizyon dönüşte sunucudan istenir (3D Model).

Ağ gereksinimi

Sunucunuzun çıkış IP’si VakıfBank’ta tanımlı olmalı; sunucudan dışarıya 8443 portu açık olmalı.

Taksit

Var; oranları siz girersiniz.

Gereken plan

Pro (₺3.500/yıl, KDV dahil) ya da üstü.

VakıfBank’tan sanal POS almak

VakıfBank sanal POS’u üye işyeri sözleşmesinin parçası olarak verilir; iyzico ya da PayTR’deki gibi kendi kendinize açabileceğiniz bir test hesabı yoktur. Ticari hesabınızın bulunduğu şubeye ya da VakıfBank POS ekibine başvurup sanal POS ve 3D Secure talebinizi iletin. Bilgi ve giriş için VakıfBank’ın sanal POS sitesine bakabilirsiniz.

Başvuruda iki konuyu baştan konuşun: 3D Secure kullanacağınızı ve sitenizin sunucu IP adresinin tanımlanması gerektiğini. Paylaşımlı hostingte IP adresi hosting firmanızdan öğrenilir; IP değişirse bankaya yeniden bildirmeniz gerekir. Komisyon ve ücretler sözleşmenize göre belirlenir.

VakıfBank’tan alacağınız bilgiler

Onaydan sonra VakıfBank sanal POS yönetim paneline giriş bilgisi gönderir. Entegrasyon bilgileri panel kılavuzunda anlatıldığı gibi üye işyeri detay ekranında yer alır. Invum POS’ta üç alan doldurulur:

PayFlex isteklerinde ek bir imza anahtarı yoktur; güvenlik bu üç bilginin gizliliğine ve IP tanımına dayanır. Şifreyi e-postada ya da mesajlaşma uygulamalarında paylaşmamaya özen gösterin.

Invum POS’ta kurulum

1. Pro planını satın alın; eklentiyi Hesabım › İndirmeler’den kurun ve lisansı etkinleştirin. WordPress.org’daki Lite sürümünde VakıfBank yoktur, ücretli eklentiyle gelir.
2. Invum POS › POS Hesapları › Yeni POS Hesabı Ekle ekranında Sağlayıcı olarak VakıfBank‘ı seçin ve bir Hesap Etiketi yazın.
3. Merchant ID, Merchant Password ve Terminal No alanlarını doldurun.
4. Test bilgileriyle başlıyorsanız Test Modu‘nu açık bırakın.
5. “Etkin — ödeme sayfasında sunulsun” ve gerekirse “Varsayılan hesap” bayraklarını açın, taksit oranlarını girin, POS Hesabını Kaydet‘e basın.
6. Bağlantıyı test et ile hem kimlik bilgilerini hem de sunucunuzun VakıfBank’a ulaşıp ulaşamadığını kontrol edin. Test, var olmayan bir işlem için zararsız bir iptal isteği gönderir; gerçek işleme dokunmaz.

Test ortamı ve canlıya geçiş

Test Modu açıkken Invum POS, VakıfBank’ın test servislerine bağlanır. Test üye işyeri bilgilerini ve test kartlarını VakıfBank verir. VakıfBank sanal POS servislerini yakın zamanda yeni bir API ağ geçidine (8443 portu) taşıdı; Invum POS güncel adresleri kullanır. Bağlantı testi “ulaşılamadı” diyorsa sorun büyük olasılıkla kimlik bilgisi değil ağdır: IP tanımını ve 8443 portunu hosting firmanızla kontrol edin.

Canlıya geçişte canlı bilgileri girip Test Modu’nu kapatın, canlı sunucu IP’nizin bankada tanımlı olduğundan emin olun ve küçük tutarlı bir ilk ödeme yapın.

Taksit ve BDDK sınırları

VakıfBank taksit oranlarını API’yle paylaşmaz; POS hesabının Taksit Oranları tablosuna sözleşmenizdeki oranları girersiniz. Seçilen taksit sayısı hem 3D doğrulama isteğine hem provizyona aynı değerle gider; iki adım arasında tutar ya da taksit değişirse ödeme reddedilir. Vade farkının etkisini komisyon hesaplama aracında görebilirsiniz.

Ürün grubuna göre BDDK taksit sınırları Taksit Uyumu ayarlarıyla uygulanır: BDDK taksit sınırları.

Kart bilgisi nasıl korunuyor?

PayFlex, 3D doğrulamasından sonraki provizyonda kart bilgisini yeniden ister. Invum POS bu yüzden kart bilgisini müşterinin 3D ekranında geçirdiği süre boyunca şifreli ve tek kullanımlık olarak, en fazla 5 dakika tutar; provizyondan sonra siler. Kart numarası ve CVV siparişe yazılmaz ve loglanmaz. Doğrulama dönüşü imzasız geldiği için ödeme, yalnız bankanın sunucudan verdiği provizyon onayıyla tamamlanır.

VakıfBank’ta sık hatalar

• Bağlantı kurulamıyor: sunucu IP’si bankada tanımlı değil ya da 8443 portu kapalı (ERR_CHARGE_FAILED).
• Üye işyeri bulunamadı / şifre yanlış: Merchant ID ya da Merchant Password hatalı, ya da test bilgisi canlı modda kullanılıyor.
• 3D doğrulama başarısız: Invum POS tam (Y) ve kısmi (A) doğrulama sonuçlarında provizyon ister; diğer sonuçlarda ödeme reddedilir.
• Red kodları: VakıfBank 4 haneli sonuç kodları kullanır (0000 başarılı). Bankanın verdiği red nedenleri ve genel kodlar için POS ve banka hata kodları yazısına bakın.

İade ve iptal

Eklentinin güncel sürümünde sipariş ekranındaki İade düğmesi iadeyi doğrudan VakıfBank’a gönderir: ödemeyle aynı gün tutarın tamamı iptal (Cancel), kısmi tutar ya da sonraki günler iade (Refund) olarak gider; banka iptali reddederse normal iadeye geçilir. Banka bir iadeyi reddederse nedeni sipariş notuna yazılır; o durumda iadeyi VakıfBank sanal POS panelinden yapıp WooCommerce siparişine kaydedin.