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

# 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 <a href="#eklenti-indir" id="eklenti-indir"></a>

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

[**Eklentiyi İndir**](https://github.com/morpara/morpos-magento2/archive/refs/heads/main.zip) ✅

### 🧠 Genel Özellikler

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

* Magento **2.2 ve üzeri** ile uyumlu
* Ortak Ödeme Sayfası&#x20;
* 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)

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