İş Bankası WooCommerce sanal POS entegrasyonu

Bir bakışta

Altyapı

NestPay (Asseco EST), sanalpos.isbank.com.tr.

Test ortamı

İş Bankası’na özel NestPay test sunucusu; test bilgilerini banka verir.

Ödeme akışı

Kart formu mağazanızda, 3D doğrulama İş Bankası ekranında, provizyon dönüşte sunucudan (3D Model).

Taksit

Var. Maximum kartlar için ayrı oran tanımlanabilir.

Gereken plan

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

İş Bankası’ndan sanal POS almak

İş Bankası, Sanal POS Hizmeti sayfasında süreci şöyle anlatıyor: bankayla üye işyeri anlaşmanız varsa şubenize başvurup Elektronik Ticaret Sözleşmesi’ni imzalamanız yeterli; üye işyeri değilseniz işyeri başvurusunu şube üzerinden yaparsınız.

Aynı sayfa, sitenin karşılaması gereken şartları da sıralıyor. WooCommerce mağazanızda bunların karşılığı kabaca şöyle:

• SSL sertifikası: site tamamen HTTPS ile açılmalı. 3D Secure dönüşü için zaten zorunlu.
• Ürün bilgisi: her ürünün açık tanımı ve fiyatı yayında olmalı; boş ya da “yakında” ürünler başvuruyu zorlaştırır.
• İşyeri bilgileri: ticaret unvanı, adres, müşteri hizmetleri telefonu ve e-posta adresi (WooCommerce’te genellikle iletişim sayfası ve alt bilgi).
• Politikalar: iade, teslimat, gizlilik ve ödeme koşulları sayfaları.
• Kart logoları: Visa, Mastercard ve American Express logoları sitede görünür olmalı.

Komisyon ve valör şubeyle yapılan sözleşmeye bağlıdır; burada rakam vermiyoruz.

İş Bankası’ndan alacağınız bilgiler

İş Bankası’nın geliştirici portalında açılan uygulamalar OAuth “Client ID / Client Secret” verir; bunlar sanal POS entegrasyon bilgisi değildir ve Invum POS alanlarına uymaz. Şubeden ya da sanal POS destek ekibinden NestPay (EST) bilgilerinizi isteyin:

Invum POS’ta kurulum

1. Pro planı 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 NestPay – İş Bankası‘nı seçin ve bir Hesap Etiketi yazın.
4. Client ID, API kullanıcı adı, API şifresi ve store key’i sırasıyla Merchant / Client ID, API Username, API Password ve Store Key (3D hash secret) alanlarına girin.
5. Bankadan aldığınız bilgiler test bilgileriyse Test Modu‘nu açık bırakın.
6. “Etkin — ödeme sayfasında sunulsun” bayrağını açın; tek POS’unuz buysa “Varsayılan hesap”ı da seçin. Taksit oranlarını girip POS Hesabını Kaydet‘e basın.
7. Bir test siparişi verin: kart formunu doldurun, İş Bankası’nın 3D ekranında doğrulayın, sipariş onay sayfasına döndüğünüzü ve siparişin ödendi olarak işaretlendiğini görün.

Test ortamı ve canlıya geçiş

İş Bankası, NestPay bankalarının çoğundan farklı olarak kendi test sunucusunu kullanır. Invum POS’ta İş Bankası hesabında Test Modu açıkken ödeme bu sunucuya gider; bu yüzden test mağaza bilgilerini ve test kartlarını doğrudan İş Bankası’ndan almanız gerekir. Test modunda en güvenilir kontrol, yukarıdaki gibi küçük bir test siparişidir. Canlı bilgileri girip Test Modu’nu kapattıktan sonra hesap listesindeki Bağlantıyı test et düğmesiyle kimlik bilgilerinin kabul edildiğini de doğrulayın; bu test ödeme çekmez.

Taksit ve BDDK sınırları

İş Bankası’nın kart programı Maximum’dur. Invum POS’un Taksit Oranları tablosunda 2’den 12’ye kadar her taksit için vade farkı ve isterseniz sabit ek ücret girersiniz; Maximum sekmesinde bu kartlara özel oran tanımlayabilirsiniz. Kampanyayla gelen “artı taksit” de bilgi olarak gösterilebilir; bu, çekilen tutarı değiştirmez. Oranları İş Bankası sözleşmenizdeki komisyon tablosundan alın, etkisini komisyon hesaplama aracında görün.

BDDK’nın ürün grubuna göre koyduğu taksit sınırları Taksit Uyumu ayarlarıyla otomatik uygulanır: BDDK taksit sınırları rehberi.

Sık karşılaşılan hatalar

• Geliştirici portalı bilgileri girildi: OAuth Client ID/Secret ile NestPay çalışmaz; banka sanal POS bilgilerini isteyin.
• Test bilgisi canlı modda: İş Bankası test ve canlı ortamları ayrı olduğundan Test Modu ayarı bilgilerle eşleşmelidir.
• 3D doğrulama başarısız: Invum POS NestPay’de yalnız mdStatus=1 olan ödemeleri kabul eder; diğer değerlerin anlamları POS ve banka hata kodları yazısında. Ayrıntılı kayıt eklentinin İşlem Logları ekranındadır.
• Dönüşte imza hatası: store key yanlış (ERR_3DS_CALLBACK_INVALID).
• Kart reddi (05, 51, 54, 57): kartı veren bankanın kararıdır; müşteri başka kartla denemelidir.

İade ve iptal

Eklentinin güncel sürümünde sipariş ekranındaki İade düğmesi iadeyi doğrudan İş Bankası’na gönderir; parayı çeken POS hesabını ve işlemi 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 eklenti otomatik olarak normal iadeye geçer. Kısmi iade her zaman iade olarak gönderilir, böylece iptal yanlışlıkla tüm tutarı geri vermez. Bu akış NestPay test ortamında gerçek test işlemleriyle denendi. Banka bir iadeyi reddederse nedeni sipariş notuna yazılır; o durumda iadeyi İş Bankası sanal POS panelinden yapıp WooCommerce siparişine kaydedebilirsiniz.