Magento için sunucu taraflı ödeme modülü
MagicPay Magento modülü, müşteriyi ödeme adımında MagicPay'in barındırdığı sayfaya yönlendirir. Kart bilgileri bu sayfada girilir; POS yönlendirmesini MagicPay yapar. Kurulum sunucu erişimi olan bir geliştirici tarafından yürütülür. Kurulum paketini demo veya iletişim kanalından talep edin ve mevcut yapılandırmanın yedeğini hazırlayın.
Bu paket için belgelenen Magento sürümleri 2.4.7 ve 2.4.8, PHP gereksinimi 8.2 veya 8.3'tür. Magento framework bağımlılığı ~103.0.7 ile sınırlıdır. Bu koşulları sunucunuzdaki gerçek bağımlılıklarla birlikte kontrol edin; sürüm numarasının daha yüksek olması tek başına uygunluk anlamına gelmez. Önce test ortamında ilerleyin.
Modül dosyaları ve Magento kurulum sırası
Dosya yerleşimini doğrulamak kurulumun ilk adımıdır. Arşivden fazladan bir üst klasör çıkması, Magento'nun modülü beklenen konumda bulmasını engelleyebilir. Kurulum işlemlerini Magento ana klasöründe, mağazanın çalışma moduna uygun biçimde yürütün.
- Paketi app/code/MagicPay/Checkout içine açın; registration.php dosyasının doğrudan bu klasörde bulunduğunu doğrulayın.
- Sırayla bin/magento module:enable MagicPay_Checkout, bin/magento setup:upgrade ve bin/magento setup:di:compile adımlarını uygulayın.
- Production modunda kurulum rehberindeki statik içerik dağıtım adımını tamamlayın; ardından bin/magento cache:flush adımını uygulayın.
- Stores > Configuration > Sales > Payment Methods içinde MagicPay bölümünü açın. API key ve Secret key girin, Enabled alanını Yes yapın, Test mode açıkken Save Config ile kaydedin.
Website kapsamı ve ödeme bildirimi
Anahtarları MagicPay panelindeki Ayarlar > API Yetki Yönetimi bölümünden alın ve gizli anahtarı paylaşmayın. Birden fazla website varsa anahtarları website düzeyinde girebilirsiniz. Stores > Settings > Virtual POS ekranında da ilgili website'i seçin. Ödeme ayarlarındaki Manage banks bağlantısı aynı POS yönetimine ulaşır. Hesapta en az bir aktif POS bulunmalıdır.
Test siparişini ayar yaptığınız website üzerinden oluşturun. MagicPay sayfasında test kartıyla ödeme yapıp Magento siparişini paneldeki işlemle karşılaştırın. Bildirim için mağaza internetten HTTPS ile erişilebilir olmalıdır. Eklenti bildirim adresini ödeme isteğinde gönderir. Bir website'teki başarılı denemeyi diğer website'lerin de doğrulandığı şeklinde yorumlamayın.
Website bazında canlı kullanım ve güncelleme
Tam veya kısmi iade testinde kalan iade edilebilir tutarı aşmayın. Başarılı ve reddedilen ödemelerde sipariş durumunu, müşterinin dönüşünü ve işlem kaydını birlikte kontrol edin. Canlıya geçerken ilgili website kapsamında test modunu kapatın, canlı anahtarları girin ve Save Config ile kaydedin.
Güncellemede yeni paket aynı modül klasörüne açılır ve rehberdeki etkinleştirme, yükseltme, derleme ve önbellek adımları tekrarlanır. Production modunun statik içerik adımını da koruyun. Her değişiklik sonrasında ilgili website için sipariş kontrolünü yeniden yapın.