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

OpenCart ödeme uzantısını MagicPay ile yapılandırın

OpenCart mağazanızı MagicPay üzerinden sanal POS'lara bağlayın; kart girişini MagicPay sayfasında, sipariş ve iade işlemlerini mağaza akışında birleştirin.

  • Sanal POS'lara tek bağlantı
  • MagicPay sayfasında kart girişi
  • Sipariş ve iade işlemleri

OpenCart kasasından MagicPay ödeme sayfasına

MagicPay OpenCart ödeme uzantısı, mağazanızdaki sipariş akışını MagicPay'in barındırdığı ödeme sayfasına bağlar. Müşteri kart bilgilerini MagicPay üzerinde girer; işlemde kullanılacak POS'u MagicPay belirler. Kurulumdan önce mağazanızın ortamını paket bilgileriyle karşılaştırın ve mevcut ödeme ayarlarını kaydedin. Bu rehberdeki adımları önce bir test ortamında değerlendirin.

OpenCart tarafında dosyanın yüklenmesi, uzantının ödeme yöntemi olarak kurulmasıyla aynı işlem değildir. Yükleyicide görünen bir paket henüz ödeme listesinde etkin olmayabilir. Bu iki aşamayı ayrı ayrı tamamlamak, kurulum kontrolünün temel parçasıdır.

Dosya adını koruyarak iki aşamada kurun

Kurulum paketini demo veya iletişim kanalından talep edin. Paketin adı magicpay.ocmod.zip olarak kalmalıdır. OpenCart eklenti klasörünü dosya adından oluşturur; bu nedenle yüklemeden önce arşivi yeniden adlandırmayın. Kurulum boyunca yönetim panelindeki yükleyici ile ödeme uzantısı ekranını birbirinden ayırın.

  1. Extensions > Installer sayfasını açın, Upload düğmesine basın ve magicpay.ocmod.zip dosyasını seçin.
  2. Yükleme tamamlanınca aynı listede MagicPay satırındaki Install düğmesine tıklayın.
  3. Extensions > Extensions sayfasına geçin, tür olarak Payments seçin ve MagicPay satırında yeniden Install işlemini yapın.
  4. Edit ekranında API key ve Secret key değerlerini girin. Status seçeneğini açın, Test modu açıkken Save düğmesiyle kaydedin.

Ödeme ayarlarını ve bildirim sonucunu kontrol edin

API anahtarlarını MagicPay panelindeki Ayarlar > API Yetki Yönetimi bölümünden alın. Test moduyla test anahtarlarının eşleştiğini kontrol edin ve gizli anahtarı paylaşmayın. OpenCart MagicPay ayar sayfasındaki Sanal POS sekmesi, hesabınızdaki POS kayıtlarını incelemenizi sağlar. En az bir aktif POS bulunmalıdır; bu ekran sipariş başına POS seçmek için kullanılmaz.

Mağaza ön yüzünde bir ürünle test siparişi oluşturun ve MagicPay sayfasında test kartıyla devam edin. OpenCart sipariş kaydı ile MagicPay panelindeki sonucu karşılaştırın. Ödeme sonucu mağazaya ulaşmıyorsa internetten HTTPS erişimini kontrol edin. Bildirim adresini eklenti ödeme isteğinde gönderir; ayrıca panel kaydı gerekmez. Başarısız denemede siparişin ödenmemiş kaldığını da inceleyin.

Kaydedilen ayarlarla canlıya geçin

Canlı geçişinden önce Edit ekranını yeniden açarak Status, çalışma modu ve anahtar alanlarının kaydedildiğini kontrol edin. Müşterinin dönüş ekranını ve sipariş durumunu birlikte değerlendirin. Tam veya kısmi iade testinde kalan iade edilebilir tutarı aşmayın.

Test sonuçları beklendiği gibiyse test modunu kapatın, canlı anahtarları girin ve Save düğmesine basın. İlk canlı siparişleri MagicPay kayıtlarıyla karşılaştırın. Daha sonra paketi yeniden yüklemeniz gerekirse aynı dosya adını koruyun; arşiv adını değiştirmek kurulum düzenini etkileyebilir.

Sık sorulan sorular

Paket hangi dosya adıyla yüklenmeli?

Paketi magicpay.ocmod.zip adıyla yükleyin. OpenCart eklenti klasörünü bu dosya adından oluşturur.

Neden iki kez Install işlemi var?

Önce Extensions > Installer içinde paket, ardından Extensions > Extensions > Payments içinde ödeme uzantısı kurulur.

Sanal POS ayarlarına nereden ulaşırım?

MagicPay ödeme uzantısının Edit ekranındaki Sanal POS sekmesinden ulaşabilirsiniz. Yönlendirmeyi MagicPay yapar.