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

# WooCommerce

[![WordPress Plugin Version](https://img.shields.io/badge/WordPress-6.0%2B-blue.svg)](https://wordpress.org/) [![WooCommerce](https://img.shields.io/badge/WooCommerce-7.0%2B-purple.svg)](https://woocommerce.com/) [![PHP Version](https://img.shields.io/badge/PHP-7.4%2B-777bb4.svg)](https://php.net/) ![License](https://img.shields.io/badge/license-MIT-blue.svg)

**MorPOS for WooCommerce**, is a secure and easy-to-use payment gateway plugin that integrates the Morpara MorPOS payment system with WooCommerce stores.\
Customers are redirected to a secure **Hosted Payment Page (HPP)** flow when completing their orders.

***

### 📥 Download Plugin

**You can install the MorPOS WooCommerce plugin on your WordPress infrastructure by searching for "MorPOS WooCommerce" under Plugins -> Add New.**\
**For manual installation, you can download it from the link below.**

[**Download Plugin**](https://github.com/morpara/morpos-woocommerce/archive/refs/heads/main.zip) ✅

> Note: The ZIP file is suitable for the WordPress admin panel or manual installation.

***

### ✨ Features

* 🛒 WooCommerce Integration
* 🔒 Secure Payments (Hosted Payment Page)
* 🏗️ WooCommerce Blocks Support
* 🌍 Multiple Currency (TRY, USD, EUR)
* 💳 Multiple Payment Options (Credit card, debit card, installment payment)
* 🧪 Sandbox Mode
* 🔧 Easy Configuration
* 🛡️ Security Features (TLS 1.2+, signed API communication)

***

### 📋 Requirements

#### Server Requirements

| Component   | Minimum | Recommended |
| ----------- | ------- | ----------- |
| WordPress   | 6.0     | 6.8+        |
| WooCommerce | 7.0     | 10.0+       |
| PHP         | 7.4     | 8.2+        |
| TLS         | 1.2     | 1.3         |

#### PHP Extensions

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

#### WordPress Features

* WooCommerce installed and active
* Pretty Permalinks enabled
* SSL certificate (recommended for production)

***

### 🚀 Installation

#### WordPress.org Repository

1. WordPress dashboard → **Plugins → Add New**
2. Search for "MorPOS for WooCommerce"
3. **Install Now → Activate**

#### WP-CLI

```bash
wp plugin install morpos-gateway --activate
```

#### Manual Installation

1. Download the ZIP file: Download Plugin
2. WordPress → **Plugins → Add New → Upload Plugin → Choose File**
3. Select the ZIP file → **Install Now → Activate**

***

### ⚙️ Configuration

1. **WooCommerce → Settings → Payments → MorPOS**
2. Fill in the required fields:

| Field         | Description          | Example              |
| ------------- | -------------------- | -------------------- |
| Merchant ID   | Merchant ID          | 12345                |
| Client ID     | OAuth client ID      | your\_client\_id     |
| Client Secret | OAuth client secret  | your\_client\_secret |
| API Key       | API verification key | your\_api\_key       |

3. **Environment Settings**

* Test Mode: Uses Sandbox, no real transactions are made
* Form Type: `Hosted` (recommended) or `Embedded`

4. **Connection Test**

* After entering the credentials **Test Connection**
* A green confirmation should appear

***

### 🛠️ Debugging and Logs

```php
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
```

Logs `/wp-content/debug.log` are written to the file.

#### Common Issues

* Payment cannot be initiated → Check credentials, TLS 1.2+
* Payment is not processed → Check currency and amount limits
* Payment page error → Check pretty permalinks and WooCommerce installation

***

### 🌐 Internationalization

* Supports Turkish (`tr_TR`) and English (`en_US`)
* POT and JSON translation files can be generated with WP-CLI

***

### 🤝 Contributing

1. Fork the repository → Make changes → Submit a pull request
2. Test WordPress/WooCommerce compatibility

***

### 📄 License

MIT License. For details, see LICENSE

***

### 🆘 Support

* Documentation
* [GitHub Issues](https://github.com/morpara/morpos-woocommerce/issues)
* [WordPress Support Forum](https://wordpress.org/support/plugin/morpos-gateway/)
* [Morpara Support](https://morpara.com/support)