Bu kılavuz, NestPay (Asseco) altyapısını kullanan bankaların sanal POS'unu WooCommerce mağazanıza Invum POS ile bağlamak için gereken adımları anlatır. Aynı adımlar tüm bu bankalar için geçerlidir; yalnız bankanın adını seçersiniz.
Hangi bankalar, hangi sürüm?
Bu bankalar Invum POS Pro ile açılır (ücretsiz Lite sürümünde yoktur): Akbank, Alternatif Bank, Anadolubank, Cardplus, Halkbank, ING Bank, İş Bankası, QNB Finansbank, Şekerbank, TEB, Türkiye Finans ve Ziraat Bankası. Pro eklentisini Hesabım › İndirmeler bölümünden indirip kurun ve lisansınızı etkinleştirin. Her bankanın kendi kurulum sayfası da vardır (Sanal POS Entegrasyonları bölümü).
Kart bilgisi ödeme sayfasında sitenizdeki kart formuna girilir; 3D doğrulama bankanın 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 saklamaz veya loglamaz.
Başlamadan önce
- Invum POS Pro kurulu ve lisansı etkin
- Tamamen HTTPS çalışan bir site
- Bankayla yapılmış sanal POS (elektronik ticaret) sözleşmesi. Başvuruyu bankanın şubesi veya sanal POS ekibi alır; komisyon ve valör sözleşmenize bağlıdır.
- Bankanın kendi geliştirici portalındaki "Client ID / Client Secret" (OAuth) bilgileri sanal POS bilgisi değildir; bunları kullanmayın.
1. Bankadan alacağınız bilgiler
Bankanın sanal POS yönetim panelinden veya sanal POS ekibinden şu dört bilgiyi isteyin:
- Mağaza numarası (Client ID)
- API kullanıcı adı (panelde API yetkisiyle tanımlanan kullanıcı)
- API şifresi
- 3D Secure anahtarı (Store Key) — ödeme dönüşünün imzasını doğrular
Bu bilgiler panel giriş şifrenizden farklıdır. E-posta veya mesajlaşma uygulamalarında paylaşmayın.
2. Invum POS'ta hesap ekleme
- WordPress panelinde Invum POS › POS Hesapları sayfasını açın.
- Yeni POS Hesabı Ekle düğmesine tıklayın.
- Sağlayıcı listesinden bankanızı seçin (ör. NestPay – Akbank).
- Hesap Etiketi alanına bir ad yazın.
- Dört alanı doldurun: Üye İşyeri No (Client ID), API Kullanıcı Adı, API Şifresi ve 3D Güvenlik Anahtarı (Store Key).
- Bankadan aldığınız bilgiler test bilgileriyse Test Modu kutusunu işaretli bırakın.
- 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.
- Taksit oranlarını girin (aşağıya bakın) ve POS Hesabını Kaydet düğmesine basın.
- Hesap listesinde Bağlantıyı test et düğmesini kullanın. Bu test para çekmez.
Birden fazla bankanız varsa her biri için ayrı bir POS hesabı ekleyin. 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 banka müşteriyi sitenize şu adrese döndürür:
https://siteniz.com/wp-json/invum-pos/v1/nestpay/callback
(siteniz.com yerine kendi alan adınızı yazın.) Eklenti dönüş adresini her ödeme isteğinde kendisi iletir. Bankanız sanal POS panelinde izinli dönüş adresi tanımı istiyorsa bu adresi ekleyin. Adres herkese açık olmalıdır: bakım modu veya "wp-json" erişimini kapatan bir eklenti dönüşü engeller. Dönüşteki imza, Store Key ile doğrulanır; Store Key yanlışsa ödeme tamamlanmaz.
Taksit
Bankanızın komisyon tablosundaki oranları POS hesabı ekranındaki Taksit tablosuna girin; kart ailesine (ör. Maximum, Bonus, World) özel oran tanımlayabilirsiniz. BDDK ürün grubu taksit sınırları otomatik uygulanır.
Test modu ve test kartı
Test Modu açıkken ödeme bankanın test ortamına gider. Birçok NestPay bankası ortak bir test ortamı kullanır; İş Bankası kendi test sunucusunu kullanır ve test bilgilerini banka verir. Ortak ortamda kullanılan test kartları:
- Mastercard: 5406 6754 0000 0003
- Visa: 4022 7740 2277 4026
- Son kullanma: gelecekteki herhangi bir tarih, CVV: 000
- 3D Secure şifresi: a (tek harf)
Bu kartlar Invum POS › Test Kartları sayfasında da listelenir. Banka size ayrı test kartı verdiyse onu kullanın.
Deneme adımları: düşük tutarlı bir ürünü sepete ekleyin, kart formunu doldurun, bankanı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
- Bankadan canlı Client ID, API kullanıcı adı, API şifresi ve Store Key değerlerini alı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; bankanın panelinde göründüğünü doğrulayın.
- Taksit oranlarının sözleşmenizle uyumlu olduğunu kontrol edin.
- Sipariş ekranındaki İade düğmesini küçük bir ödemeyle deneyin.
Sık karşılaşılan sorunlar
- Geliştirici portalı bilgileri girildi: OAuth Client ID/Secret ile NestPay çalışmaz; sanal POS bilgilerini isteyin.
- Test bilgisi canlı modda (veya tersi): Test Modu ayarı bilgilerle eşleşmelidir.
- Dönüşte imza hatası: Store Key yanlış. Bkz. ERR_3DS_CALLBACK_INVALID.
- 3D doğrulama başarısız / sipariş beklemede: Müşteri doğrulamayı iptal etmiş ya da banka reddetmiş olabilir. Bkz. ERR_3DS_CALLBACK_FAILED. Doğrulama durumlarının anlamı için POS ve banka hata kodları yazısına bakın.
- Kart reddi (05, 51, 54, 57 gibi): Kartı veren bankanın kararıdır; müşteri başka kartla denemelidir. Bkz. Banka red kodları rehberi ve ERR_CHARGE_FAILED.
- 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.