Akbank WooCommerce sanal POS entegrasyonu

Bir bakışta

Altyapı

NestPay (Asseco EST), Akbank’ın sanalakpos.com adresi üzerinden.

Desteklenmeyen

Akbank’ın kendi yeni sanal POS API’si. Bu API için Invum POS’ta bağdaştırıcı yok.

Ödeme akışı

Kart mağazanızın formunda girilir, 3D Secure doğrulaması Akbank ekranında yapılır, provizyon dönüşte sunucudan alınır (3D Model).

Taksit

Var; oranları siz girersiniz. Axess kartları için ayrı oran tanımlanabilir.

Gereken plan

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

Önce şunu netleştirin: NestPay mı, Akbank’ın yeni API’si mi?

Akbank uzun yıllar sanal POS’u NestPay altyapısıyla sundu ve Türkiye’deki hazır e-ticaret eklentilerinin çoğu bu altyapıyı konuşur. Akbank son yıllarda kendi sanal POS API’sini de yayımladı ve yeni başvuruları bu API’ye yönlendirebiliyor. Invum POS’un Akbank desteği NestPay altyapısı içindir.

Bu yüzden başvuruda ya da mevcut sanal POS’unuz için Akbank’a şunu sorun: “NestPay (EST) entegrasyon bilgilerimi alabilir miyim: Client ID, API kullanıcısı, API şifresi ve 3D store key?” Akbank size yalnız yeni API’nin anahtarlarını veriyorsa bu bilgiler Invum POS’un Akbank alanlarına uymaz. O durumda Akbank’ı desteklenen bir ödeme kuruluşu üzerinden (iyzico, PayTR) ya da diğer bankalardan biriyle kullanabilirsiniz.

Akbank’a başvuru

Akbank, Akbank Sanal POS sayfasında başvurunun Akbank Mobil üzerinden yapılabildiğini anlatıyor. Aynı sayfada başvurunun değerlendirilmesinde bakılan noktalar listeleniyor: sitenin açık ve erişilebilir olması, kartla ödeme seçeneği, net ürün görselleri ve TL fiyatlar, mesafeli satış sözleşmesi ve iade politikası, açık adres ve telefon, SSL sertifikası, Visa ve Mastercard logoları. WooCommerce sitenizi başvurudan önce bu listeye göre gözden geçirin.

Kampanya, komisyon ve valör koşulları dönemsel olduğu için burada rakam vermiyoruz; güncel teklifi başvuru sırasında Akbank’tan alın.

Akbank’tan alacağınız bilgiler

Invum POS’ta kurulum

1. Pro planı satın alın, eklentiyi Hesabım › İndirmeler’den kurun ve lisansı aktivasyon rehberine göre etkinleştirin.
2. Invum POS › POS Hesapları › Yeni POS Hesabı Ekle yolunu izleyin.
3. Sağlayıcı olarak NestPay – Akbank‘ı seçin, Hesap Etiketi‘ne “Akbank” gibi bir ad verin.
4. Dört bilgiyi Merchant / Client ID, API Username, API Password ve Store Key (3D hash secret) alanlarına girin.
5. Test bilgileri giriyorsanız Test Modu açık kalsın; canlı bilgilerde kapatın.
6. “Etkin — ödeme sayfasında sunulsun” ve gerekiyorsa “Varsayılan hesap” bayraklarını açın, POS Hesabını Kaydet‘e basın.
7. Listede Bağlantıyı test et ile kimlik bilgilerini doğrulayın, ardından küçük tutarlı bir test siparişi verin.

Test ve canlıya geçiş

Test modunda Akbank hesabı NestPay’in ortak test sunucusuna bağlanır. Test mağaza bilgisini ve test kartlarını Akbank’tan isteyin; eklentinin Test Kartları ekranındaki NestPay örnek kartları da bu ortamda kullanılabilir. Test ödemesinde 3D ekranının açılıp sipariş onay sayfasına dönüldüğünü ve siparişin ödendi olarak işaretlendiğini kontrol edin.

Canlıya geçişte üç şeyi birlikte yapın: canlı Client ID, API kullanıcısı ve store key’i girin, Test Modu’nu kapatın, ilk gerçek ödemeyi küçük bir tutarla yapıp sanal POS panelinden kontrol edin.

Taksit ve BDDK sınırları

Akbank’ın kart programı Axess’tir. POS hesabının Taksit Oranları tablosunda genel oranların yanında Axess için ayrı oran girebilirsiniz; müşteri kart numarasını yazdığında kartın ailesi belirlenir ve ilgili oranlar gösterilir. Vade farkını müşteriye “üstüne ekle” ya da “net tutarımı koru” yöntemiyle yansıtabilir, 0 yazarak farkı üstlenebilirsiniz. Hangi yöntemin size ne kadar bıraktığını komisyon hesaplama aracında deneyebilirsiniz.

BDDK’nın ürün grubuna göre koyduğu azami taksit sınırları Taksit Uyumu ayarlarıyla uygulanır; ayrıntılar BDDK taksit sınırları rehberinde. Taksitli satışın genel kurulumu için WooCommerce taksitli ödeme yazısına da bakabilirsiniz.

Akbank kurulumunda sık hatalar

• Bilgiler alanlara uymuyor: Elinizdeki anahtarlar Akbank’ın yeni API’sine ait olabilir. NestPay (EST) bilgilerini isteyin.
• Bağlantı testi “kimlik” hatası veriyor: API kullanıcısı yerine panel giriş kullanıcısı yazılmış ya da Test Modu ile bilgiler uyuşmuyor.
• 3D ekranından sonra ödeme reddediliyor: NestPay’de yalnız tam doğrulama (mdStatus=1) kabul edilir. Diğer mdStatus değerlerinin anlamı POS ve banka hata kodları yazısında.
• İmza doğrulanamadı: Store Key hatalı ya da eksik (ERR_3DS_CALLBACK_INVALID).
• Hesap eksik uyarısı: zorunlu alanlardan biri boş (ERR_GATEWAY_NOT_CONFIGURED).

İade ve iptal

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