Shopware v6

Scalapay offers a ready-to-install extension for Shopware v6 stores.

Plugin installation
General settings
Restriction settings
Language and Currency settings
Widget configurations

Plugin installation

Download the latest and correct version and follow the steps below.

You can download the official Shopware 6 plugin from our CDN:

For Shopware >= 6.7 (active support): download the latest zip file from here
For Shopware >= 6.5 AND < 6.7 (maintenance mode): download the specific v2.1.x zip file from here
For older Shopware 6 versions (no more supported): download the latest zip file from here

Log in to your admin backend
From the left-hand menu, select Extensions > My extensions > Upload extension
Click on “Upload extension” to upload the Scalapay plugin

Click on "Install" to install the plugin
Click on "Configure" to configure the Scalapay plugin settings
After successful installation, click on the "Active" button to make it active for that site
To enable Scalapay as a payment method, go to Settings > Shop > Payment methods

General settings

This section contains the plugin's general settings, and the Live API key can be added once the plugin has been correctly installed, configured, and tested.

Select the Enabled/Disabled option from the dropdown menu to show or hide Scalapay.

Select the Live/Test mode to switch from production to staging. Scalapay is in **test mode** by default. The test API key is already inserted.

Merchant token
When the plugin is installed, the general test merchant token is set by default: 8KDS3SPEL.
Once the testing phase has been completed, the Live merchant token will be provided, allowing activation of the plugin in Live mode. The merchant token can be found on the Scalapay Merchant Portal, in the "Developer" section.
API mode
The API mode is set to "Test" by default. Before activating Scalapay, the mode needs to be switched from "Test" to "Live".
Staging/Test API key
When the plugin is installed, the general test API key is set by default: qhtfs87hjnc12kkos.
Live API key
Once the testing phase has been completed, the Live API key will be provided, enabling activation of the plugin in Live mode. The Live API key can be found on the Scalapay Merchant Portal, in the "Developer" section.

Here is the list of all configurations that allow setting up, testing, and then activating the plugin in Live mode.

Restriction settings

Scalapay minimum order amount and Scalapay maximum order amount
These fields allow adjustment of the default minimum and maximum amounts, according to contractual terms. The minimum amount for displaying the Scalapay plugin and accepting payments is set to 5€.

Language and Currency settings

Country settings: enable for following countries
Select the countries where Scalapay should appear.
The authorised countries are Austria, Belgium, Finland, France, French Guiana, Germany, Guadeloupe, Italy, Martinique, Mayotte, Netherlands, Portugal, Réunion and Spain.
Language settings: enable for following languages
Select the languages in which Scalapay should appear.
Currency settings: enable for following currencies
The only authorised currency is: Euro.

Widget configurations

There are two sections available to correctly configure the settings related to the Scalapay widget on the product page and on the cart page.

1. Product page settings

The settings in this section allow customisation of the Scalapay widget on the Product page.

Price selectors and Widget position
These fields are set by default. If the theme is customised, it is recommended to verify the correct selectors.
Hide instalment amount
This field enables hiding of the individual instalment amount.
Hide widget
This field is available but its use is not recommended, as the Scalapay widget is an important asset for increasing conversion rates and average order value.
Dark mode
This field enables a version of the widget optimised for dark backgrounds. Selecting "System" allows the widget to automatically detect the device or browser's dark mode and adjust accordingly.
Alignment
This field allows selection of the widget alignment: left, center, or right.
Hide "Learn more"
This field is available but its use is not recommended, as it is important to provide complete information.

2. Cart page settings

The settings in this section allow customisation of the Scalapay widget on the Cart page.

Price selectors and Widget position
These fields are set by default. If the theme is customised, it is recommended to verify the correct selectors.
Hide instalment amount
This field enables hiding of the individual instalment amount.
Hide widget
This field is available but its use is not recommended, as the Scalapay widget is an important asset for increasing conversion rates and average order value.
Dark mode
This field enables a version of the widget optimised for dark backgrounds. Selecting "System" allows the widget to automatically detect the device or browser's dark mode and adjust accordingly.
Alignment
This field allows selection of the widget alignment: left, center, or right.
Hide "Learn more"
This field is available but its use is not recommended, as it is important to provide complete information.