Magento 2

MorPOS Payment Gateway for Magento 2, to Magento 2 based stores Morpara MorPOS is a secure, flexible and easy payment gateway that integrates the payment system.

---

📥 Download Plugin

You can download the MorPOS Magento 2 plugin from the link below:

Download the Plugin ✅

🧠 General Features

The module includes the following features:

• Magento 2.2 and above compatible with

• Hosted Payment Page

• Seamless payment with embedded payment form

• Multiple currencies: TRY, USD, EUR

• Sandbox (test) mode

• Easy configuration from the admin panel

• Multi-store support

• Payments for guest & registered users

• CSP (Content Security Policy) compatible

• API signing and security features

---

📌 Requirements

Server side:

• Magento: 2.2+

• PHP: 7.2+ (8.1+ recommended)

• TLS 1.2 or higher

• PHP extensions: cURL, json, hash, openssl

---

⚙️ Installation

1) With Composer (recommended)

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) Manual

1. Download the ZIP file from the GitHub Releases page

2. Extract the module folder to app/code/MorPOS/PaymentGateway/ below

3. Run the activation and deployment commands → the same steps match the installation done with Composer

3) Via FTP

Upload the module files via FTP to the app/code/MorPOS/PaymentGateway/ directory and then run the Magento installation commands in the terminal.

---

🔧 Configuration (Admin Panel)

For configuration:

Stores → Configuration → Sales → Payment Methods → MorPOS Payment Gateway

Required fields:

Setting	Description
Merchant ID	MorPOS merchant identifier
Client ID	OAuth Client ID
Client Secret	OAuth Client Secret
API Key	MorPOS API key
Test Mode	Sandbox / Prod setting
Form Type	HPP or Embedded form
Order Status	Order status after successful payment
Minimum / Maximum Amount	Optional limits
Countries	Countries allowed for payment

👉 Where do you get the information? You can obtain it from the MorPOS panel or through the Morpara support team.

---

🛒 Payment Flow

1. Customer adds a product to the cart

2. MorPOS method is selected at the payment step

3. Magento initiates the payment session with the MorPOS API

4. Customer is redirected to the payment page or the payment form opens in a modal

5. When the payment is completed MorPOS sends a callback to the store

6. The order is automatically updated

7. Customer sees the result screen

---

🔐 Security Features

The module includes the following security practices:

• SHA-256 signed API calls (MorPOS Docs requirement)

• Client Secret & API Key are stored encrypted in the database

• CSP whitelist configuration

• HTTPS requirement

• Sensitive data is not logged

---

🧪 Test Cards & Sandbox

The module includes sandbox support. For test card numbers and sample scenarios, see the MorPOS documentation.

---

🚑 Troubleshooting

Payment method not visible?

• Is the module active?

• Is there a supported currency?

• Is there a country / order amount restriction?

Payment cannot be initiated?

• Are the credentials correct?

• Is the TLS version adequate?

• Is cURL installed?

Order not updated after callback?

• Is the callback URL accessible?

• Is there a firewall / DNS block?

---

🌍 Internationalization (i18n)

The module includes Turkish and English translation files. Adding new languages is also possible.

---

🧩 Module Structure (Important Directories)

MorPOS/PaymentGateway/
├── Api/
├── Block/
├── Controller/
├── Gateway/
├── Helper/
├── Model/
├── Plugin/
├── etc/
├── i18n/
└── view/

---

📍 API Endpoints

Endpoint	Method	Usage
/morpos/payment/start	POST	Start payment session
/morpos/payment/callback	POST	MorPOS callback
/morpos/payment/success	GET	Success redirect
/morpos/payment/cancel	GET	Cancel redirect