Mağazanızla birlikte çalışır

Magento mağazanızı MagicPay sanal POS bağlantısıyla buluşturun

Magento ödeme akışını MagicPay'e bağlayın; müşteriniz kartını MagicPay sayfasında girerken POS yönlendirmesi, sipariş ve iade işlemleri aynı bağlantıdan ilerlesin.

  • Sanal POS'lara tek bağlantı
  • Website düzeyinde API ayarları
  • Sipariş ve iade işlemleri

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.

  1. Paketi app/code/MagicPay/Checkout içine açın; registration.php dosyasının doğrudan bu klasörde bulunduğunu doğrulayın.
  2. Sırayla bin/magento module:enable MagicPay_Checkout, bin/magento setup:upgrade ve bin/magento setup:di:compile adımlarını uygulayın.
  3. 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.
  4. 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.

Sık sorulan sorular

Magento kurulumu kim tarafından yapılmalı?

Dosya yerleşimi ve Magento kurulum adımları için sunucuya erişimi olan bir geliştirici tarafından yapılmalıdır.

Birden fazla website için anahtarlar nasıl ayarlanır?

Anahtarları website düzeyinde girebilirsiniz. Virtual POS ekranında da ilgili website'i seçip her website'in ödeme akışını ayrı kontrol edin.

Modül dosyalarının doğru konumu nedir?

registration.php dosyası app/code/MagicPay/Checkout/registration.php konumunda olmalıdır. Fazladan iç içe klasör bırakmayın.