Türkiye ödeme entegrasyonu

CreativeCode+iyzico

Türkiye'nin en yaygın ödeme altyapısı. Kredi kartı, banka kartı, taksit ve havale/EFT desteğiyle web sitesi veya mobil uygulamanıza 3-7 iş günü içinde entegre edilir.

Hızlı cevap

iyzico entegrasyonu web veya mobil uygulamaya kredi kartı, banka kartı, taksit ve havale ödeme imkânı katar. PCI-DSS Level 1 uyumlu, 3D Secure destekli, KVKK uyumlu. Kurulum 3-7 iş günü; aylık maliyet ciro bazlı komisyon.

Kurulum maliyeti

10.000 – 30.000 TL (entegrasyon geliştirme)

Aylık

iyzico komisyon: %2.85 + 0.25 TL / işlem (standart); taksitli işlemlerde banka komisyonu eklenir

Süre

3-7 iş günü

Kim için doğru

→E-ticaret sitesi veya marketplace: kart + taksit

→SaaS ürün aboneliği: otomatik yenileme (iyzico Subscription)

→Randevu / hizmet öncesi ön ödeme alma

→Mobil uygulama içi ödeme (iOS + Android)

Veri akışı

Kullanıcı → Ödeme formu (iyzico Checkout veya custom form) → iyzico API → Banka/kart ağı → iyzico webhook → Uygulama backend → Sipariş onay

Kurulum adımları

01
iyzico hesabı ve API anahtarları
iyzico Merchant Panel'den sandbox ve production API key + secret key alma.
02
SDK veya REST API seçimi
PHP, Node.js, Python, Java veya .NET SDK; alternatif olarak doğrudan REST API.
03
Checkout formu kurulumu
iyzico Checkout (iframe) veya özel kart formu; 3D Secure zorunlu.

Webhook yapılandırması

Ödeme sonucu bildirimleri için webhook endpoint tanımla; başarı/başarısız/iptal akışları.

// Webhook doğrulama örneği
const hash = crypto.createHmac('sha256', secretKey)
  .update(body)
  .digest('base64');
if (hash !== req.headers['x-iyz-signature']) throw new Error('Invalid');

05
Taksit ve kampanya ayarları
Banka bazlı taksit yapılandırması; belirli kart/banka için taksit kısıtlama veya artırma.
06
Test + canlıya geçiş
Sandbox test kartlarıyla 20+ ödeme senaryosu testi; production anahtarları ile canlıya alma.

Sık karşılaşılan tuzaklar

Sandbox anahtarlarını production'a taşımayı unutma
3D Secure olmadan kart saklama PCI ihlali
Webhook'suz ödeme → sipariş senkronizasyon hatası
Taksit tutarsızlığı: kullanıcı 12 taksit seçti, sipariş 1 taksit kaydedildi
KVKK: kart bilgisi sunucuda saklanmamalı — iyzico token kullan

Sıkça sorulan sorular

iyzico hangi ödeme yöntemlerini destekler?

Kredi kartı, banka kartı, taksit (3-12 ay), havale/EFT ve BKM Express. Dijital cüzdan desteği kısıtlıdır.

iyzico mi PayTR mi?

iyzico: daha iyi geliştirici deneyimi, zengin SDK, taksit yönetimi güçlü. PayTR: komisyon biraz düşük, sanal POS seçenekleri geniş. İkisi de Türkiye'nin önde gelen ödeme altyapılarıdır.

iyzico Subscription ile abonelik otomasyonu nasıl çalışır?

Kart token'ı iyzico'da saklanır; belirlenen periyotta (aylık, yıllık) otomatik çekim yapılır. Çekim başarısız olursa webhook ile bildirim gelir, retry mantığı yazılır.