İyzico Entegrasyonu: Web Sitenize Türk Kartı Desteği Nasıl Eklenir?

İyzico Nedir ve Neden Önemlidir?

İyzico, Türkiye'nin lider online ödeme altyapısıdır. Türk bankaları tarafından ihraç edilen kartların büyük çoğunluğuyla uyumludur ve 3D Secure desteği sunar. E-ticaret sitesi kuran her Türk girişimcinin gündeminde olan soru şudur: İyzico mu, Stripe mi? Türk kartlarından sorunsuz ödeme almak istiyorsanız İyzico zorunludur.

İyzico Entegrasyonu İçin Gerekenler

Entegrasyona başlamadan önce hazır olması gereken belgeler ve hesaplar:

• İyzico merchant hesabı (iyzico.com üzerinden başvuru, onay 1–3 iş günü)
• Vergi levhası ve ticaret sicil belgesi (bireysel ya da kurumsal)
• SSL sertifikası zorunlu — https olmayan site onaylanmaz
• API Key ve Secret Key (merchant panelinden alınır)
• Test ortamı için ayrı sandbox API anahtarları

Teknik Entegrasyon Adımları

Next.js tabanlı projelerde İyzico entegrasyonu şu adımları izler:

• iyzipay Node.js paketi kurulumu: npm install iyzipay
• API endpoint oluşturma: /api/payment/checkout — server-side çalışır, API anahtarları client'a açılmaz
• Checkout form token alınması (Initialize Payment isteği)
• İyzico form HTML'inin sayfaya render edilmesi
• Callback URL'de ödeme sonucunun doğrulanması (Retrieve Payment)
• Sipariş durumunun veritabanında güncellenmesi

Test Ortamı ve Canlıya Geçiş

İyzico sandbox ortamı gerçek kart numaralarını simüle eder. Geliştirme sürecinde tüm ödeme senaryoları (başarılı, başarısız, 3D Secure) test edilmelidir. Canlıya geçiş için merchant panel üzerinden 'production' API anahtarları alınır ve ortam değişkenleri güncellenir. İyzico'nun review süreci ortalama 2–3 iş günü sürer.

Stripe ile Birlikte Kullanım

Uluslararası müşteriniz varsa veya yabancı kart desteği gerekiyorsa İyzico tek başına yeterli değildir. Bu durumda Stripe + İyzico hibrit yapı kurulur: Türk kartları İyzico'ya, diğerleri Stripe'a yönlendirilir. Kart tipine göre otomatik yönlendirme, ödeme sayfasına müşteri deneyimini bozmadan entegre edilebilir.

Sık Karşılaşılan Sorunlar

Gerçek projelerde en çok karşılaştığımız İyzico entegrasyon sorunları:

• Callback URL ayarı eksik — ödeme sonucu sitenize ulaşmaz
• SSL sertifikası geçersiz veya self-signed — İyzico bağlantıyı reddeder
• API anahtarları production/sandbox karışıklığı
• 3D Secure sonrası sipariş durumu güncellenmemesi
• Abonelik (recurring payment) için ayrı İyzico Subscription API entegrasyonu gerekir

Sık Sorulan Sorular