Download the PHP package morpara/morpos-magento2 without Composer

On this page you can find all versions of the php package morpara/morpos-magento2. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Example code of morpara/morpos-magento2

Informations about the package morpos-magento2

MorPOS Payment Gateway for Magento 2

Magento Version PHP Version

MorPOS Payment Gateway for Magento 2 is a secure and easy-to-use payment gateway extension that integrates the Morpara MorPOS payment system with Magento 2 stores. Customers can complete their orders through a secure Hosted Payment Page (HPP) flow or use an Embedded Payment Form for a seamless checkout experience.

✨ Features

📋 Requirements

Server Requirements

Component Minimum Recommended
Magento 2.2 2.4.8
PHP 7.2 8.1+
TLS 1.2 1.3

PHP Extensions

Magento Features

🚀 Installation

Method 1: Via Composer (Recommended)

  1. Require the Package

  2. Enable the Module

  3. Run Setup Commands

Method 2: Manual Installation

  1. Download the Module

  2. Extract to Magento

  3. Enable the Module

  4. Run Setup Commands

Method 3: FTP Upload

  1. Download the module files from GitHub
  2. Extract the ZIP file
  3. Using your FTP client, upload the contents to app/code/MorPOS/PaymentGateway/
  4. Connect to your server via SSH and run the setup commands from Method 2

⚙️ Configuration

1. Access Settings

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

2. Required Settings

Fill in the following mandatory fields:

Field Description Example
Merchant ID Your unique merchant identifier from MorPOS 12345
Client ID OAuth client identifier from MorPOS your_client_id
Client Secret OAuth client secret from MorPOS your_client_secret
API Key Authentication key for API requests your_api_key

Where to get credentials? Contact Morpara Support or visit MorPOS Documentation to obtain your merchant credentials.

3. Environment Settings

Sandbox Mode

Form Type Choose your payment interface:

Order Status Settings

Advanced Settings

4. Connection Test

After entering credentials:

  1. Click Test Connection button in the admin panel
  2. Wait for the connection test to complete
  3. Verify success message appears
  4. If test fails, check credentials and sandbox mode setting

5. Enable the Payment Method

🔧 Payment Flow

Customer Checkout Process

  1. Cart Review: Customer reviews items in cart
  2. Checkout: Customer proceeds to checkout
  3. Payment Selection: Customer selects MorPOS as payment method
  4. Payment Initiation:
    • System validates cart and creates order
    • Payment session initiated with MorPOS API
    • Unique conversation ID generated for tracking
  5. Payment Processing:
    • Hosted Mode: Customer redirected to MorPOS payment page
    • Embedded Mode: Payment form loads in modal popup
  6. Payment Completion:
    • Customer completes payment
    • MorPOS sends callback to store
    • Order status updated automatically
  7. Confirmation: Customer sees success/failure page

Security Features

The module implements multiple security layers:

Content Security Policy (CSP)

The module automatically whitelists MorPOS domains for iframe embedding:

No additional CSP configuration is required.

💳 Test Cards

Test Cards (Sandbox Mode Only):

Refer to MorPOS Documentation for test card numbers and sandbox testing guidelines.

Testing Checklist:

🔍 Troubleshooting

Common Issues

Payment method not showing at checkout

Causes & Solutions:

  1. Module Not Enabled

    • Check that the module is enabled: Stores → Configuration → Sales → Payment Methods
    • Verify "Enabled" is set to "Yes"

  2. Currency Not Supported

    • Verify currency is supported (TRY, USD, EUR only)
    • Configure your store to use one of the supported currencies

  3. Order Total Restrictions

    • Check minimum/maximum order total settings
    • Ensure order total falls within configured range

  4. Country Restrictions

    • Verify country restrictions in configuration
    • Check customer's billing country is allowed
  5. Cache Issues
    • Clear cache: php bin/magento cache:flush
    • Clear generated files: rm -rf generated/code/*

"Unable to initialize payment" error

Causes & Solutions:

  1. Incorrect Credentials

    • Verify Merchant ID, Client ID, Client Secret, and API Key
    • Use Test Connection feature to validate

  2. Environment Mismatch

    • Ensure Sandbox Mode setting matches your credentials (test vs production)

  3. TLS Requirements

    • Server must support TLS 1.2 or higher
    • Check OpenSSL version: php -r "echo OPENSSL_VERSION_TEXT;"
  4. cURL Issues
    • Verify cURL extension is installed: php -m | grep curl

Order not created after successful payment

Causes & Solutions:

  1. Callback URL Issues

    • Check callback URL is accessible from internet
    • Verify server firewall allows incoming connections from MorPOS

  2. Quote Expiration

    • Ensure quote has not expired during payment process
  3. Server Errors
    • Review logs for callback processing errors
    • Check var/log/system.log for details

Connection Test Fails

  1. Firewall/Network Issues

  2. DNS Resolution

  3. Server Time
    • Ensure server time is accurate (NTP recommended)

Logging

The module logs to Magento's standard logging system:

Enable Detailed Logging:

Check Logs:

🌐 Internationalization

The module supports multiple languages:

Adding New Translations

  1. Create Language File:

  2. Translate Strings: Edit the CSV file and translate the strings

  3. Deploy Static Content:

📁 Developer Information

Module Structure

Database Tables

Table Description
morpara_morpos_conversation Tracks payment attempts and status

Events

The module integrates with Magento's standard payment events and does not dispatch custom events.

API Endpoints

Endpoint Method Description
/morpos/payment/start POST Initiates payment session
/morpos/payment/callback POST Handles MorPOS callbacks
/morpos/payment/success GET Success redirect handler
/morpos/payment/cancel GET Cancel redirect handler

🤝 Contributing

We welcome contributions! Here's how to get started:

Development Setup

  1. Fork the Repository

  2. Set Up Local Environment

    • Install Magento 2 locally
    • Link or copy module to app/code/MorPOS/PaymentGateway/
    • Enable developer mode: php bin/magento deploy:mode:set developer

  3. Make Changes

    • Follow Magento coding standards
    • Add PHPDoc comments
    • Test thoroughly
  4. Submit Pull Request
    • Create feature branch: git checkout -b feature/your-feature
    • Commit changes: git commit -m "Add your feature"
    • Push to branch: git push origin feature/your-feature
    • Open pull request on GitHub

Coding Standards

Testing Guidelines

Before submitting a pull request, test:

  1. Installation/Uninstallation

    • Clean installation works
    • Uninstallation removes all data
    • Upgrade from previous version

  2. Payment Flows

    • Successful payment (hosted & embedded)
    • Failed payment handling
    • Callback processing
    • Network errors

  3. Multi-Currency

    • TRY, USD, EUR transactions
    • Currency display in admin and frontend
  4. Compatibility
    • Magento 2.2, 2.3, 2.4
    • PHP 7.3, 7.4, 8.0, 8.1, 8.2

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🆘 Support

Documentation

Issue Reporting

Commercial Support

Magento-Specific Issues

🙏 Acknowledgments

🔐 Security

If you discover a security vulnerability, please email [email protected] instead of using the issue tracker. All security vulnerabilities will be promptly addressed.

Security Features

📝 Changelog

Version 1.0.0

Made with ❤️ by Morpara

For more information about MorPOS payment solutions, visit morpara.com or check the documentation.

All versions of morpos-magento2 with dependencies

PHP Build Version
Package Version
Requires php Version >=7.0.0
magento/framework Version >=100.0.0
magento/module-checkout Version >=100.0.0
magento/module-payment Version >=100.0.0
magento/module-sales Version >=100.0.0
magento/module-quote Version >=100.0.0
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package morpara/morpos-magento2 contains the following files

Loading the files please wait ...