Magento Mağazanızda Güvenli Ödeme Alın

Neden Magento Kurulumlarında Ödeme Adımı Ayrı Planlanır?

Magento, açık kaynaklı e-ticaret platformlarından biridir ve Adobe Commerce ile birlikte kurumsal ölçekte mağaza yönetimine kullanılır. Platformun en belirgin özelliği katmanlı yapısıdır: tek bir kurulum içinde birden fazla website, her website altında store ve her store altında store view tanımlanabilir. Bu yapı, farklı markaları, farklı para birimlerini ve farklı dilleri tek yönetim panelinden yürütmeyi mümkün kılar.

Aynı esneklik ödeme tarafında da karşılık ister. Ödeme yöntemi yapılandırması Magento'da kapsam (scope) mantığıyla çalıştığından, bir ayarı tüm kurulum için mi yoksa yalnız belirli bir store view için mi geçerli kılacağınıza karar verirsiniz. Bu nedenle kurulum öncesinde hangi mağazanın hangi anahtarla ve hangi ödeme seçenekleriyle çalışacağını yazılı olarak planlamak, sonradan yapılan düzeltmelerden daha az iş çıkarır.

Magento'nun müşteri grubu ve fiyatlandırma kuralları, kurumsal (B2B) ve bireysel (B2C) satışı aynı kurulumda yürütmenize imkân verir. Ödeme tarafında bunun karşılığı, müşteri grubuna göre farklı ödeme seçeneği ya da taksit tanımı gösterebilmektir. Hangi seçeneklerin hesabınıza tanımlı olacağı ve varsa ücreti teklifinizde yazar. Sepetten ödemeye giden akışın genel çerçevesi için e-ticaret sanal POS sayfasına bakabilir, ön değerlendirme için başvuru formunu doldurabilirsiniz.

Eklenti Kurulumu ve Ödeme Yöntemi Ayarları

Magento 2 tarafında ödeme yöntemi bir modül olarak eklenir. Modüller genellikle Composer ile yönetilir; Composer, PHP projelerinde bağımlılıkları indiren ve sürümlerini izleyen araçtır. Eklenti veya modül dosyası, kurulum komutu ve desteklenen Magento ile PHP sürümleri hesabınız açıldığında iletilen dokümantasyonda belirtilir. Kurulum sonrası önbelleğin temizlenmesi ve kurulum güncelleme komutlarının çalıştırılması gibi adımlar da aynı dokümantasyonda yer alır.

bin/magento maintenance:enable
composer require <dokumantasyondaki-paket-adi>
bin/magento module:enable <Modul_Adi>
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:clean
bin/magento maintenance:disable

Adobe’nin belgelediği genel kurulum sırası budur (setup:di:compile yalnız üretim kipinde gerekir); bakım kipini kapatmayı (maintenance:disable) unutmayın. Paket ve modül adı dokümantasyonunuzda yazar; tahmin edilen bir adla kurulum yapmayın (sahte paket riski).

Modül kurulduktan sonra yapılandırma yönetim panelinde Stores menüsü altındaki ödeme yöntemleri bölümünden yapılır. Burada yöntemi etkinleştirir, hesabınıza tanımlanan anahtarları girer ve ortamı test ya da canlı olarak seçersiniz. Anahtarların test ve canlı karşılıkları ayrıdır; canlı anahtarla test siparişi oluşturmayın. Anahtarları sürüm deposuna yazmak yerine sunucu ortam değişkenlerinde tutmak, ekip içinde paylaşılan kurulumlarda daha güvenlidir.

Aynı ekranda ödeme akışının davranışı belirlenir: 3D Secure doğrulamasının hangi işlemlerde isteneceği, müşterinin doğrulama sonrası geri döneceği adres (callback) ve sipariş durumunu güncelleyecek sunucu bildiriminin (webhook) gideceği adres. Doğrulama akışının ne işe yaradığı 3D Secure güvenli ödeme sayfasında, şüpheli işlemlerin değerlendirilmesi fraud ve risk skorlama sayfasında anlatılır.

Modül kullanmak zorunlu değildir. Aynı işlemler doğrudan REST çağrılarıyla da yapılabilir; bu durumda imzalama, yeniden deneme ve hata yönetimini kendi kodunuzda kurarsınız. Uç noktalar ve alan yapısı için API dokümantasyonu, Magento'nun çalıştığı dildeki örnekler için PHP SDK sayfasını kullanabilirsiniz. Entegrasyonun genel yolları API ve SDK entegrasyonu sayfasında özetlenir.

Çoklu Mağaza, Test ve Canlıya Geçiş

Çoklu mağaza kurulumlarında her store view'ın kendi para birimi, dili ve müşteri kitlesi olabilir. Ödeme yöntemi ayarlarını bu kapsamda tanımladığınızda, bir mağazada açık olan bir seçeneği diğerinde kapalı tutabilirsiniz. Değişiklik yaptığınız kapsamı her seferinde kontrol edin: üst kapsamda yapılan bir düzeltme, alt kapsamlarda kendi değeri tanımlı olmayan mağazaları da etkiler.

Canlıya geçmeden önce akışı test anahtarlarıyla uçtan uca çalıştırın. En az şu senaryoları deneyin: başarılı ödeme, başarısız ödeme, 3D Secure doğrulama adımı ve iade ya da iptal çağrısı. Test siparişlerinde gerçek kart verisi kullanmayın; test ortamının kapsamı ve kullanılabilir test kartları için test ortamı (sandbox) sayfasına bakın. Sipariş durumunun doğru güncellendiğini, tarayıcının döndüğü sayfaya değil sunucunuza ulaşan bildirime bakarak doğrulayın.

Akış doğrulandıktan sonra yalnız ortam seçimi ve anahtar değerleri canlıya çevrilir; modül yapılandırmasının geri kalanı aynı kalır. Canlıya geçtikten sonraki ilk gerçek siparişleri yönetim panelinden ve kendi kayıtlarınızdan karşılaştırarak izlemek, ayar hatalarını erken yakalamanızı sağlar. Farklı platformlarda çalışan mağazalarınız varsa WooCommerce ve PrestaShop entegrasyon sayfalarına da bakabilirsiniz.

Teknik gereksinimler

Sürüm bilgileri genel çerçevedir; kesin gereksinimler ve desteklenen sürümler, hesabınız açıldığında iletilen dokümantasyonda belirtilir.