# iyzico Modülü

https://docs.wisecp.com/tr/iyzico-modulu

iyzico ile kredi ve banka kartı ödemesi alın; müşteriniz kendi sipariş sayfanızda öder, kart bilgisi sitenize hiç ulaşmaz.

## Ekrana Erişim

**Ayarlar → Finansal → Ödeme Ağ Geçitleri** yolunu izleyin, **Tüm Modüller** sekmesini açın ve iyzico kartına tıklayın: `{admin}/modules/payment?module=IyzicoV2`

Sistemle birlikte iki iyzico modülü gelir. **Iyzico V2** güncel olanıdır ve bu makale onu anlatır. **Iyzico** eski modüldür: aynı iki anahtarı alır ama test kipi ve taksit ayarı taşımaz.

**Durum** kutusunu işaretleyip kaydettiğinizde yöntem ödeme adımında listelenir. Müşterinin gördüğü sırayı [Ödeme Ağ Geçitleri](https://docs.wisecp.com/tr/odeme-modulleri) ekranından düzenleyin.

## Ekranda Neler Var

Kart, iyzico anahtarlarınızı ve her modülde bulunan ortak ağ geçidi ayarlarını taşır. iyzico ödeme formu kendi sipariş sayfanızın içinde açılır; müşteri kart bilgisini orada girer.

Bu ağ geçidi tek seferlik ödeme alır. Abonelik, kart saklama ve panelden gönderilen iade desteklenmez.

## Ön Koşullar

- Bir iyzico üye iş yeri hesabı. Test kipi için ayrıca bir sandbox hesabı gerekir; kaydı iyzico'nun kendi sandbox üye iş yeri sitesinden açarsınız.
- iyzico panelinizde **Ayarlar → Firma Ayarları** sayfasından aldığınız iki anahtar.
- iyzico hesabınızın kabul ettiği bir para birimi. Sisteminiz başka bir para biriminde fiyatlıyorsa **Para Birimi Dönüştürme** alanını doldurun.

## Alanlar

- **Durum**: Modülü açar. Kapalıyken diğer alanlar kilitli kalır ve müşteriye bu yöntem sunulmaz.
- **API Anahtarı**: Zorunlu. iyzico hesabınızın API anahtarı. Kurulumla birlikte örnek bir sandbox anahtarı dolu gelir; kendi anahtarınızla değiştirin. Sandbox anahtarı `sandbox-` ile başlar.
- **Güvenlik Anahtarı**: Zorunlu. Her isteği imzalayan gizli anahtar. O da örnek bir sandbox değeriyle dolu gelir; kaydettikten sonra gizli tutulur.
- **Taksit Seçeneği Göster**: İsteğe bağlı. iyzico formunda sunulacak taksit sayıları, virgülle ayrılır: `2,3,6,9`. Alan `2,3` ile dolu gelir; boş bırakırsanız kararı iyzico verir.
- **Test Modu**: Her isteği canlı servis yerine iyzico sandbox'ına gönderir. İşaretli gelir; gerçek para almadan önce işareti kaldırın.

Eski **Iyzico** kartında **API Key** ve **Secret Key** alanları bulunur; o modül her zaman canlı servisle konuşur.

Komisyon, para birimi dönüştürme, kabul edilen tutar aralığı ve ülke listeleri her ağ geçidinde aynı çalışır: [Ödeme Ağ Geçitleri](https://docs.wisecp.com/tr/odeme-modulleri). **Callback URL**, **Success URL** ve **Failed URL** alanlarını değiştiremezsiniz. iyzico bildirim adresini her ödeme isteğiyle birlikte alır; iyzico panelinizde bir kayıt açmanız gerekmez.

## İşlemler

### iyzico hesabınızı bağlama

1. Sandbox hesabınıza girin ve **Ayarlar → Firma Ayarları** sayfasını açın. Sayfanın altındaki **API Anahtarları** bölümünde **Görüntüle** butonuna tıklayıp iki anahtarı da alın. Sandbox hesapları `sandbox-merchant.iyzipay.com` adresinde durur.
2. **Tüm Modüller** altındaki iyzico kartını açın ve **Durum** kutusunu işaretleyin.
3. **API Anahtarı** ve **Güvenlik Anahtarı** alanlarındaki örnek değerleri kendi anahtarlarınızla değiştirin; **Test Modu** işaretli kalsın.
4. **Değişiklikleri Kaydet** butonuna tıklayın. Yöntem artık ödeme adımında görünür.

### Test ödemesi yapma

1. Müşteri olarak küçük tutarlı bir sipariş verin ve ödeme adımında iyzico'yu seçin.
2. Açılan formda bir iyzico sandbox test kartıyla ödeyin.
3. Müşteri sitenize döner. Ödemeyi iyzico panelinizden doğrulayın: bu sürüm dönüşü kaçırıp faturayı açık bırakabilir.

### Canlı anahtarlara geçme

1. **Test Modu** işaretini kaldırın.
2. İki anahtarı da canlı çiftle değiştirin. Bunları aynı yoldan, ama canlı üye iş yeri panelinizden alırsınız; sandbox anahtarları canlı serviste çalışmaz.
3. **Değişiklikleri Kaydet** butonuna tıklayın, sonra küçük tutarlı bir faturayı gerçekten ödeyin ve paranın iyzico hesabınıza geçtiğini görün.

### Taksit sunma

1. iyzico ile anlaştığınız taksit sayılarını **Taksit Seçeneği Göster** alanına yazın: `3,6,9`.
2. **Değişiklikleri Kaydet** butonuna tıklayın.
3. iyzico formu bu sayıları, kartı destekleyen müşteriye gösterir.
4. Daha pahalıya gelen bir taksit planında fark, faturaya ayrı bir satır olarak eklenir. Sipariş tutarı da bu farkı izler.
5. **Para Birimi Dönüştürme** alanı doluysa bu kapalıdır; fark faturaya yansımaz.

## Dikkat Edilecekler

> **Test kipinde para tahsil edilmez**
> 
> **Test Modu** işaretliyken yapılan ödeme faturayı ödendi yapar ve siparişi aktifleştirir, ama hiç para geçmez. Canlı anahtarları girdiğiniz anda işareti kaldırın. Anahtar alanları da size ait olmayan örnek sandbox değerleriyle dolu gelir. Gerçek para almadan önce ikisini de değiştirin.

> **İade iyzico'ya gitmez**
> 
> Fatura ekranında **Ödeme altyapısı ile iade** seçeneği bu modülde kapalıdır. Panel **Mevcut ödeme altyapısı otomatik iade desteklemiyor.** uyarısını gösterir. İadeyi **Gider olarak ekle** ya da **Hesap kredisine ekle** ile kaydedin, parayı iyzico panelinizden siz geri gönderin.

> **İki iyzico modülü birbirine benzer**
> 
> Ödeme adımında V2 **iyzico ile öde**, eski modül **Kredi Kartı** adıyla listelenir. İki iyzico satırı yan yana durur; birini açın. **Kredi Kartı (iyzico)** adı fatura kaydında ve bildirimlerde görünür.

> **Dönüşün faturayı kapattığını doğrulayın**
> 
> iyzico müşteriyi siteye başka bir alan adından gönderir. Bu sürüm ödeme anahtarını tarayıcı oturumunda arar, o istek ise oturumu taşımaz. Para çekilmişken fatura açık kalabilir. Yönteme güvenmeden önce iyzico işlemlerinizi açık faturalarınızla karşılaştırın.

## Gerekli Yetkiler

**Ödeme Modülü Ayarları** (`MODULES_PAYMENT_SETTINGS`) yetkisi gerekir.

## İlgili Makaleler

- [Ödeme Ağ Geçitleri](https://docs.wisecp.com/tr/odeme-modulleri)
- [Fatura Detayı](https://docs.wisecp.com/tr/fatura-detayina-genel-bakis)
- [Modül Yönetimi](https://docs.wisecp.com/tr/modul-yonetimi)