> Önemli (Ekim 2026): Param (TURK Elektronik Para A.Ş.) Temmuz 2026'dan beri TMSF kayyımlığında ve üye işyerlerine hak edişleri yalnız kısmen ödenebiliyor. Invum POS 1.0.22'den itibaren yeni Param hesabı eklenemez. Mevcut hesabınız çalışmaya devam eder, ancak kartlı ödemelerinizi iyzico, PayTR ya da bankanızın sanal POS'una taşımanızı öneririz. Bu kılavuz yalnız mevcut kurulumlar için tutuluyor.
Bu kılavuz, WooCommerce mağazanızda Param (TurkPos) sanal POS'u ile kartlı ödeme almak için Invum POS'u nasıl ayarlayacağınızı anlatır.
Hangi sürümde?
Param, Invum POS Pro ile açılır (ücretsiz Lite sürümünde yoktur). Pro eklentisini Hesabım › İndirmeler bölümünden indirip kurun ve lisansınızı etkinleştirin. Param ile birlikte NestPay altyapısındaki bankalar da aynı planla gelir.
Kart bilgisi ödeme sayfasında sitenizdeki kart formuna girilir ve 3D Secure için Param'a iletilir. Bu yüzden kart verisi sitenizden geçer ve PCI sorumluluğunuz artar. Kartın nasıl korunduğunu ve size düşen yükümlülükleri Mağaza PCI rehberi sayfasında okuyabilirsiniz. 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
- Param ile yapılmış üye işyeri sözleşmesi ve canlı hesap. Test hesabı için Param'dan test bilgilerini isteyin.
- Param, güvenlik gereği sunucunuzun IP adresini tanımlamanızı isteyebilir. Başvuru sırasında sitenizin sunucu çıkış IP adresini Param'a bildirin; paylaşımlı hostingte bu adresi hosting firmanız verir. Sunucunuzun IP adresi değişirse Param'a yeniden bildirmeniz gerekir.
1. Param'dan alacağınız bilgiler
Param sanal POS entegrasyon bilgilerinizi dört değer olarak verir:
- Müşteri Kodu (CLIENT_CODE)
- Kullanıcı Adı (CLIENT_USERNAME)
- Şifre (CLIENT_PASSWORD)
- Anahtar (GUID)
Bu bilgilerin hangi ekranda yer aldığını Param üye işyeri panelindeki entegrasyon bölümünden veya Param temsilcinizden öğrenebilirsiniz. Canlı ve test bilgileri farklıdır.
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 Param'ı seçin. (Listede "Pro" etiketi görüyorsanız Pro eklentisi kurulu ve etkin olmalıdır.)
- Hesap Etiketi alanına bir ad yazın.
- Dört alanı doldurun: Müşteri Kodu (CLIENT_CODE), Kullanıcı Adı (CLIENT_USERNAME), Şifre (CLIENT_PASSWORD) ve Anahtar (GUID).
- Test bilgileriyle başlıyorsanız 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 satışı yapacaksanız taksit oranlarını girin (aşağıya bakın).
- POS Hesabını Kaydet düğmesine basın.
- Hesap listesinde Bağlantıyı test et düğmesini kullanın. Bu test para çekmez. Test hata verirse ve bilgilerinizden eminseniz sebep büyük olasılıkla IP tanımıdır; Param ile görüşün.
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 Secure doğrulaması sonrasında Param müşteriyi sitenize şu adrese döndürür:
https://siteniz.com/wp-json/invum-pos/v1/param/callback
(siteniz.com yerine kendi alan adınızı yazın.) Eklenti bu adresi her ödeme isteğinde kendisi iletir; Param panelinde ayrıca tanımlamanız gerekmez. Adresin herkese açık olması gerekir: bakım modu, güvenlik duvarı veya "wp-json" erişimini kapatan bir eklenti dönüşü engeller.
Taksit
Param'da vade farkı oranlarını POS hesabı ekranındaki Taksit tablosuna sözleşmenizdeki komisyon tablosuna göre girersiniz. Hesabınızda destekleniyorsa PSP'den Oranları Getir düğmesi oranları Param'dan forma doldurur; değerleri kontrol edip kaydetmeyi unutmayın. BDDK ürün grubu taksit sınırları otomatik uygulanır.
Test modu ve test kartı
Test Modu açıkken ödeme Param'ın test ortamına gider ve gerçek para hareketi olmaz. Test kartlarını Param'ın geliştirici dokümantasyonundan veya Param temsilcinizden alın; Invum POS'ta bu sağlayıcı için hazır kart listesi yoktur. Gerçek kartla test ortamında işlem denemeyin.
Deneme adımları: düşük tutarlı bir ürünü sepete ekleyin, ödemede kartı seçin, test kartıyla 3D doğrulamayı geçin. Sipariş ödenmiş duruma geçmeli ve işlem Invum POS › İşlem Logları sayfasında görünmelidir.
Canlıya geçiş kontrol listesi
- Param canlı hesabınızın ve canlı bilgilerinizin elinizde olduğunu doğrulayın.
- POS hesabında canlı bilgileri girin, Test Modu kutusunu kapatın ve kaydedin.
- Sunucu IP adresinizin Param'da tanımlı olduğundan emin olun.
- Bağlantıyı test et düğmesine basın.
- Kendi kartınızla küçük tutarlı gerçek bir ödeme yapın; Param panelinde göründüğünü doğrulayın, isterseniz iade edin.
- Taksit oranlarının sözleşmenizle uyumlu olduğunu kontrol edin.
Sık karşılaşılan sorunlar
- Bağlantı testi başarısız / bağlantı kurulamıyor: Çoğunlukla sunucu IP'sinin Param'da tanımlı olmaması ya da test bilgisinin canlı modda (veya tersinin) kullanılmasıdır. Bkz. ERR_CHARGE_FAILED.
- Alanlar boş / ödeme yöntemi çalışmıyor: Bkz. ERR_GATEWAY_NOT_CONFIGURED.
- 3D Secure sonrası sipariş beklemede kalıyor: Bkz. ERR_3DS_CALLBACK_FAILED.
- Dönüşte doğrulama hatası: Bkz. ERR_3DS_CALLBACK_INVALID.
- Ödeme reddedildi: Çoğunlukla kartı veren bankanın kararıdır. Bkz. Banka red kodları rehberi.
- İ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.