E-Ticaret Ödeme Sistemleri Entegrasyonu: Türkiye'de Doğru Sağlayıcıyı Seçmek ve Entegre Etmek

Online mağazanızı kurdunuz, ürünlerinizi yüklediniz ve ilk trafiği almaya başladınız. Ancak müşteriler ödeme adımına gelince sepeti terk ediyor. Baymard Institute'un araştırmalarına göre ortalama sepet terk oranı yüzde yetmişi aşıyor; bunun en büyük nedenlerinden biri ödeme deneyimindeki sürtünmeler: zorunlu üyelik, az ödeme seçeneği, güven eksikliği ve beklenmedik maliyetler. Doğru ödeme sistemi entegrasyonu, bu sürtünmeleri birebir ortadan kaldırmanın en hızlı yoludur.

Türkiye'deki Başlıca Ödeme Sağlayıcıları Kimler?

TR pazarı, global platforlara kıyasla farklı bir ödeme ekosistemi barındırır. Mastercard ve Visa altyapısını kullansalar da yerel regülasyonlar, taksit kültürü ve bankalarla doğrudan anlaşma süreçleri yerel sağlayıcıları öne çıkarır.

• iyzico: Türkiye'nin en yaygın ödeme altyapılarından biri. Sanal POS başvuru sürecini büyük ölçüde basitleştiriyor, kapsamlı API ve hazır iframe entegrasyonu sunuyor. Küçük-orta ölçekli işletmeler için başlangıç noktası olarak sıkça tercih ediliyor.
• PayTR: Komisyon yapısı ve banka anlaşmaları açısından rekabetçi bir seçenek. Özellikle yüksek hacimli işlem yapan mağazalarda maliyet avantajı öne çıkıyor; hosted ödeme sayfası ve API seçenekleri mevcut.
• Param: BDDK lisanslı, taksit ve banka kampanyalarını tek çatıda yönetmeye olanak tanıyan bir platform. KDV faturalama entegrasyonu da sunan çözümleri var.
• Shopier: Özellikle bireysel satıcılar ve küçük işletmeler için hız avantajı sağlayan basitleştirilmiş bir ödeme köprüsü. Entegrasyon karmaşıklığı düşük.
• Banka Sanal POS (direkt): Garanti BBVA, İş Bankası, Yapı Kredi, Akbank gibi bankalardan direkt sanal POS almak, aracı komisyonunu ortadan kaldırır; ancak teknik entegrasyon ve başvuru süreci daha karmaşıktır. Aylık ciro hacmi yeterince yüksek mağazalar için karlı bir seçenek.
• Stripe (TR durumu): Stripe, Türkiye merkezli işletmelere ödeme kabul etme konusunda kısıtlı destek sunmaktadır; Türk bankaları ve taksit altyapısıyla tam entegrasyon sağlayamamaktadır. Global müşterilere satış yapan işletmeler için değerlendirilebilir ancak tek başına TR pazarı için yeterli değildir.

Hangi sağlayıcının size uygun olduğu; aylık işlem hacminize, hedef kitlenizin ödeme alışkanlığına, taksit gereksinimi ve teknik altyapınıza göre değişir. Komisyon oranları sağlayıcılar ve bankalar arasında dönemsel olarak değiştiğinden güncel rakamları her sağlayıcıdan doğrudan teyit etmeniz kritiktir — bu rehberde spesifik yüzde vermekten kaçınıyoruz.

Taksit ve 3D Secure: Türkiye'ye Özgü İki Kritik Gereklilik

Türkiye'de taksit, e-ticaret dönüşümünü doğrudan etkileyen kültürel bir norm haline gelmiştir. Alışveriş yapan tüketicinin önemli bir kısmı taksit seçeneği sunulmadığında satın almayı erteliyor ya da tamamen vazgeçiyor. Banka anlaşmalarına göre değişen taksit seçenekleri (3, 6, 9, 12 taksit gibi), vade farkı politikaları ve banka kampanyaları, ödeme sayfanızda görünür biçimde sunulmalıdır.

3D Secure (3DS) ise Türkiye'de yüksek tutarlı işlemlerde fiilen zorunlu olan bir güvenlik katmanıdır. Bankalar ve sağlayıcılar, belirli tutarın üzerindeki işlemleri 3DS olmadan otomatik reddedebilir. Entegrasyon sürecinde 3DS akışını hem başarılı hem hatalı senaryolar için test etmek, canlıya geçişten önce kritik bir adımdır. Ayrıca 3DS ekranının mobil uyumlu olduğundan emin olun — bu adımda kullanıcı arayüzü sorunları sepet terkini artırır.

Hosted Checkout mu, API/iFrame Entegrasyonu mu?

Ödeme sağlayıcısını seçtikten sonra ikinci büyük karar, entegrasyon yöntemidir. Her yöntemin güvenlik, kullanıcı deneyimi ve geliştirme maliyeti açısından farklı dengesi vardır.

• Hosted Checkout (yönlendirmeli): Kullanıcı ödeme sırasında sağlayıcının sayfasına yönlendirilir. Kart verisi hiçbir zaman sizin sunucularınıza uğramaz, PCI-DSS uyumu büyük ölçüde sağlayıcıya devredilir. Geliştirme süresi kısadır. Dezavantajı: marka sürekliliği kırılır, mobil cihazlarda ek bir yönlendirme adımı dönüşüm kaybına yol açabilir.
• iFrame / Popup Entegrasyonu: Ödeme formu mağazanızın kendi sayfasında bir iframe içinde çalışır. Kullanıcı sitenizden ayrılmaz, deneyim daha bütünlüklüdür. Kart verisi yine sağlayıcı altyapısında işlenir, ancak iframe'in güncel güvenlik standartlarına uygunluğunu (Content-Security-Policy, SameSite cookie) düzenli kontrol etmek gerekir.
• API Entegrasyonu (Direct API): Kart bilgileri frontend'den doğrudan sağlayıcının tokenization endpoint'ine gönderilir, tokenize değer sizenin backend'ine iletilir. En esnek deneyimi sunar; ancak PCI-DSS SAQ-A yerine daha kapsamlı uyumluluk gerektirebilir. Next.js veya özel storefront geliştiren ekipler için bu yöntemi sağlayıcının SDK'sı ve tokenization akışıyla birlikte uygulamak doğru yaklaşımdır.

Kural basit: hassas kart verisini (PAN, CVV) asla kendi sunucularınızda saklamayın, loglamayın. Tokenization bu sorunun çözümüdür — bir kez alınan kart verisi yerine ilerleyen işlemlerde kullanılabilecek bir token saklanır. Bu hem güvenliği hem müşteri deneyimini (kayıtlı kart ile tek tıkla ödeme) iyileştirir.

Webhook ile Sipariş Durumu Senkronizasyonu

Ödeme sağlayıcısının sonucu size bildirmesi için iki yöntem kullanılır: sayfa yönlendirmesi (callback URL) ve webhook. Callback URL, kullanıcı tarayıcısının sitenize dönmesini bekler — ancak kullanıcı sekmeyi kapatırsa ya da bağlantı kesilirse sipariş askıda kalabilir. Webhook ise sağlayıcının, ödeme sonucunu doğrudan sunucunuza gönderdiği sunucu-sunucu bir bildirimdir; tarayıcı durumundan bağımsız çalışır.

Sağlam bir entegrasyon her iki yöntemi birden uygular: callback URL ile anlık UI güncellemesi yapılır, webhook ile sipariş durumu kesin olarak teyit edilir. Webhook handler yazarken gelen payload'ın imzasını (HMAC veya sağlayıcıya özgü imza) doğrulamayı ihmal etmeyin; bu, sahte bildirimle sipariş durumunu manipüle etmeye karşı temel güvencedir.

Ödeme Adımında Dönüşümü Artıran Tasarım Kararları

Teknik entegrasyon tamamlandıktan sonra sepet terkinin azalması büyük ölçüde UX kararlarına bağlıdır. Baymard Institute'un kapsamlı kümülatif araştırması (birden fazla yıla yayılan çok sayıda çalışma), sepet terkinin en sık nedenlerini sistematik biçimde belgelemiştir: zorunlu hesap oluşturma, karmaşık checkout akışı, az ödeme seçeneği ve güvensiz görünen ödeme sayfası bunların başında yer alır.

• Misafir ödeme (guest checkout): Hesap oluşturmayı zorunlu kılmak, ilk satın alma kararını zorlaştırır. Misafir ödeme seçeneği sunun; satın alma sonrası hesap oluşturmayı teşvik edin.
• Tek-sayfa checkout (one-page checkout): Adres, kargo ve ödeme bilgilerini tek ekranda gruplandırmak, ilerleme algısını güçlendirir ve vazgeçme noktalarını azaltır.
• Dijital cüzdanlar (Apple Pay, Google Pay): Özellikle mobil kullanıcılar için ödeme formunu tamamen ortadan kaldıran bu yöntemler, önümüzdeki yıllarda TR pazarında da hızla yaygınlaşıyor.
• Güven sinyalleri: SSL kilidi, banka logoları, 3D Secure rozeti ve açık iade politikası bağlantısı ödeme sayfasında görünür olmalı.
• Kargo maliyetini erken gösterin: Sürpriz kargo ücreti, ödeme adımında en sık sepet terk nedenlerinden biridir. Ücreti sepet sayfasında ya da daha öncesinde gösterin.

E-ticaret mağazanızın ödeme akışı teknik mi, yasal mı yoksa UX açısından mı zayıf olduğunu bilmiyorsanız, ADWEBX'in ücretsiz site analizinden yararlanabilirsiniz. Analizimizde ödeme entegrasyonu, hız, güven sinyalleri ve dönüşüm darboğazlarını tek tek ele alıyoruz. Türkiye'de e-ticaret projesi geliştiren işletme sahipleriyle WhatsApp üzerinden de hızlıca görüşebiliriz.

Yasal Uyumluluk: Mesafeli Satış, İade ve E-Fatura

Türkiye'de e-ticaret yasal çerçevesi, ödeme altyapısıyla doğrudan kesişen birkaç kritik yükümlülük içerir. Mesafeli Sözleşmeler Yönetmeliği kapsamında tüketiciye 14 gün içinde cayma hakkı tanınmalı, iade ve iptal akışı sisteme entegre edilmelidir. Ödeme sağlayıcınızın iade API'si bu akışın teknik bileşenidir; iade talebini manuel yönetmek hem operasyonel maliyet hem müşteri memnuniyeti açısından sürdürülemez hale gelir.

e-Arşiv fatura ve belirli eşiğin üzerindeki satışlarda e-Fatura zorunluluğu, ödeme sisteminin ERP veya muhasebe yazılımıyla entegrasyonunu gerektirir. İyzico ve bazı diğer sağlayıcılar faturalama partnerleri aracılığıyla bu entegrasyonu kolaylaştırıyor; ancak seçtiğiniz yolun GİB mevzuatına uygunluğunu bir mali müşavirle teyit etmeniz gerekir. KDV oranı hesaplamaları da ürün kategorisine göre değiştiğinden platform ve ödeme altyapısının bu veriyi doğru taşıması önemlidir.

Güvenlik: SSL, Fraud Önleme ve Chargeback Yönetimi

Ödeme sayfasında SSL (HTTPS) zorunludur — hem Google sıralaması hem de tarayıcı güven sinyalleri açısından. Sertifikasız ya da karma içerik (mixed content) uyarısı veren sayfalarda ödeme tamamlanma oranı dramatik biçimde düşer. SSL'yi kurmak yeterli değil; sertifikanın süresi ve yenileme süreçleri düzenli takip edilmeli.

Fraud (dolandırıcılık) önleme, büyük ölçüde sağlayıcı tarafında yönetilir; ancak uygulama katmanında da dikkat edilmesi gereken noktalar vardır. Hız limiti (rate limiting) ve captcha koruması olmayan ödeme formları kart test saldırılarına açıktır. Chargeback (ödeme iptali) sürecinde sağlayıcının sunduğu kanıt sistemi ve itiraz mekanizmasını önceden anlayın; yüksek chargeback oranı hesabınızın askıya alınmasına yol açabilir.

Platform Farkları: WooCommerce, Shopify ve Özel Next.js Storefront

Ödeme entegrasyonunun karmaşıklığı, kullandığınız platforma göre önemli ölçüde değişir. WooCommerce için iyzico, PayTR ve Param'ın hazır eklentileri bulunuyor; kurulum görece hızlı, ancak eklenti güncellemeleri ve PHP versiyonu uyumluluğu sürekli gözetilmeli. Shopify'da ise Türk sağlayıcıların native desteği kısıtlı; Shopify Payments Türkiye'de aktif değil, bu nedenle üçüncü taraf ödeme gateway eklentileri veya Shopify Plus'ta özel entegrasyon gerekmektedir.

Özel geliştirilmiş Next.js storefront veya headless e-ticaret mimarisinde ise entegrasyon tamamen backend API katmanına dayanır. Bu durumda sağlayıcının REST API'si veya Node.js SDK'sı üzerinden sipariş-ödeme yaşam döngüsünü sıfırdan oluşturmanız gerekir. Doğru yapıldığında en esnek ve yüksek performanslı deneyimi sunar; ancak geliştirme süresi ve test kapsamı daha geniş tutuludur. ADWEBX, Next.js tabanlı özel e-ticaret projelerinde bu entegrasyonu baştan sona tasarlayıp hayata geçiriyor.

E-ticaret sitenizin ödeme altyapısını sıfırdan kuruyor veya mevcut entegrasyonunuzu iyileştirmek istiyorsanız, ADWEBX'in ücretsiz site analizinden yararlanabilirsiniz. 2009'dan bu yana İstanbul'da yüzlerce dijital projeye imza attık; ödeme entegrasyonundan SEO'ya, tasarımdan mağaza hızına kadar bütün katmanları birlikte değerlendiriyoruz. Analiz için adwebx.com.tr/analiz sayfasını ziyaret edebilir ya da WhatsApp üzerinden bizimle iletişime geçebilirsiniz.

Sık Sorulan Sorular

iyzico mu, PayTR mi, banka sanal POS mu seçmeliyim?

Yeni başlayan ya da orta hacimli mağazalar için iyzico veya PayTR'nin basitleştirilmiş başvuru süreci ve hazır entegrasyon araçları avantaj sağlar. Aylık işlem hacmi yükseldikçe banka sanal POS'u aracı komisyonunu ortadan kaldırarak daha karlı hale gelebilir; ancak başvuru ve teknik entegrasyon süreci daha uzundur. Her üç seçeneği de mevcut cironuz ve büyüme hedefinize göre bir mali danışmanla değerlendirmenizi öneririz.

3D Secure ödeme dönüşümünü düşürür mü?

3DS ek bir adım içerdiğinden teorik olarak dönüşüme negatif etkisi vardır; ancak Türkiye'de banka güvenlik gereklilikleri nedeniyle yüksek tutarlı işlemlerde pratikte zorunludur. 3DS ekranını mobil uyumlu, hızlı yüklenen ve net talimatlarla tasarlamak bu olumsuz etkiyi minimize eder. Sağlayıcıların sunduğu 3DS2 akışları, daha az müdahale gerektiren otomatik risk değerlendirmesiyle genel deneyimi iyileştiriyor.

PCI-DSS uyumu için ne yapmam gerekiyor?

Hosted checkout veya iframe entegrasyonu kullandığınızda kart verisi doğrudan sağlayıcı altyapısında işlenir; bu durumda PCI-DSS SAQ-A formunu doldurmanız genellikle yeterlidir ve süreç görece basittir. Kendi sunucularınız üzerinden kart verisi akışı söz konusuysa (direct API entegrasyonu) daha kapsamlı PCI-DSS uyumu gerekmektedir. Her durumda sağlayıcınızın uyumluluk kılavuzunu ve bir bilgi güvenliği uzmanının tavsiyesini takip edin.

Ödeme entegrasyonumda webhook kullanmak zorunlu mu?

Zorunlu değil, ancak güçlü şekilde tavsiye edilir. Yalnızca callback URL kullandığınızda kullanıcı ödeme sayfasından ayrılırsa sipariş durumu güncellenmeyebilir; bu durum hem müşteri deneyimi hem stok ve muhasebe senkronizasyonu açısından sorun yaratır. Webhook, sağlayıcıdan sunucunuza gelen güvenilir bir bildirim kanalıdır ve sipariş yönetim sisteminizin ödeme gerçekleştiğini kesin biçimde öğrenmesini sağlar.

Taksit seçeneği sunmak için ne yapmalıyım?

Taksit seçenekleri, ödeme sağlayıcınızın banka anlaşmalarına dayanır. iyzico, PayTR ve Param gibi sağlayıcılar taksit bilgisini ödeme formu üzerinden otomatik gösterir; ancak hangi bankaların kaç taksit sunduğunu, vade farkı politikasını ve banka kampanya dönemlerini sağlayıcı panelinizden takip etmeniz gerekir. Taksit seçeneklerini ödeme formundan önce ürün sayfasında da görünür kılmak, satın alma kararını hızlandırır.