VakıfBank — Invum POS kurulum kılavuzu

Bu kılavuz, VakıfBank sanal POS'unu WooCommerce mağazanıza Invum POS ile bağlamak için gereken adımları anlatır.

Hangi sürümde?

VakıfBank, Invum POS Pro eklentisiyle ve Studio ya da üstü planla açılır (ücretsiz Lite sürümünde yoktur). Pro eklentisini Hesabım › İndirmeler bölümünden indirip kurun ve lisansınızı etkinleştirin.

VakıfBank sanal POS'u diğer birçok bankadan farklı bir altyapıyla (PayFlex) çalışır. Kart bilgisi ödeme sayfasında sitenizdeki kart formuna girilir, doğrulama VakıfBank'ın 3D ekranında yapılır. Kart verisi sitenizden geçtiği için PCI sorumluluğunuz artar; ayrıntı için Mağaza PCI rehberi sayfasına bakın. Invum POS kart numarasını ve CVV'yi siparişe yazmaz ve loglamaz; 3D doğrulama süresince kartı yalnız kısa süreli, şifreli ve tek kullanımlık tutar.

Başlamadan önce

• Invum POS Pro kurulu, Studio (veya üstü) lisansı etkin
• Tamamen HTTPS çalışan bir site
• VakıfBank ile yapılmış sanal POS ve 3D Secure destekli üye işyeri sözleşmesi. Test hesabını kendiniz açamazsınız; test bilgilerini banka verir.
• Sunucu IP tanımı: VakıfBank, sitenizin sunucu çıkış IP adresinin bankada tanımlı olmasını ister. Başvuruda bunu baştan konuşun. Paylaşımlı hostingte IP adresini hosting firmanız verir; IP değişirse bankaya yeniden bildirmeniz gerekir.
• Port: Sunucunuzdan dışarıya 8443 portunun açık olması gerekir. Bunu hosting firmanızla kontrol edin.

1. VakıfBank'tan alacağınız bilgiler

VakıfBank sanal POS yönetim panelinde veya üye işyeri bilgi formunda üç değer yer alır:

• Üye İşyeri No (Merchant ID)
• Üye İşyeri Şifresi (Merchant Password) — panel giriş şifreniz değil, entegrasyon şifresidir
• Terminal No

Şifreyi e-posta veya mesajlaşma uygulamalarında paylaşmayın.

2. Invum POS'ta hesap ekleme

1. WordPress panelinde Invum POS › POS Hesapları sayfasını açın.
2. Yeni POS Hesabı Ekle düğmesine tıklayın.
3. Sağlayıcı listesinden VakıfBank'ı seçin.
4. Hesap Etiketi alanına bir ad yazın.
5. Üye İşyeri No (Merchant ID), Üye İşyeri Şifresi ve Terminal No alanlarını doldurun.
6. Test bilgileriyle başlıyorsanız Test Modu kutusunu işaretli bırakın.
7. Bayraklar bölümünde Etkin — ödeme sayfasında sunulsun seçeneğini açın; tek POS hesabınız bu ise Varsayılan hesap'ı da işaretleyin.
8. Taksit oranlarını girin (aşağıya bakın) ve POS Hesabını Kaydet düğmesine basın.
9. Hesap listesinde Bağlantıyı test et düğmesini kullanın. Bu test hem bilgilerinizi hem de sunucunuzun VakıfBank'a ulaşıp ulaşamadığını denetler; gerçek bir işleme dokunmaz. "Ulaşılamadı" sonucu çoğunlukla kimlik bilgisinden değil, IP tanımı veya 8443 portundan kaynaklanır.

Bilgileriniz şifrelenerek saklanır. Değiştirmek için yeni değeri girin; alanı boş bırakırsanız mevcut değer korunur.

Bildirim (callback) adresi

3D doğrulama sonrasında VakıfBank müşteriyi sitenize şu adrese döndürür:

https://siteniz.com/wp-json/invum-pos/v1/vakifbank/callback

(siteniz.com yerine kendi alan adınızı yazın.) Eklenti bu adresi her ödeme isteğinde kendisi iletir. Adres herkese açık olmalıdır: bakım modu veya "wp-json" erişimini kapatan bir eklenti dönüşü engeller. Ödeme, yalnız VakıfBank'ın sunucudan verdiği provizyon onayıyla tamamlanır.

Taksit

VakıfBank taksit oranlarını paylaşmaz; sözleşmenizdeki oranları POS hesabı ekranındaki Taksit tablosuna kendiniz girersiniz. BDDK ürün grubu taksit sınırları otomatik uygulanır. Seçilen taksit sayısı ve tutar, doğrulama ile provizyon arasında değişirse ödeme reddedilir.

Test modu ve test kartı

Test Modu açıkken ödeme VakıfBank'ın test servislerine gider ve gerçek para hareketi olmaz. Test üye işyeri bilgilerini ve test kartlarını VakıfBank verir; Invum POS'ta bu sağlayıcı için hazır kart listesi yoktur. Gerçek kartla test ortamında işlem denemeyin.

Deneme adımları: düşük tutarlı bir ürünü sepete ekleyin, kart formunu doldurun, VakıfBank'ın 3D ekranında doğrulayın. Sipariş ödenmiş duruma geçmeli ve işlem Invum POS › İşlem Logları sayfasında görünmelidir.

Canlıya geçiş kontrol listesi

• Canlı Üye İşyeri No, Üye İşyeri Şifresi ve Terminal No değerlerini alın.
• Canlı sunucu IP adresinizin bankada tanımlı olduğundan emin olun.
• 8443 portunun dışarıya açık olduğunu doğrulayın.
• POS hesabında canlı bilgileri girin, Test Modu kutusunu kapatın ve kaydedin.
• Bağlantıyı test et düğmesine basın.
• Kendi kartınızla küçük tutarlı gerçek bir ödeme yapın; VakıfBank panelinde göründüğünü doğrulayın.
• Taksit oranlarını sözleşmenizle karşılaştırın.

Sık karşılaşılan sorunlar

• Bağlantı kurulamıyor: Sunucu IP'si bankada tanımlı değil ya da 8443 portu kapalı. Bkz. ERR_CHARGE_FAILED.
• Üye işyeri bulunamadı / şifre yanlış: Üye İşyeri No ya da Şifre hatalı, ya da test bilgisi canlı modda (veya tersi) kullanılıyor.
• 3D doğrulama başarısız: Müşteri doğrulamayı iptal etmiş ya da doğrulama sonucu kabul edilmemiştir. Bkz. ERR_3DS_CALLBACK_FAILED.
• Banka sonuç kodları: VakıfBank 4 haneli sonuç kodları kullanır (0000 başarılı). Anlamları için VakıfBank sonuç kodları rehberine ve Banka red kodları rehberine bakın.
• Alanlar boş: Bkz. ERR_GATEWAY_NOT_CONFIGURED.
• İade yapılamıyor: Bkz. ERR_REFUND_FAILED.
• Taksit seçilemiyor: Bkz. ERR_INSTALLMENT_NOT_ALLOWED.

Destek

Sorun yaşarsanız Hesabım › Destek Talepleri üzerinden bize yazın. İşlem Logları'ndaki hata kodunu ve yaklaşık saati eklemeniz çözümü hızlandırır.