QPay Debit Card Payments - Magento 2
Overview
QPay (STS PayOne EZ Connect) Payment Gateway - Magento 2 is an online payment solution that can be integrated with Magento 2 eCommerce store. The gateway allows store owners from Qatar to accept online payments from debit card users (Debit Card in Qatar)
The extension will collect all the need information from customer then send to payment gateway system without using the customer browser.
STS PayOne EZ Connect is a payment gateway for Magento 2 stores based in the Middle East and Africa region. It allows you to accept transactions from debit card, it’s using EZ-Connect interface to perform e-Commerce through PayOne Payment Gateway.
This extension does not store any card details on merchant’s website.
Requirements:
Qatar National Payment Gateway (QPAY) will provide to merchant with the login credentials to access Merchant's Portal
- Merchant is contracted with Payment Gateway as an e-Commerce Merchant using EZ-Connect integration interface.
- Merchant is provided with a User Profile on Payment Gateway in order to generate unique Secret Key used for integration.
Currency support:
USD, QAR
Used Credentials:
Merchant ID, Bank ID, Secret Key
Features of QPAY (PayOne EZ Connect) Payment Gateway - Magento 2
- Direct your customers to QPay Payment Page during the checkout process. Once they’ve paid, they’ll be redirected back to your website.
- Accepted Debit card.
- Secure checkout process.
- Capture new sales.
- Create Invoice automatically.
- Update transactions automatically.
- Refund Online/Offline.
- Support multiple websites and stores.
- Cron job used for updating the transactions
- Allow enabling or disabling Debug.
- Encrypted the payment credentials.
- Unlimited domains.
Installation
Create folder structure inside the Magento main folder: app/code/PL/Qpay/
Extract module files into that folder and execute the following commands:
php bin/magento setup:upgrade
php bin/magento setup:static-content:deploy -f
php bin/magento cache:clean
Example

Verify whether the module has been successfully installed. Log in to Magento Admin dashboard and go to Stores > Configuration > Sales > Payment Methods. Settings of the QPay (STS PayOne EZ Connect) Payment Gateway module should be there under the name "QPay Payment Gateway (PayOne EZ Connect)"
Configuration steps
Please follow these steps to configure the module:
- Login to Magento Admin dashboard
- Go to Stores > Configuration > Sales > Payment Methods
- Expand OTHER PAYMENT METHODS, then QPay Payment Gateway (PayOne EZ Connect)
- Fill in configuration details as described below
- Click Save Config to store the configuration.
- Follow Magento instructions and clean application cache, to make sure that the new payment method is immediately available in your online store
Configuration details
- Enabled: should be set to YES to make QPay Payment Gateway (PayOne EZ Connect) available as a payment method on the checkout page.
- Title: Name of the payment method displayed on the checkout page
- Bank ID: Bank ID is provided by QPAY
- Merchant ID: Merchant ID is provided by QPAY
- Secret Key: Secret Key is provided by QPAY
- Debug: Set the option to YES if you want all communication between Magento and the Gateway to be logged into the var/log/pl/qpay.log file. It usually uses for the Developer to troubleshoot problems if the Payment Method doesn't work.
- Payment from Applicable Countries: countries from which customers are allowed in your online store
- Payment from Specific Countries: This option is available if Payment from Applicable Countries option is set to the Specific Countries mode. It's possible to choose a few countries for whose the Payment Method will be available. The billing address is used to identify the country on the Checkout Page/
Test Environment
Failed Test Card:
PAN 4151801200003960 Expiry date: any
Successful Test Card:
PAN 4215375500883243 Expiry date: any
Release Notes
Version 2.0.6
Released on April 21, 2023
- Removed Redirect Pay URL and Inquiry and Refund URL from Configuration section.
- Added Test Mode option
- Added plugin for SameSite issue
Version 2.0.5
Released on July 18, 2022
- Added notification when the new version is available
Version 2.0.4
Released on August 2, 2021
- Fixed SameSite cookies issue
Version 2.0.3
Released on July 16, 2020
- Added Refund, CronJob features
- Stability improvements.
Version 2.0.2
Released on August 19, 2019
- Stability improvements.
Version 2.0.1
Stable version. Released on July 23, 2019
FAQs
Will the QPay Debit Card Payments plugin work for credit and debit card?
After clicking on Continue Payment button at Checkout page, it was redirected to a page with error message "MERCHANT_IP_NOT_SUPPORTED_ERR". What is the issue?
Sometimes, I encounter the issue like the money deducted from my account, but why is the order status still in Pending Payment from the Magento admin panel?
Does it support QNB bank in Qatar?
Customer Reviews
-
Great Experience, highly recommended
The module is exactly what I am looking for.
I have already purchased few times from Polacin and they are responsive enough. I am really surprised with the service provided.Review by Ashraf Issa (Posted on 9/25/2023)
