Magento 2: Installation Guide For QPAY Checkout Page

Magento 2: Installation Guide For QPAY Checkout Page

The installation guide shows the step-by-step installation of the plugin to the installed shop system on a web server. Test the online shop and the plugin’s configuration on a test system before installing the plugin on a production system.

Step 1

The installation needs to be done in the command line. Download the plugin via composer.

composer require qenta/magento2-qcp

The plugin can be installed via command line:

Command line

php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy
php bin/magento cache:clean

Magento 2 Setup Wizard

Navigate to System > Web Setup Wizard > Component Manager.

chown -R www-data:www-data .
To receive a notification when a new version is published, subscribe here and select Releases only.

Step 2

Navigate to Stores > Configuration > Sales > QENTA Checkout Page.

For a basic configuration enter customer ID, shop ID, and secret and set the URL to imprint page. Go over the settings and configure the plugin according to the requirements. Refer to the section advanced configuration for a more detailed description of the configuration possibilities.

Step 3

To enable the payment methods navigate to Stores > Configuration > Sales > Payment Methods.

To verify the installation check if all selected payment methods are shown at checkout.

Advanced Configuration

As described in Step 2 the plugin allows for some additional customization.

Plugin Modes

  • Demo: Demo mode configuration. No communication with the financial service provider but only between the online shop and the QENTA Checkout Server.

  • Test: During test mode, there is communication between the online shop and a test bank or demo bank provided for this purpose by the relevant financial service provider. However, the payment process is only simulated and no money is transferred.

  • Production: Make sure all of the tests were properly executed before switching to Production mode.

Additional Settings

  • Automated deposit: To prevent the expiration of uncaptured payments, select the feature that enables an automated deposit and day-end closing of payments. Contact our sales teams to enable it; otherwise, an error message will be shown.

  • Payment method sort order: The payments can be sorted in the order of the "Payment method sort order" and the payment with the smallest number entered in this field will be displayed first. Sort the payment methods according to which ones are mostly used by consumers.

Device Detection

If this feature is enabled the plugin automatically identifies the consumer device (either desktop, smartphone, or tablet). If a mobile device is identified, the corresponding request parameter layout is automatically set to the value tablet or smartphone, and QENTA Checkout Page is optimized for the corresponding mobile device.

To improve usability for smartphones and tablets, the plugin automatically disables the embedding in an iframe on tablets and smartphones and redirects the consumer to QENTA Checkout Page. After the payment process is completed, a consumer is redirected to an online shop.

Enabling input field "Date of Birth"

For using payment methods "invoice" or "installment" the input field "date of birth" must be enabled in the Magento configuration. Go to Stores > Configuration > Customers > Customer Configuration > Name and Address Options, and set Show Date of Birth to Required.

"Invoice" or "installment" is only visible if the criteria defined in the contract concluded with the relevant financial Institution (e.g. payolution) are met. For more information, check the payment method-specific documentation for the invoice/installment provider:

Order with obligation to pay is not translated because the text is cached. Delete the file pub/static/frontend/Magento/luma/[YOUR_LANGUAGE]/js-translation.js. For example, German [YOUR_LANGUAGE] would be de_DE.