> 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/tr/en/api-documentation/gelistiriciaraclari/open-source-plugins/prestashop.md).

# PrestaShop

**MorPOS for PrestaShop**, **Morpara MorPOS** is a secure and easy-to-use payment module that integrates Morpara's payment infrastructure with PrestaShop stores.\
Your customers complete their payments securely **Hosted Payment Page (HPP)** or **Embedded** with the payment flow.

***

### 📥 Download the Module

You can download the MorPOS module for PrestaShop from the link below:

👉 [**Download PrestaShop MorPOS Module**](https://github.com/morpara/morpos-prestashop/archive/refs/heads/main.zip)

> The download link always contains the most recent version.

***

### ✨ Features

* 🛒 **PrestaShop Integration**: Adds MorPOS as a payment method
* 🔒 **Secure Payment**: Hosted Payment Page (HPP) and Embedded form
* 💳 **Card Payments**: Credit card and debit card support
* 📆 **Installment Payments**: Bank- and card-based installment options
* 🌍 **Multi-Currency**: TRY, USD, EUR, GBP
* 🧪 **Sandbox Mode**: Test environment support
* 🏬 **Multi-Store Support**: PrestaShop multi-store compatibility
* 🛡️ **Security**: TLS 1.2+, signed API communication

***

### 📋 Requirements

#### Server Requirements

| Component      | Minimum | Recommended |
| -------------- | ------- | ----------- |
| **PrestaShop** | 1.7.0   | 8.x         |
| **PHP**        | 7.4     | 8.2+        |
| **TLS**        | 1.2     | 1.3         |

#### PHP Extensions

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

#### PrestaShop Requirements

* SSL certificate (required for production environment)
* Friendly URL must be enabled
* Supported currencies must be active

***

### 🚀 Installation

#### Method 1: Module Manager (Recommended)

1. Download the module ZIP file
2. Log in to the PrestaShop admin panel
3. **Modules → Module Manager**
4. **Click the Upload Module** button
5. Select and upload the ZIP file
6. **Configure** button

***

#### Method 2: Manual Installation

1. Extract the ZIP file
2. `morposgateway` folder `/modules/` copy to the directory
3. Install the module from the admin panel

***

### ⚙️ Configuration

#### Basic Settings

**Modules → Module Manager → MorPOS → Configure**

| Field         | Description             |
| ------------- | ----------------------- |
| Merchant ID   | Merchant ID             |
| Client ID     | OAuth client identifier |
| Client Secret | OAuth secret key        |
| API Key       | API access key          |

***

#### Environment Settings

* **Test Mode**\
  Uses the sandbox environment, no real transactions are made
* **Form Type**
  * `Hosted` (recommended)
  * `Embedded`

***

### 🔄 Payment Flow

1. Customer creates an order
2. MorPOS payment method is selected
3. Order is validated
4. Customer is redirected to the payment form
5. Payment is completed
6. Callback is received
7. Order status is updated

***

### 🛠️ Development and Debugging

#### Logging

Check PrestaShop logs:

* **Advanced Parameters → Logs**
* **Advanced Parameters → Performance → Debug Mode**

For development environment:

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

### 🔍 Troubleshooting

#### "Payment could not be initiated" Error

1. Check the API credentials
2. Ensure the test mode is set to the correct environment
3. Verify TLS 1.2+ support
4. Ensure the server time is correct
5. Review the log records

***

#### Payment Status Not Updating

1. Check that the Callback URL is accessible
2. Verify the SSL certificate
3. Check Friendly URL settings
4. Inspect Firewall / WAF blocks

***

### 🌐 Internationalization

* Supports Turkish (`tr_TR`)
* English (`en_US`)

***

### 🤝 Contributing

* Fork → Commit → Pull Request
* Compliance with PrestaShop coding standards
* Backward version compatibility

***

### 📄 License

MIT License

***

### 🆘 Support

* Support: <https://morpara.com/support>
* GitHub Issues
* Technical documentation