> 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/prestashop.md).

# Prestashop

**PrestaShop için MorPOS**, **Morpara MorPOS** ödeme altyapısını PrestaShop mağazalarıyla entegre eden güvenli ve kullanımı kolay bir ödeme modülüdür.\
Müşterileriniz ödemelerini güvenli **Hosted Payment Page (HPP)** veya **Embedded** ödeme akışı ile tamamlar.

***

### 📥 Modülü İndir

PrestaShop için MorPOS modülünü aşağıdaki bağlantı üzerinden indirebilirsiniz:

👉 [**PrestaShop MorPOS Modülünü İndir**](https://github.com/morpara/morpos-prestashop/archive/refs/heads/main.zip)

> İndirme bağlantısı her zaman en güncel sürümü içerir.

***

### ✨ Özellikler

* 🛒 **PrestaShop Entegrasyonu**: MorPOS’u ödeme yöntemi olarak ekler
* 🔒 **Güvenli Ödeme**: Hosted Payment Page (HPP) ve Embedded form
* 💳 **Kartlı Ödemeler**: Kredi kartı ve banka kartı desteği
* 📆 **Taksitli Ödeme**: Banka ve kart bazlı taksit seçenekleri
* 🌍 **Çoklu Para Birimi**: TRY, USD, EUR, GBP
* 🧪 **Sandbox Modu**: Test ortamı desteği
* 🏬 **Multi-Store Desteği**: PrestaShop çoklu mağaza uyumu
* 🛡️ **Güvenlik**: TLS 1.2+, imzalı API iletişimi

***

### 📋 Gereksinimler

#### Sunucu Gereksinimleri

| Bileşen        | Minimum | Önerilen |
| -------------- | ------- | -------- |
| **PrestaShop** | 1.7.0   | 8.x      |
| **PHP**        | 7.4     | 8.2+     |
| **TLS**        | 1.2     | 1.3      |

#### PHP Uzantıları

* `cURL`
* `json`
* `hash`
* `openssl`

#### PrestaShop Gereksinimleri

* SSL sertifikası (üretim ortamı için zorunlu)
* Friendly URL açık olmalı
* Desteklenen para birimleri aktif olmalı

***

### 🚀 Kurulum

#### Yöntem 1: Modül Yöneticisi (Önerilen)

1. Modül ZIP dosyasını indirin
2. PrestaShop yönetici paneline girin
3. **Modüller → Modül Yöneticisi**
4. **Modül Yükle** butonuna tıklayın
5. ZIP dosyasını seçip yükleyin
6. **Yapılandır** butonuna tıklayın

***

#### Yöntem 2: Manuel Kurulum

1. ZIP dosyasını açın
2. `morposgateway` klasörünü `/modules/` dizinine kopyalayın
3. Yönetici panelinden modülü kurun

***

### ⚙️ Yapılandırma

#### Temel Ayarlar

**Modüller → Modül Yöneticisi → MorPOS → Yapılandır**

| Alan          | Açıklama              |
| ------------- | --------------------- |
| Merchant ID   | Üye işyeri kimliği    |
| Client ID     | OAuth istemci kimliği |
| Client Secret | OAuth gizli anahtarı  |
| API Key       | API erişim anahtarı   |

***

#### Ortam Ayarları

* **Test Modu**\
  Sandbox ortamını kullanır, gerçek işlem yapılmaz
* **Form Türü**
  * `Hosted` (önerilen)
  * `Embedded`

***

### 🔄 Ödeme Akışı

1. Müşteri sipariş oluşturur
2. MorPOS ödeme yöntemi seçilir
3. Sipariş doğrulaması yapılır
4. Ödeme formuna yönlendirilir
5. Ödeme tamamlanır
6. Callback alınır
7. Sipariş durumu güncellenir

***

### 🛠️ Geliştirme ve Hata Ayıklama

#### Loglama

PrestaShop loglarını kontrol edin:

* **Gelişmiş Parametreler → Loglar**
* **Gelişmiş Parametreler → Performans → Hata Ayıklama**

Geliştirme ortamı için:

```php
define('_PS_MODE_DEV_', true);
```

### 🔍 Sorun Giderme

#### "Ödeme başlatılamadı" Hatası

1. API bilgilerini kontrol edin
2. Test modunun doğru ortamda olduğundan emin olun
3. TLS 1.2+ desteğini doğrulayın
4. Sunucu saatinin doğru olduğundan emin olun
5. Log kayıtlarını inceleyin

***

#### Ödeme Durumu Güncellenmiyor

1. Callback URL’inin erişilebilir olduğunu kontrol edin
2. SSL sertifikasını doğrulayın
3. Friendly URL ayarlarını kontrol edin
4. Firewall / WAF engellemelerini inceleyin

***

### 🌐 Uluslararasılaştırma

* Türkçe (`tr_TR`)
* İngilizce (`en_US`)

***

### 🤝 Katkıda Bulunma

* Fork → Commit → Pull Request
* PrestaShop kodlama standartlarına uyum
* Geriye dönük sürüm uyumluluğu

***

### 📄 Lisans

MIT Lisansı

***

### 🆘 Destek

* Destek: <https://morpara.com/support>
* GitHub Issues
* Teknik dokümantasyon