Opencart

MorPOS for OpenCart, OpenCart 4.x mağazalarına Morpara MorPOS ödeme sistemini entegre eden güvenli ve kullanımı kolay bir ödeme ağ geçidi eklentisidir. Müşteriler, siparişlerini tamamlarken güvenli Barındırılan Ödeme Sayfası (HPP) akışı üzerinden yönlendirilir veya Gömülü Ödeme Formu kullanabilir.

---

📦 Versiyonlar

• OpenCart 4.x: 4.x branch

• OpenCart 3.x: 3.x branch

• OpenCart 2.3.x: 2.3.x branch

• OpenCart 2.x: 2.x branch

---

ZIP dosyaları OpenCart yönetici paneli veya manuel kurulum için uygundur.

---

✨ Özellikler

• 🛒 OpenCart Entegrasyonu: OpenCart 4.x için MorPOS'u ödeme yöntemi olarak sorunsuzca ekler

• 🔒 Güvenli Ödemeler: Barındırılan Ödeme Sayfası (HPP) ve Gömülü Ödeme Formu

• 🌍 Çoklu Para Birimi: TRY, USD, EUR

• 💳 Çoklu Ödeme Seçenekleri: Kredi kartları, banka kartları ve taksitli ödemeler

• 🧪 Test Modu: Geliştirme/test için sandbox

• 🔧 Kolay Yapılandırma: Bağlantı testi ve yönetici paneli

• 🛡️ Güvenlik Özellikleri: TLS 1.2+, imzalı API iletişimi, sepet/sipariş doğrulaması

• 🌐 Çoklu Dil: Türkçe ve İngilizce desteği

---

📋 Gereksinimler

Sunucu Gereksinimleri

Bileşen	Minimum	Önerilen
OpenCart	4.0	4.1.0.3
PHP	8.0	8.2+
TLS	1.2	1.3

PHP Eklentileri

• cURL

• json

• hash

• openssl

OpenCart Özellikleri

• Yönetici Paneli Erişimi

• Veritabanı Erişimi

• HTTPS önerilir

• Oturum SameSite Politikası: 'Lax'

---

🚀 Kurulum

Yöntem 1: Eklenti Yükleyici (Önerilen)

1. ZIP dosyasını GitHub Releases üzerinden indirin

2. OpenCart → Eklentiler → Yükleyici → ZIP yükle

3. Eklentiler → Ödemeler → MorPOS Payment Gateway → Yükle

4. Düzenle → Kimlik bilgilerini girin → Bağlantıyı Test Et → Kaydet

Yöntem 2: Manuel Kurulum (Geliştiriciler)

git clone https://github.com/morpara/morpos-opencart.git
cd morpos-opencart
cp -r upload/extension/morpos_gateway/* /path/to/opencart/extension/morpos_gateway/
cp -r upload/system/library/morpos/* /path/to/opencart/system/library/morpos/
chmod 644 /path/to/opencart/extension/morpos_gateway/**/*.php
chmod 755 /path/to/opencart/extension/morpos_gateway/

Yöntem 3: FTP Yükleme

1. ZIP dosyasını indirin ve çıkartın

2. upload/ içeriğini OpenCart kök dizinine yükleyin

3. Yöntem 2’deki adımları takip edin

---

⚙️ Yapılandırma

1. Eklentiler → Ödemeler → MorPOS Payment Gateway → Düzenle

2. Zorunlu alanları doldurun:

Alan	Açıklama	Örnek
Merchant ID	MorPOS’tan aldığınız üye işyeri kimliği	12345
Client ID	OAuth istemci kimliği	your_client_id
Client Secret	OAuth istemci gizli anahtarı	your_client_secret
API Key	API doğrulama anahtarı	your_api_key

1. Test Modu (Sandbox): Geliştirme/test için etkinleştirin

2. Form Tipi: Hosted (önerilen) veya Embedded

3. Sipariş Durumu: Başarılı/başarısız sipariş durumlarını ayarlayın

4. Bağlantıyı Test Et → Yeşil onay görünmeli → Kaydet

---

🔧 Ödeme Akışı

1. Müşteri sepette ürünleri inceler

2. Ödeme sayfasına geçer ve MorPOS seçer

3. Sistem sepeti doğrular ve sipariş oluşturur

4. Hosted: MorPOS sayfasına yönlendirilir

5. Embedded: Form sayfa içinde yüklenir

6. MorPOS’tan geri çağrı alınır → Sipariş durumu güncellenir

7. Müşteri başarı/başarısız sayfasını görür

---

🛠️ Hata Ayıklama

// OpenCart 4.x
define('ERROR_LOG', '/path/to/your/error.log');
tail -f /path/to/your/error.log

• Test kartları ve sandbox modunu kullanın

• Ödeme akışlarını adım adım kontrol edin

• Sorun giderme tabloları: TLS, PHP, OpenCart sürümü

---

🌐 Uluslararasılaştırma

• Türkçe (tr-tr) ve İngilizce (en-gb)

• Yeni dil eklemek için dil dosyalarını kopyalayın ve çevirin

---

🤝 Katkıda Bulunma

1. Depoyu Fork → Değişiklik yap → Pull Request

2. Kodlama standartlarına uyun: PSR-4, PHPDoc

3. Test edin: Kurulum, ödeme akışları, çoklu para birimi, güvenlik, uyumluluk

---

📄 Lisans

MIT Lisansı - detaylar LICENSE

---

🆘 Destek

• Dokümantasyon

• GitHub Issues

• Morpara Destek