Magento Sanal POS ve Ödeme Entegrasyonu (Türkiye)

Türkiye’de satış yapan bir Magento 2 mağazası için ödeme altyapısı, yurt dışındaki örneklerden farklı ihtiyaçlar taşır: taksitli satış, 3D Secure doğrulaması, yerel kartlar ve TL tahsilat. Magento’nun çekirdeğinde bu ihtiyaçları karşılayan hazır bir Türk ödeme yöntemi bulunmaz; bağlantı bir ödeme modülüyle kurulur. Bu yazıda Magento sanal POS entegrasyonunu; ödeme kuruluşları ile banka sanal POS’ları arasındaki farkı, iyzico ve PayTR modüllerini ve dikkat edilmesi gereken teknik noktaları anlatıyoruz.

Ödeme altyapısı, e-ticaret sitesinin yasal yükümlülükleriyle de bağlantılıdır. Satış sözleşmesi ve iade koşulları için mesafeli satış sözleşmesi ve yasal metinler yazımıza göz atabilirsiniz.

Sanal POS nedir, Magento’da nasıl çalışır?

Sanal POS, internet üzerinden kartlı ödeme almanızı sağlayan hizmettir. Müşteri ödeme sayfasında kart bilgisini girer, işlem bankaya veya ödeme kuruluşuna iletilir, onay gelirse sipariş oluşur. Magento tarafında bu süreci yöneten şey bir ödeme yöntemi modülüdür. Modül şunları yapar:

• Ödeme sayfasında yöntemi ve gerekirse taksit seçeneklerini gösterir.
• Sipariş tutarını ve müşteri bilgilerini ödeme sağlayıcısına güvenli biçimde iletir.
• 3D Secure doğrulaması için müşteriyi bankanın doğrulama sayfasına yönlendirir veya bu sayfayı bir çerçeve içinde açar.
• Sağlayıcıdan gelen sonucu (başarılı, başarısız, iptal) Magento siparişine işler.
• İade ve iptal işlemlerinin panelden yapılmasını sağlar (modülün desteklemesi halinde).

Ödeme kuruluşu mu, banka sanal POS’u mu?

Türkiye’de iki ana yol vardır. Hangisinin uygun olduğu cironuza, şirket yapınıza ve operasyonel tercihlerinize bağlıdır.

Komisyon oranları ve para aktarım vadeleri sık değiştiği için bu yazıda rakam vermiyoruz. Güncel tutarları sağlayıcınızdan yazılı olarak alın ve teklifleri aynı varsayımlarla (ortalama sepet, taksit oranı, aylık hacim) karşılaştırın.

Pek çok mağaza iki yolu birlikte kullanır: başlangıçta ödeme kuruluşuyla hızlı açılış, hacim büyüdükçe bir veya daha fazla banka sanal POS’u ekleyerek maliyet optimizasyonu. Birden fazla POS kullanırken kart tipine veya taksit sayısına göre işlemi en uygun POS’a yönlendiren yapılar da kurulabilir; bu genellikle ek bir modül veya ödeme orkestrasyon hizmeti gerektirir.

Magento iyzico entegrasyonu

iyzico, Magento 2 için resmi bir ödeme modülü sunuyor. iyzico’nun geliştirici dokümantasyonunda modülün indirilmesi, app/code/Iyzico/Iyzipay klasörüne kopyalanması ve Magento komutlarıyla etkinleştirilmesi adım adım anlatılıyor; modülün kaynak kodu iyzico’nun GitHub hesabında yayımlanıyor. Kurulumun özeti şöyledir:

1. iyzico üye işyeri panelinden API anahtarı ve gizli anahtarı alın.
2. Modül dosyalarını Magento’nun ilgili klasörüne yerleştirin.
3. Modülü etkinleştirip setup:upgrade, statik içerik üretimi ve derleme komutlarını çalıştırın.
4. Yönetim panelinde ödeme yöntemleri bölümünde iyzico ayarlarını açın; önce test (sandbox) modunda deneyin.
5. Test siparişleriyle başarılı, başarısız ve iptal senaryolarını doğrulayın, ardından canlı moda geçin.

Taksit gösterimi, kayıtlı kart ve diğer özelliklerin modülün kullandığınız sürümünde nasıl desteklendiğini iyzico dokümantasyonundan ve test ortamından teyit edin. Modül sürümleri zaman içinde güncellendiği için kurulumdan önce GitHub üzerindeki son sürümü kontrol etmek faydalıdır. Kurulumu önce test ortamında yapın.

Magento PayTR entegrasyonu

PayTR da Magento 2 için resmi bir modül sunuyor. PayTR’nin geliştirici sayfasına göre modül Magento 2.3.x ve 2.4.x sürümlerini destekliyor ve Composer ile kuruluyor; aynı modül Adobe Commerce Marketplace’te PayTR tarafından yayımlanmış olarak da listeleniyor. Kurulumdan sonra yönetim panelinde şu ayarlar yapılır:

• Mağaza numarası ve PayTR’den alınan anahtar bilgileri.
• Test ve canlı mod seçimi.
• Bildirim adresi (callback URL): Panelde gösterilen adresin PayTR mağaza ayarlarındaki ilgili alana girilmesi gerekir. Bu adım atlanırsa ödeme alınsa bile sipariş durumu güncellenmeyebilir.
• Ödeme yönteminin ödeme sayfasındaki görünüm ayarları.

PayTR’nin havale/EFT ile ödeme için ayrı bir Magento modülü de Marketplace’te yer alıyor. Kullanmak istediğiniz yöntemlerin sözleşmenizde açık olduğunu kontrol edin.

Magento taksit seçenekleri nasıl gösterilir?

Türkiye’de taksit, dönüşüm oranını etkileyen önemli bir unsurdur. Magento mağazalarında taksit bilgisi genellikle iki yerde gösterilir:

1. Ürün sayfası: “Peşin fiyatına X taksit” veya banka bazlı taksit tablosu. Bu tablo ödeme modülünden veya ayrı bir taksit eklentisinden beslenir.
2. Ödeme sayfası: Kart numarasının ilk haneleri girildiğinde kartın bankasına göre geçerli taksit seçenekleri ve vade farkı gösterilir.

Taksit kurgusunda dikkat edilmesi gerekenler:

• Vade farkını kim üstleniyor? Müşteriye mi yansıtılacak, yoksa siz mi karşılayacaksınız? Bu karar fiyatlandırmanızı doğrudan etkiler.
• Kategoriye göre taksit sınırları: Bazı ürün gruplarında taksit sayısına yasal sınırlamalar uygulanabilir. Güncel düzenlemeyi ödeme sağlayıcınızdan ve mali müşavirinizden teyit edin.
• Tutarlılık: Ürün sayfasında gösterilen taksit ile ödeme sayfasında sunulan taksit aynı olmalı; aksi halde müşteri güveni zedelenir.

3D Secure ve güvenlik

3D Secure, kart sahibinin bankası tarafından ek doğrulama (genellikle SMS ile tek kullanımlık şifre) yapılmasını sağlar. Türkiye’de sanal POS işlemlerinde yaygın olarak kullanılır ve sahte işlem riskini azaltır. Magento tarafında dikkat edilmesi gereken güvenlik konuları şunlardır:

• Kart bilgisi sizin sunucunuzda tutulmamalı: Kart bilgisinin doğrudan sağlayıcının sayfasında veya çerçevesinde (iframe) girildiği çözümler, PCI DSS uyum yükünüzü ciddi biçimde azaltır.
• Callback doğrulaması: Sağlayıcıdan gelen ödeme sonucunun imza (hash) kontrolüyle doğrulanması gerekir; aksi halde sahte “ödeme başarılı” bildirimleriyle sipariş oluşturulabilir.
• İçerik güvenlik politikası (CSP): Magento 2.4 sürümlerinde ödeme sayfası için daha sıkı CSP kuralları uygulanır. Sağlayıcının script ve çerçeve adreslerinin izin listesine eklendiğinden emin olun; aksi halde ödeme formu açılmayabilir.
• Güncel modül: Ödeme modülünü güncel tutun ve Magento güvenlik yamalarını düzenli uygulayın. Ödeme sayfasına müdahale eden saldırılar (kart bilgisi çalan zararlı scriptler) çoğunlukla güncellenmemiş sistemlerde görülür.

Magento ödeme modülü seçerken kontrol listesi

1. Modül, kullandığınız Magento 2 sürümüyle uyumlu mu?
2. Kullandığınız temayla (Luma, Hyvä veya özel tema) ve ödeme sayfasıyla çalışıyor mu?
3. Taksit, 3D Secure, iade ve kısmi iade işlemlerini destekliyor mu?
4. Ödeme sonucu bildirimi (callback) güvenli şekilde doğrulanıyor mu?
5. Hata durumunda kayıt (log) tutuluyor mu, sipariş ve ödeme eşleşmesi raporlanabiliyor mu?
6. Çoklu web sitesi veya mağaza görünümü yapınızda farklı POS kullanmak mümkün mü?
7. Modülün kaynak kodu erişilebilir mi, son güncelleme ne zaman yapılmış?

Canlıya almadan önce test senaryoları

Ödeme, sitenin en kritik akışıdır. Canlıya almadan önce test ortamında şu senaryoları deneyin:

• Tek çekim ve farklı taksit sayılarıyla başarılı ödeme.
• 3D doğrulama ekranında hatalı şifre ve vazgeçme.
• Yetersiz bakiye veya reddedilen kart.
• Ödeme sırasında tarayıcının kapatılması: sipariş ne durumda kalıyor, stok ayrılıyor mu?
• Kupon ve kampanya uygulanmış sepetle ödeme.
• Panelden tam ve kısmi iade.
• Mobil cihazda ve farklı tarayıcılarda ödeme.

Ödeme hatalarının satışa etkisini takip etmek için GA4’te ödeme adımı etkinliklerinin doğru kurulduğundan emin olun. Ödeme sayfasındaki sürtünmeleri azaltmak için dönüşüm oranı optimizasyonu yazımızdaki önerileri inceleyebilirsiniz.

Kart dışı ödeme yöntemleri: Havale ve kapıda ödeme

Sanal POS tek ödeme yöntemi olmak zorunda değildir. Magento 2’de banka havalesi (Bank Transfer Payment) ve kapıda ödeme (Cash On Delivery) yöntemleri çekirdekte hazır gelir. Bu yöntemleri sunarken şunlara dikkat edin:

• Havale: Ödeme sayfasında IBAN ve açıklama bilgisi net yazılmalı; ödemenin gelip gelmediği kontrol edilene kadar sipariş “beklemede” kalır. Belirli bir süre içinde ödeme gelmeyen siparişlerin iptal kuralı belirlenmelidir.
• Kapıda ödeme: Kargo firmanızın kapıda tahsilat hizmeti ve ücreti sözleşmenizde olmalı. Ek hizmet bedeli alacaksanız bunu ödeme sayfasında açıkça gösterin.
• Müşteri grubuna göre gösterim: B2B müşterilere yalnızca havale veya cari hesap, perakende müşterilere kart ve kapıda ödeme sunmak istiyorsanız ek bir modül veya geliştirme gerekebilir.

Yurt dışından gelen siparişlerde ödeme

Magento mağazanızdan yurt dışına satış yapıyorsanız, yerli sanal POS’lar yabancı kartları ve döviz tahsilatını her zaman istediğiniz şekilde desteklemeyebilir. Bu durumda şu soruları sağlayıcınıza sorun: Yabancı kartlarla ödeme kabul ediliyor mu? Döviz cinsinden tahsilat ve hesaba döviz olarak aktarım mümkün mü? Yabancı kartlarda 3D Secure akışı nasıl işliyor? Uluslararası satış hacminiz büyükse global ödeme sağlayıcılarını da değerlendirmek gerekir. Konunun genel çerçevesi için e-ihracat nedir, nasıl yapılır yazımıza bakabilirsiniz.

Ödeme ve muhasebe tarafının uyumu

Sanal POS’tan hesabınıza geçen tutar, komisyon ve vade farkı nedeniyle sipariş toplamından farklıdır. Muhasebe tarafında bu farkların doğru kaydedilmesi için sağlayıcının ödeme raporlarını Magento sipariş numaralarıyla eşleştirebilmeniz gerekir. ERP veya muhasebe yazılımı entegrasyonu kullanıyorsanız ödeme yöntemi ve taksit bilgisinin de siparişle birlikte aktarılmasını sağlayın. Fatura ve kayıt detayları için mali müşavirinize danışın.

Ödeme sayfası deneyimi: Küçük detaylar, büyük fark

Ödeme modülü teknik olarak doğru çalışsa bile ödeme sayfasının tasarımı dönüşümü etkiler. Şu detaylara dikkat edin:

• Güven unsurları: Kabul edilen kart logoları, güvenli ödeme ibaresi ve iletişim bilgisi ödeme adımında görünür olmalı.
• Taksit tablosunun okunabilirliği: Aylık tutar ve toplam tutar birlikte, mobilde kaydırma gerektirmeden gösterilmeli.
• Hata mesajları: “İşlem başarısız” yerine kartın neden reddedildiğini anlaşılır şekilde anlatan mesajlar, müşterinin başka bir kartla tekrar denemesini sağlar.
• Misafir ödeme: Üyelik zorunluluğu, özellikle ilk kez alışveriş yapan müşterilerde terk oranını artırabilir.

Sık karşılaşılan sorunlar

• Ödeme alındı ama sipariş “beklemede” kaldı: Genellikle callback adresi yanlış tanımlanmış veya sunucu güvenlik duvarı sağlayıcının bildirimini engelliyordur.
• Ödeme formu açılmıyor: CSP kuralları, JavaScript çakışması veya tema uyumsuzluğu kontrol edilmeli.
• Çift sipariş: Kullanıcının sayfayı yenilemesi veya geri tuşu, modül iyi kurgulanmamışsa çift kayıt oluşturabilir.
• Muhasebe eşleşmesi: Sağlayıcının hesabınıza aktardığı tutar ile Magento sipariş toplamları arasındaki farklar (komisyon, iade) düzenli mutabakat gerektirir.

Sonuç: Ödeme altyapısı güven ve dönüşüm demektir

Magento 2’de doğru sanal POS kurgusu; uygun sağlayıcıyı seçmek, resmi veya güvenilir bir modülle entegre etmek, taksit ve 3D Secure akışlarını eksiksiz test etmek ve güvenlik kontrollerini düzenli yapmaktan oluşur. iyzico ve PayTR gibi sağlayıcıların resmi modülleri hızlı bir başlangıç sunar; banka sanal POS’ları ise hacim büyüdükçe maliyet avantajı sağlayabilir. Mağazanız için Magento sanal POS ve ödeme entegrasyonunu birlikte planlamak isterseniz hizmet sayfamızdan bize ulaşın. Ödeme ayarlarını ekibinizle yönetmek için Magento 2 eğitimi sayfamıza göz atabilirsiniz. Vergi ve muhasebe kayıtlarıyla ilgili konularda mali müşavirinize danışmayı unutmayın.

Sık Sorulan Sorular

Magento için iyzico modülü var mı?

Evet. iyzico, Magento 2 için resmi bir ödeme modülü sunuyor; kurulum adımları iyzico'nun geliştirici dokümantasyonunda yer alıyor ve kaynak kodu iyzico'nun GitHub hesabında yayımlanıyor.

PayTR Magento 2 ile uyumlu mu?

PayTR'nin geliştirici sayfasına göre resmi modülü Magento 2.3.x ve 2.4.x sürümlerini destekliyor ve Composer ile kuruluyor. Modül Adobe Commerce Marketplace'te de PayTR tarafından listeleniyor.

Magento'da taksit nasıl gösterilir?

Taksit seçenekleri genellikle ödeme modülü tarafından ödeme sayfasında, kartın bankasına göre gösterilir. Ürün sayfasında taksit tablosu için modülün bu özelliği veya ayrı bir taksit eklentisi kullanılır.

Banka sanal POS'u mu, ödeme kuruluşu mu daha avantajlı?

Ödeme kuruluşları hızlı başvuru ve farklı bankalarda tek anlaşmayla taksit sunar. Banka sanal POS'larında hacme göre komisyon pazarlığı mümkündür ancak Magento modülü için entegratör veya özel geliştirme gerekebilir. Güncel oranları sağlayıcılardan yazılı alın.

Ödeme alındı ama sipariş oluşmadı, neden?

En sık neden, ödeme sağlayıcısının sonuç bildiriminin (callback) Magento'ya ulaşmamasıdır. Bildirim adresinin sağlayıcı panelinde doğru tanımlandığını ve sunucu güvenlik duvarının bu istekleri engellemediğini kontrol edin.