OpenCart: Installation Guide for QPAY Checkout Page

OpenCart: QPAY Installation Guide

This installation guide shows the step-by-step installation of the plugin to your installed shop system on your web server. Please test your online shop and the configuration of the plugin on a test system before installing the plugin on your production system.

Download the plugin

QENTA shop plugins are Open Source. You can download the latest version on our GitHub Page

To receive a notification when a new version is published, subscribe here and select Releases only .

Step 1: Upload

Please log in as Administrator to the administration section of OpenCart. This may be available at

Select Extensions  Installer in the navigation menu on the left. Click Upload and select the .zip file you downloaded here.

Step 2: Install

Then select "Extensions" → "Payments" within the menu. A page displaying all payment methods is opened:

plugin list

All QENTA related payment methods beginning with the name "QENTA" and followed with the name of the payment method are displayed. Click on the plus [ + ] symbol to activate the plugin.

Step 3: Configure

To present a specific payment method to your consumer in your online shop you have to enable and configure that payment method.

Click on the pencil [ ✎ ] symbol to configure and enable the plugin in your shop.

You can configure the following parameters for a specific payment method:

Enable Enables or disables corresponding payment method.

Customer ID

Your Customer ID you received from QENTA


Your secret you also received from QENTA

Success Status

Status for a successfully completed payment of your consumer

Failure Status

Status for a failed payment of your consumer

Cancel Status

Status for a payment canceled by your consumer

Auto Deposit

Activating or deactivating the automated deposit immediately after a successful payment of your consumer. (This parameter has to be enabled by QENTA for your Customer ID.)

Duplicate Request Check

Enables or disables checking if the same order has been unintentionally sent more than once by your consumer. This is useful to prevent processing of the same order more than once, especially if your consumer presses the "Reload" button of the web browser.

Max Retries

Defines the maximum number of retries you consumer can do within one payment. A value of 0 means indefinitely number of retries. (This parameter has to be enabled by QENTA for your Customer ID.)


If enabled the QPAY Checkout Page will be displayed within an iframe in your online shop. Otherwise it will be displayed within the current window of the web browser of your consumer.

Send Customer Information?

Enables or disables the sending of customer data.

Additionally you are able to configure some optional parameters for a specific payment method:

Shop ID

Contains the unique identifier for your shop within the QPAY Checkout Page. (This parameter has to be enabled by QENTA for your Customer ID.)

Background Color

Background color of the QPAY Checkout Pages as hexadecimal RGB-values like ”CCDDAA”.

Logo Url

Optional URL to an image which is used as your online shop logo within the QPAY Checkout Pages.

Display Text

Optional text which is displayed together with the data of the order.

Confirm e-Mail Address

Contains an e-mail address of the merchant for receiving payment information details regarding the orders of the consumers of your online shop. (This parameter has to be enabled by QENTA for your Customer ID.)

Customer Statement

Contains a text which will be displayed on the invoice of financial institution of your consumer.

If you have filled in all values in the form please click on the "Save" Button: The different order-status have to be configured as shown in the screenshot.

plugin config

The status of the payment method is now active and the payment method available in the ordering process of your online shop.


To test your configuration you can use the Test Data provided here.


If you need assistance with installation or configuration QENTA’s integration specialists are here to help!