Invum POS
Giriş Yap Satın Al

iyzico — Invum POS kurulum kılavuzu

Bu kılavuz, WooCommerce mağazanızda iyzico ile kartlı ödeme almak için Invum POS'u nasıl ayarlayacağınızı anlatır. Kurulum yaklaşık 10-15 dakika sürer ve kod bilgisi gerektirmez.

Hangi sürümde?

iyzico, ücretsiz Invum POS Lite sürümüyle birlikte gelir; lisans gerekmez. 3D Secure Lite'a dahildir.

Müşteri ödeme adımında iyzico'nun güvenli ödeme formuna yönlendirilir. Kart bilgisi iyzico'nun sayfasında alınır, sitenize hiç ulaşmaz; bu da PCI yükünüzü en aza indirir.

Başlamadan önce

  • WordPress 6.6+, WooCommerce 9.0+ ve PHP 8.1+
  • Sitenizin tamamen HTTPS ile açılması (SSL sertifikası)
  • Bir iyzico üye işyeri hesabı. Canlı hesap için iyzico ile sözleşme yapmanız gerekir; denemek için ücretsiz bir sandbox (test) hesabı açabilirsiniz.

1. iyzico'dan alacağınız bilgiler

iyzico üye işyeri panelinde Ayarlar › API Anahtarları bölümünü açın. İki değer alacaksınız:

  • API Key
  • Secret Key

Test (sandbox) ve canlı hesabın anahtarları ayrıdır; biri diğerinin yerine çalışmaz. Anahtarları kimseyle paylaşmayın, ekran görüntüsünü göndermeyin.

2. Invum POS'ta hesap ekleme

  1. WordPress yönetim panelinde Invum POS › POS Hesapları sayfasını açın.
  2. Yeni POS Hesabı Ekle düğmesine tıklayın.
  3. Sağlayıcı listesinden iyzico'yu seçin.
  4. Hesap Etiketi alanına tanıyacağınız bir ad yazın (ör. "iyzico test").
  5. API Anahtarı (API Key) ve Gizli Anahtar (Secret Key) alanlarına iyzico panelinden kopyaladığınız değerleri yapıştırın. Başında ve sonunda boşluk kalmamasına dikkat edin.
  6. İlk kurulumda Test Modu kutusunu ("Bu hesap sağlayıcının test (sandbox) ortamını kullansın") işaretli bırakın ve sandbox anahtarlarını girin.
  7. 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.
  8. Taksit satışı yapacaksanız taksit oranlarını bu ekrandaki tabloda girin (aşağıya bakın).
  9. POS Hesabını Kaydet düğmesine basın.
  10. Hesap listesinde satırın yanındaki Bağlantıyı test et düğmesiyle anahtarlarınızın kabul edildiğini doğrulayın. Bu test para çekmez.

Anahtarlarınız veritabanında şifrelenerek saklanır. Daha sonra değiştirmek isterseniz yeni değeri girin; alanı boş bırakırsanız mevcut değer korunur.

Bildirim (callback) adresi

iyzico ödeme sonucunu sitenize otomatik olarak bildirir; iyzico panelinde ayrıca bir adres tanımlamanız gerekmez. Tek koşul, sitenizin herkese açık ve HTTPS üzerinden erişilebilir olmasıdır. Siteniz bakım modundaysa veya bir güvenlik duvarı dış istekleri engelliyorsa ödeme dönüşü başarısız olabilir.

Taksit

iyzico ödeme formunda taksit seçimi iyzico'nun sayfasında yapılır. Vade farkı iyzico panelindeki ayarlardan gelir; Invum POS fazladan tahsil edilen tutarı siparişe satır olarak ekler. Aynı komisyonu iki kez almamak için iyzico panelinde "vade farkını müşteriye yansıt" benzeri bir ayar açıksa Invum POS tablosundaki oranları 0 bırakın. BDDK taksit sınırları otomatik uygulanır.

Test modu ve test kartı

Test Modu açıkken gerçek para hareketi olmaz. iyzico'nun kamuya açık test kartlarından biriyle deneyin:

  • Kart no: 5528 7900 0000 0008 (Mastercard, başarılı işlem)
  • Son kullanma: 12/30 (gelecekteki herhangi bir tarih olur)
  • CVV: 123

Diğer test kartları için iyzico'nun geliştirici dokümantasyonuna bakın. Invum POS'ta Invum POS › Test Kartları sayfasında da bu kartlar listelenir.

Deneme adımları: düşük tutarlı bir ürünü sepete ekleyin, ödemede iyzico'yu seçin, test kartıyla ödemeyi tamamlayın. Sipariş "İşleniyor" veya "Tamamlandı" durumuna geçmeli; işlem Invum POS › İşlem Logları sayfasında görünmelidir.

Canlıya geçiş kontrol listesi

  • iyzico hesabınızın canlı (onaylı) olduğundan emin olun.
  • POS hesabını düzenleyin; canlı API Anahtarı ve Gizli Anahtar değerlerini girin.
  • Test Modu kutusunu kapatın ve kaydedin. Test/canlı modu anahtarla uyuşmazsa iyzico "kimlik bilgisi bulunamadı" benzeri bir hata döner.
  • Bağlantıyı test et düğmesine basın.
  • Kendi kartınızla küçük tutarlı gerçek bir ödeme yapın; iyzico panelinde göründüğünü doğrulayın, isterseniz panelden iade edin.
  • Ödeme yönteminin ödeme sayfasında göründüğünü kontrol edin.

Sık karşılaşılan sorunlar

  • Kimlik bilgisi / imza hatası: API Key ya da Secret Key hatalı yapıştırılmış veya test anahtarı canlı modda (ya da tersi) kullanılıyor.
  • Ödeme yöntemi görünmüyor: POS hesabında "Etkin — ödeme sayfasında sunulsun" açık olmalı; hesabın anahtarları boşsa bkz. ERR_GATEWAY_NOT_CONFIGURED.
  • 3D Secure sonrası sipariş beklemede kalıyor: Müşteri doğrulamayı yarıda kesmiş olabilir ya da site dış isteklere kapalıdır. Bkz. ERR_3DS_CALLBACK_FAILED.
  • Ödeme reddedildi: Çoğunlukla kartı veren bankanın kararıdır. Bkz. ERR_CHARGE_FAILED ve Banka red kodları rehberi.
  • İade yapılamıyor: Bkz. ERR_REFUND_FAILED.
  • Taksit seçilemiyor: BDDK ürün grubu sınırı olabilir. Bkz. ERR_INSTALLMENT_NOT_ALLOWED.

Destek

Sorun yaşarsanız Hesabım › Destek Talepleri üzerinden bize yazın. Yazarken İşlem Logları'ndaki hata kodunu ve yaklaşık saati eklemeniz çözümü hızlandırır.