Garanti BBVA WooCommerce sanal POS entegrasyonu

Bir bakışta

Altyapı

Garanti BBVA’nın kendi sanal POS servisi (3D ağ geçidi + XML provizyon servisi). NestPay ya da Posnet değil.

Ödeme akışı

Kart mağazanızın formunda girilir, müşteri Garanti BBVA’nın 3D Secure ekranında doğrular, provizyon dönüşte sunucudan alınır (3D Model).

Kullanıcılar

Ödeme (provizyon) kullanıcısı ve iade kullanıcısı ayrı; ikisi de girilir.

Taksit

Var; Bonus kartlar için ayrı oran tanımlanabilir.

Gereken plan

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

Garanti BBVA’dan sanal POS almak

Garanti BBVA’nın Sanal POS sayfasına göre başvuruyu Garanti BBVA İnternet Bankacılığı’ndan, şubeden ya da sayfada bağlantısı verilen üye işyeri sanal POS başvuru formundan yapabilirsiniz. Banka, sitenizin SSL sertifikasına sahip olmasını, ürünlerin satışa hazır olarak yayında bulunmasını ve mesafeli satış ile hizmet sözleşmelerinin sitede yer almasını şart koşuyor. İstenen belgeler (vergi levhası, imza sirküleri, ticaret sicil gazetesi vb.) işletme türüne göre aynı sayfada listeleniyor.

Başvuruda sanal POS’u 3D Secure ile kullanacağınızı ve iade kullanıcısına da ihtiyacınız olduğunu belirtin. Komisyon ve valör koşullarını bankayla netleştirin; bunlar işletmeye göre değişir.

Garanti BBVA’dan alacağınız bilgiler

Invum POS’ta Garanti BBVA hesabı yedi alan ister. Alan adları eklenti ekranında İngilizce görünür:

Kullanıcı adları sizin hesabınızda farklıysa bankanın verdiğini aynen yazın.

Invum POS’ta kurulum

1. Pro planını satın alın; eklentiyi Hesabım › İndirmeler’den kurup lisansı aktivasyon rehberine göre etkinleştirin.
2. Invum POS › POS Hesapları ekranında Yeni POS Hesabı Ekle‘ye tıklayın.
3. Sağlayıcı listesinden Garanti BBVA‘yı seçin, bir Hesap Etiketi yazın.
4. Tablodaki yedi bilgiyi girin. İade kullanıcısını boş bırakmayın; boş kalırsa iade ve iptal yapılamaz.
5. Test bilgileriyle başlıyorsanız Test Modu açık kalsın.
6. “Etkin — ödeme sayfasında sunulsun” ve gerekiyorsa “Varsayılan hesap” bayraklarını açın, taksit oranlarını girin ve POS Hesabını Kaydet‘e basın.
7. Hesap listesinde Bağlantıyı test et‘e basın. Bu test, var olmayan bir sipariş için sorgu gönderir; Garanti BBVA kullanıcı ve şifreyi sorgudan önce doğruladığı için kimlik bilgileri ödeme çekmeden sınanır.

Test ortamı ve canlıya geçiş

Test Modu açıkken Invum POS Garanti BBVA’nın test sunucusuna bağlanır. Test terminal bilgilerine ve test kartlarına GarantiBBVA E-Ticaret Developer Portal‘dan ya da bankanızdan ulaşabilirsiniz. Test siparişinde Garanti’nin 3D ekranının açıldığını, dönüşte siparişin ödendi olarak işaretlendiğini ve İşlem Logları’nda kaydın oluştuğunu kontrol edin.

Canlıya geçerken yedi bilginin canlı karşılıklarını girin, Test Modu’nu kapatın ve küçük tutarlı ilk ödemeyi yapın. Garanti BBVA panelinizde sanal POS’un 3D Secure modunun tanımlı olduğundan emin olun; Invum POS standart 3D modeliyle çalışır.

Bonus taksitleri ve BDDK sınırları

Garanti BBVA’nın kart programı Bonus’tur. Invum POS’un Taksit Oranları tablosunda Bonus sekmesiyle bu kartlara özel vade farkı tanımlayabilir, diğer kartlarda Genel oranları kullanabilirsiniz. Taksit sayısı bankaya provizyonla birlikte iletilir. Oranları sözleşmenizdeki komisyon tablosundan alın; farkın etkisini komisyon hesaplama aracında görün.

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

Garanti BBVA’da sık hatalar

• İade “kimlik eksik” hatası veriyor: Refund User ve Refund Password boş ya da yanlış. Ödeme kullanıcısı iade için kullanılamaz (ERR_REFUND_FAILED).
• 3D dönüşünde imza hatası: Store Key yanlış ya da test/canlı bilgisi karışmış (ERR_3DS_CALLBACK_INVALID).
• 3D doğrulama başarısız: Garanti BBVA’da doğrulama sonucu mdstatus ile döner. Invum POS 1 (tam doğrulama) ile 2–4 (kısmi doğrulama) sonuçlarını kabul edip provizyonu bankaya sorar; diğer sonuçlarda ödeme reddedilir. Anlamları POS ve banka hata kodları yazısında.
• Bağlantı testi başarısız: Merchant ID, Terminal ID ya da provizyon kullanıcısı hatalı; Test Modu bilgilerle uyuşmuyor olabilir.

İade ve iptal

Garanti BBVA ile ödeme ve iade için eklentinin 1.0.19 ya da üstü sürümünü kullanın. Sipariş ekranındaki İade düğmesi iadeyi, POS hesabına girdiğiniz iade kullanıcısıyla doğrudan Garanti BBVA’ya gönderir; parayı çeken hesabı ve siparişi eklenti kendisi bulur. Ödemeyle aynı gün tutarın tamamını iade ederseniz işlem iptal (void) olarak gider; banka gün sonunu kapatmışsa normal iadeye geçilir. Kısmi iade her zaman iade olarak gönderilir. Bu akış Garanti BBVA test ortamında gerçek test işlemleriyle denendi. Banka bir iadeyi reddederse nedeni sipariş notuna yazılır; o durumda iadeyi Garanti BBVA sanal POS panelinden yapıp WooCommerce siparişine kaydedin.