> For the complete documentation index, see [llms.txt](https://docs.morpara.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.morpara.com/api-dokumantasyonu/gelistiriciaraclari/acik-kaynak-eklentiler/opencart.md).

# Opencart

[![OpenCart Sürümü](https://img.shields.io/badge/OpenCart-4.0%2B-blue.svg)](https://www.opencart.com/) [![PHP Sürümü](https://img.shields.io/badge/PHP-8.0%2B-777bb4.svg)](https://php.net/) ![Lisans](https://img.shields.io/badge/license-MIT-blue.svg)

**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](https://github.com/morpara/morpos-opencart/tree/4.x)
* **OpenCart 3.x**: [3.x branch](https://github.com/morpara/morpos-opencart/tree/3.x)
* **OpenCart 2.3.x**: [2.3.x branch](https://github.com/morpara/morpos-opencart/tree/2.3.x)
* **OpenCart 2.x**: [2.x branch](https://github.com/morpara/morpos-opencart/tree/2.x)

***

> 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](https://github.com/morpara/morpos-opencart/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)

```bash
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       |

3. **Test Modu (Sandbox)**: Geliştirme/test için etkinleştirin
4. **Form Tipi**: Hosted (önerilen) veya Embedded
5. **Sipariş Durumu**: Başarılı/başarısız sipariş durumlarını ayarlayın
6. **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

```php
// 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](https://docs.opencart.com/)
* [GitHub Issues](https://github.com/morpara/morpos-opencart/issues)
* [Morpara Destek](https://morpara.com/support)