Türkiye E-Ticaret Entegrasyon Rehberi: Trendyol, iyzico, Kargo ve e-Fatura

Türkiye'de e-ticaret mağazası kurmak, Shopify hesabı açıp ABD ödeme ağ geçidine yönlendirmekle aynı şey değildir. Yerel ekosistemin kendi kuralları, kendi baskın oyuncuları ve atlayamayacağınız kendi entegrasyonları var. Yeni açıyorsanız — ya da mevcut platformunuz bunları kötü yönetiyorsa — pratik harita bu.

Dört Temel Sütun

Türkiye e-ticaret başarısı dört entegrasyon sütununa dayanır. Birini yanlış yaparsanız ya müşteri ya nakit kaybedersiniz.

1. Pazaryeri senkronizasyonu — çünkü hacminizin büyük kısmı kendi sitenizde olmayacak.
2. Yerel ödeme sağlayıcıları — çünkü Türk alışverişçiler taksit ve yerel kartları bekler.
3. Kargo firmaları — çünkü teslimat beklentileri spesifiktir ve "kargo bedava" burada farklı anlamlara gelir.
4. e-Fatura — çünkü yasa; nice-to-have değil.

Tek tek ele alalım.

Pazaryeri Senkronizasyonu: Trendyol, Hepsiburada, N11

Çoğu batılı pazarda DTC markaları pazaryerlerini yıllarca görmezden gelebilir. Türkiye'de genelde gelemez. Tek başına Trendyol, online perakende trafiğinin büyük bir kısmını alır; özellikle moda, ev ve güzellikte. Hepsiburada elektronik ve büyük ev eşyasında baskındır. N11 hâlâ anlamlı long-tail erişimine sahiptir.

İyi bir pazaryeri senkronizasyonu şunları halleder:

• Katalog push: ürün verilerini (başlık, görseller, açıklamalar, varyantlar) ana platformdan her pazaryerine, o pazaryerinin istediği spesifik alanlarla göndermek. Trendyol'un kategori ağacı Hepsiburada'dan farklıdır. Attribute gereksinimleri kategoriye göre değişir.
• Stok senkronizasyonu: gerçek zamanlı veya ona yakın stok güncellemeleri — fazla satış yapmamak için. Perakende mağazasının zaten sattığı bir üründe pazaryeri siparişi gelmesi kadar satıcı canını yakan az şey var.
• Fiyat ve kampanya kontrolü: kanal özel fiyatlandırma kuralları, pazaryeri komisyonları hesaba katılmış, Trendyol'un sık kampanyalarına otomatik katılım (veya katılmama).
• Sipariş alımı: pazaryeri siparişlerinin ana OMS'inize çekilmesi, böylece fulfillment birleşik olur. Pazaryeri siparişlerini ayrı bir silo yerine "başka bir kanal" olarak ele almak, ölçeğin kilidini açar.

Pazaryeri başına birkaç yüz SKU'yu geçince manuel yönetim iflas eder. Birkaç bin SKU'ya geldiğinizde proper bir sync katmanı tartışmasızdır.

Ödemeler: iyzico ve PayTR

Türk alışverişçiler çoğu küresel ödeme sağlayıcısının temiz biçimde sunmadığı iki şeyi bekler: taksit ve yerel kart tipleri (Bonus, Axess, World, Maximum, Paraf vs.). Stripe veya Adyen bunları teoride işleyebilir, ama iyzico ve PayTR tam olarak bunların etrafında inşa edilmiştir.

İyi bir ödeme entegrasyonu şöyledir:

• Taksit kampanyaları sepet düzeyinde eşlenmiş olmalı, hardcoded olmamalı. 2.000 TL'lik elektronik sepete atan bir alışverişçi, Bonus kartın 3 ay taksit teklifini bir geliştiricinin yeni kural yazmasına gerek kalmadan görmeli.
• 3D Secure doğru yapılmış olmalı — her yerde SCA, ama bankanın 3DS altyapısı çöktüğünde fallback akışlarıyla. Çok fazla Türk checkout'u 3DS adımında dönüşüm kaybediyor.
• Taksit farkındalıklı iadeler — taksitli siparişlerdeki kısmi iadelerin, muhasebe anında önemli olan kendine özgü mekanikleri vardır.
• Vaulting uygun tokenization ile — tekrar gelen müşterilerin kart bilgilerini yeniden girmemesi için.

Bir uyarı: frontend'de hesaplanan toplama asla güvenmeyin. iyzico'yu çağırmadan önce her zaman sunucu tarafında sepet içeriğine göre yeniden hesaplayın; callback'te ödenen tutarı sunucu tarafı toplamınızla doğrulayın. Para hareketi için hakikat kaynağı backend'dir. Opsiyonel değil.

Kargo: MNG, Yurtiçi, Aras, PTT

Türk son-kilometre pazarı parçalı bir pazar. MNG Kargo, Yurtiçi Kargo, Aras Kargo, PTT Kargo ve Sürat Kargo ana oyuncular; her birinin farklı güçlü yönleri var — coğrafi kapsam, ertesi gün erişim, büyük boy ürünler, entegrasyon kalitesi.

Sağlam bir kargo katmanı şunları sunar:

• Dinamik kargo seçimi ağırlık, boyut, varış ilçesi ve satıcı anlaşmalarına göre. Her kargo her köye hizmet vermiyor.
• API ile AWB (sevk irsaliyesi) oluşturma — kargo etiketini, kargocunun portalına sipariş verisi kopyalayarak değil, endpoint'ini çağırarak oluşturursunuz.
• Gerçek zamanlı durum takibi müşteri paneline geri yansıtılır. "Siparişim nerede?" sorusu, müşterinin kargocunun sitesini açmasını asla gerektirmemeli.
• Mutabakat — kargocular bazen teklif ettiklerinden farklı fatura keser. İyi entegrasyon bunları fatura düzeyinde yakalar.

İadelerin kendi tasarımına ihtiyacı var. Türk e-ticaretinde iade oranları küresel ortalamalarla kıyaslandığında yüksek; özellikle giyimde. Müşteri tarafında birkaç tıklamayla çalışan, zamanlanmış teslim alımı olan bir iade etiketi akışı, başka hiçbir tek yatırımın sağlamadığı kadar destek yükünü azaltır.

e-Fatura: GIB Uyum Yığını

e-Fatura ve e-Arşiv Fatura opsiyonel değil. Belli gelir eşiklerinin üzerinde ve belli işlem türlerinde, Gelir İdaresi Başkanlığı (GIB) sistemi üzerinden elektronik fatura kesmek zorundasınız. Kurallar gelişti — zorunlu e-Faturaya sokan eşikler son yıllarda düştü, ve giderek daha fazla işlem kategorisi kapsama alındı.

Düzgün bir e-fatura entegrasyonu şunları kapsar:

• Otomatik fatura kesimi sipariş onayında veya sevkiyatta (vergi yapınıza göre) doğru XML formatı ve UBL uyumu ile.
• GIB Portal ile entegrasyon doğrudan veya akredite entegratör aracılığıyla — entegratör rotası, operasyonel ölçek için genelde pragmatik seçim.
• Satıcının muhasebe sistemiyle bağlantı — Logo Tiger, SAP, Mikro, Luca — her fatura çift girişe gerek kalmadan ERP'ye akar.
• İade ve iptallerin ele alınışı — iade faturası ile, sessiz veritabanı güncellemeleriyle değil.

Son maddeyi atlayan küçük operasyonlar vergi dairesiyle başı belaya girer.

ERP Katmanı: Her Şeyin Birleştiği Yer

Belli bir noktanın üstünde ölçek aldığınızda ERP'niz (Logo, SAP, Mikro, Netsis, Luca) omurga haline gelir. Siparişler pazaryerlerinden ve kendi sitenizden gelir. Ödemeler iyzico ve PayTR üzerinden alınır. Kargo birden fazla firma üzerinden yürür. e-Faturalar GIB'e akar. Tüm bu olayların doğru KDV işlemesi, stok hareketleri ve müşteri kayıtlarıyla muhasebede bir yere düşmesi gerekiyor.

Türk pazarı için modern bir e-ticaret platformu, ERP bağlantısını birinci sınıf vatandaş olarak ele almalı, sonradan eklenen bir şey olarak değil. Tek yönlü sync yetmez — ERP'nin fiyat güncellemelerini, stok düzeltmelerini ve fatura durumunu vitrine geri itmesi gerekir.

Son %10'u Hafife Almayın

Tüm bunların kolay kısmı API dokümantasyonu. Trendyol'un dokümanları var. iyzico'nun dokümanları var. MNG'nin dokümanları var. GIB spec yayımlıyor. Temel entegrasyonu inşa etmek yapılabilir.

Zor kısım — ve çoğu satıcının platform değiştirmesinin nedeni — son %10: mutabakat istisnaları, kargocuya özel büyük boy kuralları, fiyatlandırma mantığınızı bozan Trendyol kampanyası, müşterinin bankası yavaşken gelmeyen iyzico webhook'u, zirve satış günlerindeki GIB kesintisi.

Türk pazarı için özellikle inşa edilmiş platformlar bu kurumsal bilgiyi kodlarında taşır. Üstüne "Türkiye adaptörü" monte edilmiş generic platformlar genelde taşımaz. Opsiyon değerlendirirken, platformun sadece mutlu yolları değil, hata durumlarını nasıl ele aldığını kurcalayın.

2026 için Başlangıç Noktası

Bu yıl açıyor veya platform değiştiriyorsanız, taban yığın şöyle görünüyor:

• Çok kiracılı, çoklu mağaza operasyonlarına birinci sınıf destek veren ana platform
• İlk günden Trendyol + Hepsiburada sync, kategoriniz için anlamlıysa N11
• Birincil gateway olarak iyzico, ikincil olarak PayTR (Black Friday ölçeğinde sağlayıcı yedekliliği önemli)
• En az iki kargo firması otomatik devreye alma ile
• Akredite e-Fatura entegratörü, doğrudan ERP bağlantısı
• Sunucu tarafı sipariş ve ödeme doğrulaması — her zaman

Bunları doğru kurun, e-ticaret operasyonunuzun geri kalanı sağlam bir zemine oturur. Atlayın, en kötü zamanda baskı altında yeniden inşa edersiniz.