Iyzico Sanal POS
Kategori: Ödeme Versiyon: 1.0.0
Iyzico, vitrinde kart ile ödemeyi etkinleştirmenizi sağlar. 3D Secure, taksit ve hosted checkout desteği vardır.
Desteklenen Özellikler
- Kredi/banka kartı ile ödeme
- 3D Secure (3DS) doğrulama
- Taksitli ödeme
- Hosted checkout (Iyzico ödeme sayfasına yönlendirme)
- Test ve canlı ortam
⚠️ İade ve iptal işlemleri panelden yapılamaz. Para iadelerinizi Iyzico merchant panelinizden gerçekleştirmeniz gerekir.
1. Ön Hazırlık — Iyzico Panelinden Anahtarları Alın
- merchant.iyzipay.com üzerinden hesabınıza giriş yapın.
- Ayarlar → API Anahtarları bölümüne gidin.
- API Key ve Secret Key değerlerini kopyalayın.
- Test denemeleri için Sandbox sekmesindeki test anahtarlarını kullanın.
2. Eklentiyi Mağaza Panelinde Yapılandırın
- Sol menüden Eklenti Mağazası sayfasına gidin ve İyzico 3D Secure kartındaki Eklentiyi Yapılandır butonuna tıklayın. (Aynı sayfaya Ödeme Entegrasyonları listesinden de ulaşabilirsiniz.)
- Aşağıdaki alanları doldurun:
| Alan | Açıklama |
|---|---|
| API Key (API Anahtarı) | Test ortamında sandbox- , canlıda production- ile başlar |
| Secret Key (Gizli Anahtar) | Iyzico gizli anahtarı |
| Test modu (Sandbox) | Canlıya geçmeden önce açık tutun |
| İyzico ödeme sayfası (Checkout Form) | Açıkken müşteri kart bilgisini İyzico'nun sayfasında girer; kapalıyken kart alanları vitrin ödeme adımında gösterilir |
- Entegrasyonu aktif et anahtarını açın ve Ayarları kaydet butonuna tıklayın.
ℹ️ Taksit ve 3D Secure için eklentide ayrı bir alan yoktur; taksit sayısı Ayarlar → Ödeme sayfasındaki Max Taksit Sayısı, 3DS zorunluluğu ise aynı sayfadaki 3D Secure Zorunlu anahtarı ile yönetilir.
3. Bağlantıyı Test Edin
Bağlantıyı test et butonuna tıklayın. "Iyzico bağlantısı başarılı" mesajı görürseniz hazırdır.
⚠️ Test ortamında işlem yaparken gerçek kart bilgisi kullanmayın. Iyzico'nun belgelendirdiği test kartları ile deneyin.
4. Hosted Checkout (Önerilen)
Hosted Checkout açıkken müşteri ödeme için Iyzico'nun güvenli sayfasına yönlendirilir; kart bilgileri sizin sunucunuzdan geçmez. PCI DSS yükü en aza iner.
İyzico ayarlarındaki İyzico ödeme sayfası (Checkout Form) anahtarını açık bırakın.
Sık Karşılaşılan Sorunlar
"3D Secure gerekiyor" hatası: Bankanın 3DS zorunluluğu var. Ayarlar → Ödeme sayfasından 3D Secure Zorunlu anahtarını açın.
"Sandbox/Production mismatch": Test anahtarlarıyla canlıya, canlı anahtarlarla teste geçemezsiniz. Test modu (Sandbox) anahtarını anahtarlarınızla aynı ortama ayarlayın.
"Geçersiz imza" hatası: API Key/Secret Key yanlış girilmiş olabilir; tekrar kopyalayıp yapıştırın.
Komisyon hesaplama: Iyzico komisyonu işlem bazında Iyzico panelinde gözükür; İGKFast'te ayrı bir gider olarak işleyebilirsiniz (Muhasebe → Giderler).