User Tools

Create PDF

Site Tools

Wirecard Shop Plugin for Magento 2

Installation guide for Wirecard Checkout Seamless

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.

Step 1

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

composer require wirecard/magento2-wcs

There are two ways the plugin can be enabled, via command line or in the Magento 2 Setup Wizard.

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

# Depending on your server configuration you might want to use the following command
chown -R www-data:www-data . 

Step 2

Next you need to navigate to “Stores” → “Configuration” → “Sales” → “Wirecard Checkout Seamless”.

For a basic configuration enter your customer ID, shop ID and your secret and set the URL to imprint page. You can additionally go over the settings and configure the plugin according to your requirements. Please refer to the section advanced configuration for a more detailed description about the configuration possibilities.

Step 3

To enable the payment methods navigate to “Stores” → “Configuration” → “Sales” → “Payment Methods”.

To verify the installation please 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 your financial service provider but only between your online shop and the Wirecard Checkout Server.
  • Test”: During test mode there is communication between your 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 your tests were properly executed before you switch to production mode. After successful testing you can change the plugin mode to “Production”.

Additional settings

Automated deposit: To prevent the expiration of uncaptured payments you may select this feature which enables an automated deposit and day-end closing of payments. Please contact our sales teams to enable this feature. If you select this feature without previous enabling you will get an error message.

Payment method sort order: The payments can be sorted in the order of the “Payment method sort order”. The payment with the smallest number entered in this field will be displayed first. You may take into consideration which payments are mostly used by your consumer and which payments you want your consumers to use and thus sort the payment methods accordingly.

Enabling input field "Date of Birth"

To use the payment methods “invoice” or “installment” you may want to enable for the convenience of your consumers the input field “date of birth” in your Magento configuration. To enable the field please navigate to “Stores” → “Configuration” → “Customers” → “Customer Configuration” → “Name and Address Options” and set “Show Date of Birth” to “Required”.

“Invoice” or “installment” are only visible if the criteria defined in your contract concluded with the relevant financial institution (e.g. payolution or RatePAY) are met. For more information please check the payment method specific documentation for your invoice / installment provider:

If you do not enable the input field “date of birth”, your consumers will be asked to enter their birth date during the checkout.


Why is the “Order with obligation to pay” text 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.

This website uses cookies to deliver the best service to you. By continuing to browse the site, you are agreeing to our use of cookies.