iyzico

Gereken bilgiler

iyzico Yönetim Paneli → Ayarlar → API anahtarları:

• api_key
• secret_key

Panelinizde Ayarlar → Ödemeler → Yöntem ekle → iyzico seçin, iki değeri girin.

Sandbox: iyzico'nun test ortamı için sandbox-… ile başlayan anahtarları girin ve sandbox (test) modu kutusunu işaretleyin; panel istekleri sandbox-api.iyzipay.com'a gönderir. Canlıya geçerken canlı anahtarları girip kutuyu kaldırın.

Callback adresi her ödemeye otomatik eklenir; iyzico panelinde ayrıca bir ayar gerekmez. Adres kalıbı:

https://<panel-alan-adınız>/payments/iyzico/callback

Akış

1. Müşteri tutarı ve telefon numarasını girer, iyzico'yu seçer. (Telefon iyzico'nun zorunlu alanıdır.)
2. iyzico'nun barındırdığı ödeme sayfasına yönlendirilir; kart bilgisi ve 3D Secure orada, sizin sunucunuza kart verisi hiç uğramaz.
3. Ödeme bitince iyzico müşterinin tarayıcısını panelinize geri gönderir. Bu dönüşte yalnız bir token vardır ve tek başına güvenilmez.
4. Panel, token'ı sunucudan sunucuya imzalı bir istekle iyzico'ya sorar (retrieve). iyzico SUCCESS derse ve sepet numarası bizim ödememizse bakiye yüklenir; müşteri "Bakiye yükle" sayfasına başarı mesajıyla döner.
5. Sonuç FAILURE ise ödeme "başarısız" olarak kaydedilir, iyzico'nun hata mesajı ödeme notuna yazılır.

Aynı token için ikinci dönüş yok sayılır; bakiye iki kez yüklenmez.

Dolandırıcılık incelemesi

iyzico bazı ödemeleri incelemeye alır (fraudStatus = 0). Böyle bir ödeme panelde beklemede görünür ve bakiye yüklenmez; iyzico onayladığında (yönetim panelinden ya da webhook ile) Admin → Ödemeler'den tamamlayabilirsiniz. Reddedilen ödeme (-1) başarısız sayılır.

Para birimleri

iyzico TRY, USD, EUR, GBP, NOK ve CHF kabul eder. Panelinizin para birimi bunlardan biri olmalı; iyzico'nun kabul etmediği bir birimde ödeme başlatılamaz.

Sitedeki zorunlu sayfalar (iyzico gereklilikleri)

iyzico sanal POS başvurusu URL bazlı değerlendirilir: başvurduğunuz alan adında belirli bilgilerin yayında olması istenir. Yöntem eklerken "iyzico gerekliliklerini siteye ekle" kutusunu işaretlediğinizde panel bunları kendisi yayına alır:

Sayfa	Adres
Hakkımızda	/about
İletişim	/contact
Teslimat ve İade	/delivery-refund
Mesafeli Satış Sözleşmesi	/distance-sales
Kullanım Koşulları	/terms (kutu kapalıyken de yayında)
Gizlilik Politikası	/privacy (kutu kapalıyken de yayında)

Ayrıca sitenin altına iyzico'nun kendi footer bandı eklenir: "iyzico ile öde" logosu ile Troy, American Express, Visa ve Mastercard markaları. Bu bant, temanızın footer.html dosyasını düzenlemiş olsanız bile görünür; başvuru şartı tema ayarına bağlı kalmasın diye tema dosyasının dışında basılır.

SSL için bir şey yapmanız gerekmez: panel alan adları yalnızca HTTPS üzerinden sunulur ve sertifika otomatik alınır.

Şirket bilgilerini doldurun

Dört sayfanın varsayılan metni satıcı kimliğinizden dolar. Görünüm → Yasal altındaki Şirket bilgileri bloğuna ünvan, adres, telefon, vergi dairesi/no ve (varsa) MERSİS numarasını girin. Girmediğiniz alan metne hiç basılmaz; ünvan, adres ve telefon eksikse sayfada uyarı görürsünüz, çünkü iyzico bu üçünü arar.

Metinler hazır gelir ve Markdown olarak düzenlenebilir. Bir kutuyu boşaltıp kaydederseniz otomatik metin yeniden yayımlanır. Bu şablonlar hukuki tavsiye değildir; yayımlamadan önce kendi durumunuza göre gözden geçirin.

Kutuyu kaldırırsanız dört sayfa yayından çıkar (404) ve bant kaybolur; yazdığınız metinler saklı kalır.

Altyapı etiketi (payment source)

Her ödeme isteğinde paymentSource alanı HUGOSOFTWARE olarak gönderilir. Bu, iyzico'nun ödemeyi hangi e-ticaret altyapısının başlattığını görmesi için iş ortaklığı kapsamında tanımlanmış etikettir; sizin yapmanız gereken bir şey yoktur. iyzico bu değeri kendi tarafında tanımlamadan önce canlıda kullanırsanız istek hata dönebilir, o yüzden ilk denemeyi sandbox'ta yapın.

Sık sorunlar

• "callbackUrl gönderilmesi zorunludur" / SSL hatası: iyzico callback adresinin geçerli bir SSL sertifikası olmasını ister; panelinizin alan adı henüz bize yönlenmediyse ödeme başlatılamaz. Önce DNS devrini tamamlayın.
• Sandbox'ta kart reddediliyor: iyzico'nun test kartlarını kullanın (dokümandaki "Test Cards" listesi); gerçek kart sandbox'ta çalışmaz.
• Ödeme başarılı ama bakiye yok: Admin → Ödemeler'de kaydın notuna bakın. Retrieve çağrısı hata verdiyse (anahtar yanlış, sandbox/canlı karışmış) not orada.