Magento 2

MorPOS Payment Gateway for Magento 2, Magento 2 tabanlı mağazalara Morpara MorPOS ödeme sistemini entegre eden güvenli, esnek ve kolay bir ödeme ağ geçididir.

---

📥 Eklenti İndir

MorPOS Magento 2 eklentisini aşağıdaki bağlantıdan indirebilirsiniz:

Eklentiyi İndir ✅

🧠 Genel Özellikler

Modül aşağıdaki özellikleri içerir:

• Magento 2.2 ve üzeri ile uyumlu

• Ortak Ödeme Sayfası

• Gömülü Ödeme Formu ile kesintisiz ödeme

• Çoklu para birimi: TRY, USD, EUR

• Sandbox (test) modu

• Yönetici panelinden kolay yapılandırma

• Çoklu mağaza desteği

• Misafir & kayıtlı kullanıcılar için ödeme

• CSP (Content Security Policy) uyumlu

• API imzalama ve güvenlik özellikleri

---

📌 Gereksinimler

Sunucu tarafı:

• Magento: 2.2+

• PHP: 7.2+ (8.1+ önerilir)

• TLS 1.2 veya üstü

• PHP eklentileri: cURL, json, hash, openssl

---

⚙️ Kurulum

1) Composer ile (önerilen)

composer require morpara/morpos-magento2
php bin/magento module:enable MorPOS_PaymentGateway
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy
php bin/magento cache:flush

2) Manuel

1. ZIP dosyasını GitHub Releases sayfasından indirin

2. Modül klasörünü app/code/MorPOS/PaymentGateway/ altına çıkartın

3. Etkinleştirme ve deployment komutlarını çalıştırın → aynı adımlar Composer ile yapılan kurulumla eşleşir

3) FTP ile

FTP ile modül dosyalarını app/code/MorPOS/PaymentGateway/ dizinine yükleyin ve ardından terminalde Magento kurulum komutlarını çalıştırın.

---

🔧 Yapılandırma (Yönetici Paneli)

Yapılandırma için:

Mağazalar → Yapılandırma → Satış → Ödeme Yöntemleri → MorPOS Payment Gateway

Gerekli alanlar:

Ayar	Açıklama
Merchant ID	MorPOS üye işyeri kimliği
Client ID	OAuth Client ID
Client Secret	OAuth Client Secret
API Key	MorPOS API anahtarı
Test Modu	Sandbox / Prod ayarı
Form Tipi	HPP veya Gömülü form
Sipariş Durumu	Başarılı ödeme sonrası sipariş statüsü
Minimum / Maksimum Tutar	Opsiyonel sınırlar
Ülkeler	Ödeme için izin verilen ülkeler

👉 Bilgileri nereden alırsınız? MorPOS panelinden veya Morpara destek ekibi üzerinden temin edebilirsiniz.

---

🛒 Ödeme Akışı

1. Müşteri sepete ürün ekler

2. Ödeme adımında MorPOS yöntemi seçilir

3. Magento ödeme oturumunu MorPOS API ile başlatır

4. Müşteri ödeme sayfasına yönlendirilir veya modal içerisinde ödeme formu açılır

5. Ödeme tamamlanınca MorPOS mağazaya callback gönderir

6. Sipariş otomatik güncellenir

7. Müşteri sonuç ekranını görür

---

🔐 Güvenlik Özellikleri

Modül aşağıdaki güvenlik uygulamalarını içerir:

• SHA-256 imzalı API çağrıları (MorPOS Docs gerekliliği)

• Client Secret & API Key veritabanında şifreli tutulur

• CSP beyaz liste yapılandırması

• HTTPS zorunluluğu

• Hassas veriler loglanmaz

---

🧪 Test Kartları & Sandbox

Modül sandbox desteği içerir. Test kart numaraları ve örnek senaryolar için MorPOS dokümantasyonuna bakabilirsiniz.

---

🚑 Sorun Giderme

Ödeme yöntemi görünmüyor?

• Modül aktif mi?

• Desteklenen para birimi var mı?

• Ülke / sipariş tutarı kısıtlaması var mı?

Ödeme başlatılamıyor?

• Kimlik bilgileri doğru mu?

• TLS sürümü uygun mu?

• cURL yüklü mü?

Callback sonrası sipariş güncellenmiyor?

• Callback URL erişilebilir mi?

• Firewall / DNS engeli var mı?

---

🌍 Uluslararasılaştırma (i18n)

Modül Türkçe ve İngilizce çeviri dosyaları içerir. Yeni diller eklemek de mümkündür.

---

🧩 Modül Yapısı (Önemli Dizinler)

MorPOS/PaymentGateway/
├── Api/
├── Block/
├── Controller/
├── Gateway/
├── Helper/
├── Model/
├── Plugin/
├── etc/
├── i18n/
└── view/

---

📍 API Uç Noktaları

Endpoint	Method	Kullanım
/morpos/payment/start	POST	Ödeme oturumu başlat
/morpos/payment/callback	POST	MorPOS geri çağrısı
/morpos/payment/success	GET	Başarı yönlendirme
/morpos/payment/cancel	GET	İptal yönlendirme