iyzico Entegrasyonu: Sitenize Online Ödeme Eklemek

Sitenizde ürün ya da hizmet satmak istiyorsunuz, ama kendi bankanızla sanal POS sözleşmesi yapmak, teknik belgelerle uğraşmak gözünüzü korkutuyor. Bu noktada birçok işletmenin aklına ilk gelen seçeneklerden biri ödeme kuruluşları oluyor. iyzico entegrasyonu, sitenize kartlı ödeme eklemenin yaygın yollarından biridir: müşteri kart bilgilerini güvenli bir ödeme ekranına girer, ödeme onaylanır ve siparişiniz otomatik olarak işlenir. Bu yazıda entegrasyonun teknik olarak nasıl işlediğini, hangi adımlardan geçtiğini ve nelere dikkat etmeniz gerektiğini anlatıyorum.

iyzico nasıl çalışır?

iyzico, işletmeler adına kartlı ödemeleri tahsil eden lisanslı bir ödeme kuruluşudur. Siz doğrudan bir bankayla sanal POS anlaşması yapmak yerine iyzico ile çalışırsınız; tahsilat, kart doğrulama ve dolandırıcılık kontrolleri onların altyapısında yürür. Bankayla doğrudan çalışmanın farklarını genel hatlarıyla sanal POS entegrasyonu yazısında anlattım; burada iyzico özelinde teknik akışa odaklanıyorum.

Komisyon oranları, ödeme vadeleri ve başvuru şartları zaman içinde değişebildiği için bu yazıda rakam vermiyorum. Güncel koşulları mutlaka iyzico’nun kendi sitesinden kontrol edin.

iyzico entegrasyonu adım adım

Teknik tarafta tipik bir entegrasyon şu aşamalardan oluşur:

Üye işyeri başvurusu: İşletme bilgileriniz ve belgelerinizle başvuru yapılır, onay sonrası canlı ortam anahtarları verilir.
Test (sandbox) ortamı: Gerçek para hareketi olmadan, test kartlarıyla tüm senaryolar denenir. Geliştirme her zaman burada başlar.
Ödeme yönteminin seçilmesi: Hazır ödeme formu ya da kendi tasarladığınız ödeme sayfası (API ile doğrudan) tercih edilir.
Sepet ve müşteri bilgilerinin gönderilmesi: Tutar, ürünler, alıcı ve fatura bilgileri ödeme isteğine eklenir.
3D Secure doğrulaması: Müşteri bankasının ekranında SMS kodu gibi bir doğrulama yapar.
Sonucun doğrulanması: Ödeme sonucu sunucu tarafında iyzico’dan teyit edilir ve sipariş ancak bundan sonra “ödendi” olarak işaretlenir.
Canlıya geçiş: Test anahtarları canlı anahtarlarla değiştirilir, küçük tutarlı gerçek bir işlemle son kontrol yapılır.

Hazır ödeme formu mu, API ile özel sayfa mı?

Ölçüt	Hazır ödeme formu	API ile özel ödeme sayfası
Kart bilgisi nerede girilir?	iyzico’nun güvenli formunda	Sizin sayfanızda, API üzerinden iletilir
Güvenlik yükü	Daha düşük	Daha yüksek; kart verisinin hiç saklanmaması şart
Tasarım esnekliği	Sınırlı	Tam
Geliştirme süresi	Daha kısa	Daha uzun

Çoğu küçük ve orta ölçekli işletme için hazır ödeme formu yeterli ve daha güvenli bir başlangıçtır. Ödeme ekranının tasarımı satış oranını doğrudan etkilediği için bu konuyu e-ticaret ödeme sayfası yazısında ayrıca ele aldım.

WooCommerce mi, özel yazılım mı?

WooCommerce kullanıyorsanız iyzico’nun resmi eklentisiyle temel kurulum görece hızlı yapılır. Yine de her hazır kurulum, sizin iş akışınıza tam oturmayabilir. Örneğin siparişin stok, kargo veya muhasebe sistemine aktarılması, taksit seçeneklerinin ürün grubuna göre gösterilmesi ya da kampanyalı fiyatların doğru iletilmesi ek geliştirme isteyebilir.

Özel bir yazılımda, rezervasyon sisteminde veya üyelik sitesinde ise entegrasyon doğrudan API ile yazılır. Burada sipariş oluşturma, ödeme başlatma, sonucu doğrulama ve iade akışları sizin sisteminize göre kurgulanır. Düzenli tahsilat gerekiyorsa abonelik ödeme sistemi kurgusu da ayrıca planlanmalıdır.

Ödeme onaylandıktan sonra ne olmalı?

Entegrasyonu yalnızca “para hesaba geçsin” diye düşünmek eksik kalır. Asıl verim, ödeme onayının ardından gelen işlerin kendiliğinden yürümesiyle gelir. Örnek bir senaryo düşünelim: bir yöresel ürün mağazası gece yarısı üç sipariş alıyor. Sabah dükkânı açan çalışan, hangi siparişin ödendiğini panelde net görmeli; müşteri de ödeme anında onay e-postasını almış olmalı.

Sipariş durumunun güncellenmesi: Doğrulanan ödeme, siparişi otomatik olarak “hazırlanıyor” aşamasına taşır.
Stok düşümü: Satılan ürün stoktan düşülür, aynı ürünün ikinci kez satılması engellenir.
Bildirimler: Müşteriye onay e-postası veya SMS, işletmeye yeni sipariş bildirimi gider.
Fatura ve muhasebe: Gerekirse sipariş bilgileri e-fatura veya muhasebe sistemine aktarılır.

Sık yapılan teknik hatalar

Sonucu yalnızca tarayıcı yönlendirmesine güvenerek işlemek: Müşteri ödeme sonrası sitenize döndüğünde gelen bilgiyi doğrulamadan siparişi onaylamak, sahte onaylara kapı açar. Sonuç mutlaka sunucudan iyzico’ya sorularak teyit edilmelidir.
Tutarı tarayıcıdan almak: Ödenecek tutar her zaman sunucuda, veritabanındaki sepetten hesaplanmalıdır.
Bağlantı kopmasını düşünmemek: Müşteri ödemeyi tamamlayıp sayfayı kapatırsa sipariş askıda kalmamalı; bildirim (callback/webhook) akışı bu durumu yakalamalıdır.
API anahtarlarını kodun içine gömmek: Anahtarlar sunucuda gizli ayar dosyasında tutulmalı, sürüm kontrolüne eklenmemelidir.
İade ve iptal akışını unutmak: İadeyi panelden elle yapmak mümkündür, ama siparişle eşleşmezse muhasebe karışır.
Yasal sayfaları atlamak: Mesafeli satış sözleşmesi ve iade koşulları gibi metinlerin sitede bulunması ödeme kuruluşları tarafından da beklenir.

Bu işi nasıl birlikte yaparız?

Sitenize iyzico ile ödeme eklemek istiyorsanız süreci genellikle şu adımlarla yürütüyorum:

İhtiyacı netleştirme: Ne sattığınızı, sitenizin altyapısını, taksit ve iade ihtiyacınızı ve siparişin sonradan nereye aktarılacağını konuşuyoruz.
Yöntem seçimi ve teklif: Hazır form mu özel sayfa mı, eklenti mi doğrudan API mi kararını birlikte verip kapsamı yazılı hâle getiriyorum.
Test ortamında geliştirme: Başarılı, reddedilen, yarıda kalan ve iade edilen ödeme senaryolarının hepsini test kartlarıyla deniyorum.
Canlıya geçiş ve destek: Canlı anahtarlarla küçük bir gerçek işlem yapıp siparişin doğru işlendiğini birlikte kontrol ediyor, sonrasında destek veriyorum.

Başvuru aşamasında olmanız ya da hangi ödeme kuruluşunu seçeceğinizi henüz bilmemeniz sorun değil; iletişim sayfasından yazmanız yeterli.

Sık sorulan sorular

iyzico entegrasyonu için şirket kurmam gerekir mi?

Başvuru şartları işletme türüne göre farklılık gösterebilir ve zaman içinde değişebilir. Güncel şartları iyzico’nun sitesinden veya müşteri hizmetlerinden öğrenmenizi öneririm.

Kart bilgileri benim sunucumda saklanır mı?

Hazır ödeme formunda kart bilgileri sizin sunucunuza hiç gelmez. API ile özel sayfa yapılsa bile kart bilgisi hiçbir koşulda veritabanında saklanmamalıdır.

Mobil uygulamada da iyzico kullanılabilir mi?

Evet, mobil uygulamalarda da ödeme akışı kurulabilir. Ancak dijital içerik satışında uygulama mağazalarının kendi ödeme kuralları devreye girebileceği için ürün türüne göre değerlendirme yapmak gerekir.

Entegrasyon ne kadar sürer?

Süre; site altyapısına, hazır form mu özel sayfa mı seçildiğine ve sipariş sonrası aktarılacak sistemlere göre değişir. Başvurunun onay süresi de takvime eklenmelidir.

Sonuç

iyzico entegrasyonu doğru kurulduğunda müşterileriniz güvenle ödeme yapar, siparişleriniz kendiliğinden işlenir; kritik nokta ödeme sonucunu sunucuda doğrulamak ve tüm senaryoları test ortamında denemektir. Sitenize online ödeme eklemeyi planlıyorsanız bana ulaşabilirsiniz.