Ziraat Bankası WooCommerce sanal POS entegrasyonu

Bir bakışta

Altyapı

NestPay (Asseco EST), sanalpos2.ziraatbank.com.tr.

Test ortamı

Ziraat’e özel NestPay test sunucusu; test bilgileri yalnız bankadan alınır.

Ödeme akışı

Kart mağazanızın formunda girilir; 3D doğrulama Ziraat ekranında; provizyon dönüşte sunucudan (3D Model).

Taksit

Var; Bankkart için ayrı oran tanımlanabilir.

Gereken plan

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

Ziraat Bankası’na başvuru

Ziraat Bankası, POS Ürünlerimiz sayfasında sanal POS’u “e-ticaret alışverişlerinde POS hizmetini güvenli olarak sağlayan yazılım” diye tanımlıyor ve başvuru için şubelere yönlendiriyor; üye işyeri hizmetlerinin ayrıntıları bankkartpos.com.tr’de. Başvuruda bankaya üç şeyi açıkça söyleyin:

• Sanal POS’u bir WooCommerce sitesinde, 3D Secure ile kullanacaksınız.
• Entegrasyonu NestPay (EST) üzerinden yapacaksınız; Client ID, API kullanıcısı, API şifresi ve 3D store key’e ihtiyacınız var.
• Taksitli satış yapacaksanız taksit yetkisinin sözleşmede tanımlanmasını istiyorsunuz.

Bankalar başvuruda sitenizi inceler: ürünlerin fiyatlarıyla yayında olması, SSL, mesafeli satış ve iade metinleri, işletme unvanı ve iletişim bilgileri hazır olmalı. Komisyon ve ücretler sözleşmenize göre belirlenir.

Ziraat’ten alacağınız bilgiler

Invum POS’ta adım adım

1. Pro planı satın alın, eklentiyi Hesabım › İndirmeler’den kurun ve lisansı etkinleştirin.
2. Invum POS › POS Hesapları › Yeni POS Hesabı Ekle ekranını açın.
3. Sağlayıcı olarak NestPay – Ziraat Bankası‘nı seçin, Hesap Etiketi olarak örneğin “Ziraat” yazın.
4. Bankanın verdiği dört bilgiyi tablodaki alanlara girin.
5. Test bilgileriyle başlıyorsanız Test Modu‘nu açık bırakın; ödeme Ziraat’in test sunucusuna gider.
6. “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.
7. Test kartıyla bir sipariş verip 3D doğrulamasından sonra siparişin ödendi olarak işaretlendiğini kontrol edin.

Test ortamı ve canlıya geçiş

Ziraat, NestPay bankalarının çoğunun kullandığı ortak test sunucusu yerine kendi test sunucusunu kullanır. Bu yüzden internette bulunan genel NestPay test bilgileri Ziraat hesabında çalışmaz; test mağaza bilgisini ve test kartlarını bankadan isteyin. Test modunda en anlamlı kontrol gerçek bir test siparişidir.

Canlıya geçişte canlı bilgileri girin, Test Modu’nu kapatın ve hesap listesindeki Bağlantıyı test et düğmesiyle bilgilerin kabul edildiğini görün (bu test ödeme çekmez). Ardından küçük tutarlı ilk gerçek siparişi verip sanal POS panelinden kontrol edin.

Bankkart taksitleri ve BDDK sınırları

Ziraat’in kart programı Bankkart’tır. Invum POS’un Taksit Oranları tablosunda “Bankkart (Ziraat)” sekmesi bulunur; burada Bankkart’lara özel vade farkı tanımlayabilir, diğer kartlarda Genel oranları kullanabilirsiniz. Müşteri kart numarasını yazınca kartın ailesi belirlenir ve ona uygun taksit tablosu gösterilir. Oranları Ziraat sözleşmenizdeki komisyon tablosundan alın; müşteriye yansıyacak tutarı komisyon hesaplama aracında görebilirsiniz.

Telefon, kuyum gibi ürün gruplarındaki BDDK taksit sınırları eklentinin Taksit Uyumu ayarlarıyla otomatik uygulanır. Ayrıntılar BDDK taksit sınırları yazısında.

Sık karşılaşılan hatalar

• Test bilgileri çalışmıyor: genel NestPay test bilgileri ya da başka bankanın test bilgileri girilmiş olabilir. Ziraat’in kendi test bilgileri gerekir.
• Taksit seçeneği bankada reddediliyor: sözleşmenizde taksit yetkisi tanımlı olmayabilir; bankaya sorun.
• 3D doğrulama sonrası red: NestPay’de yalnız mdStatus=1 kabul edilir. Diğer değerler ve banka red kodları için POS ve banka hata kodları yazısına bakın.
• İmza hatası: store key yanlış (ERR_3DS_CALLBACK_INVALID).
• Bankaya ulaşılamıyor: sunucunuzun dış bağlantısı ya da SSL zinciri; hosting firmanızla kontrol edin (ERR_CHARGE_FAILED).

İade ve iptal

Eklentinin güncel sürümünde sipariş ekranındaki İade düğmesi iadeyi doğrudan Ziraat 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 Ziraat Bankası sanal POS panelinden yapıp WooCommerce siparişine kaydedebilirsiniz.