OpenCart

MorPOS for OpenCart, for OpenCart 4.x stores Morpara MorPOS is a secure and easy-to-use payment gateway plugin that integrates the payment system. Customers are redirected through a secure Hosted Payment Page (HPP) flow or Embedded Payment Form can use.

---

📦 Versions

• 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 files are suitable for OpenCart admin panel or manual installation.

---

✨ Features

• 🛒 OpenCart Integration: Seamlessly adds MorPOS as a payment method for OpenCart 4.x

• 🔒 Secure Payments: Hosted Payment Page (HPP) and Embedded Payment Form

• 🌍 Multi-Currency: TRY, USD, EUR

• 💳 Multiple Payment Options: Credit cards, debit cards and installment payments

• 🧪 Test Mode: Sandbox for development/testing

• 🔧 Easy Configuration: Connection test and admin panel

• 🛡️ Security Features: TLS 1.2+, signed API communication, cart/order verification

• 🌐 Multi-Language: Turkish and English support

---

📋 Requirements

Server Requirements

Component	Minimum	Recommended
OpenCart	4.0	4.1.0.3
PHP	8.0	8.2+
TLS	1.2	1.3

PHP Extensions

• cURL

• json

• hash

• openssl

OpenCart Features

• Admin Panel Access

• Database Access

• HTTPS recommended

• Session SameSite Policy: 'Lax'

---

🚀 Installation

Method 1: Extension Installer (Recommended)

1. Download the ZIP file via GitHub Releases download

2. OpenCart → Extensions → Installer → Upload ZIP

3. Extensions → Payments → MorPOS Payment Gateway → Install

4. Edit → Enter credentials → Test Connection → Save

Method 2: Manual Installation (Developers)

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/

Method 3: FTP Upload

1. Download and extract the ZIP file

2. upload/ upload the contents to the OpenCart root directory

3. Follow the steps in Method 2

---

⚙️ Configuration

1. Extensions → Payments → MorPOS Payment Gateway → Edit

2. Fill in the required fields:

Field	Description	Example
Merchant ID	The merchant ID you received from MorPOS	12345
Client ID	OAuth client identifier	your_client_id
Client Secret	OAuth client secret key	your_client_secret
API Key	API authentication key	your_api_key

1. Test Mode (Sandbox): Enable for development/testing

2. Form Type: Hosted (recommended) or Embedded

3. Order Status: Set successful/failed order statuses

4. Test Connection → A green confirmation should appear → Save

---

🔧 Payment Flow

1. Customer reviews products in the cart

2. Proceeds to checkout and selects MorPOS

3. System verifies the cart and creates the order

4. Hosted: Redirected to the MorPOS page

5. Embedded: Form is loaded within the page

6. Callback is received from MorPOS → Order status is updated

7. Customer sees the success/failure page

---

🛠️ Debugging

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

• Use test cards and sandbox mode

• Check payment flows step by step

• Troubleshooting tables: TLS, PHP, OpenCart version

---

🌐 Internationalization

• Turkish (tr-tr) and English (en-gb)

• To add a new language, copy and translate the language files

---

🤝 Contributing

1. Fork the repo → Make changes → Pull Request

2. Follow coding standards: PSR-4, PHPDoc

3. Test: Installation, payment flows, multi-currency, security, compatibility

---

📄 License

MIT License - details in LICENSE

---

🆘 Support

• Documentation

• GitHub Issues

• Morpara Support