Plugin Installation & Configuration

Follow these steps to install the plugin!



Once you have installed and configured the plugin, be sure


Simply upload “Scalapay” plugin folder into custom plugins folder on the server.

  1. Login to your admin backend
  2. Select Settings --> System --> Plugins
  3. Upload folder
  1. After a successful installation, activate your Scalapay plugin
  1. Click on "config" to update plugin settings
  2. Clear cache on Settings --> Caches & indexes
  3. To enable Scalapay as a payment method, go to Settings --> Shop --> Payment


Follow this paragraph to learn how to correctly configure your Shopware plugin

Scalapay enabling settings

Select Enabled/Disabled option on dropdown menu to show or hide Scalapay. Scalapy is enabled by default.
Select Live/Test mode to switch from production to staging. Scalapay is in test mode by default. Test API key is already inserted



Live mode

When LIVE mode is active, a LIVE Api key must be present and active in its proper box. Scalapay won't work if the api key is absent or inactive

Widget configuration

On the settings page, there are many options available to correctly customize and implement our Scalapay widget on product and cart page.

Custom CSS

Sometimes external tags like div, p or span tags styles override our default styles. To handle these types of issues you can use the Custom CSS field to facilitate design processes. You can also use it to define inline style classes, such as font, size or alignment. These styles will apply for Scalapay description across all pages: product, cart and checkout pages.

Product and Cart Page settings

You could customize Scalapay description on Product and Cart pages in the following ways:

● Display as a text instead of a logo (not recommended)
● The text size
● The logo size and alignment
● The price color (not recommended according to Scalapay brand identity)
● The logo color (not recommended according to Scalapay brand identity)

Product and Cart Page details

Follow these steps to configure the widget on the product page and cart. Find more information about our widget here.
The Price Selectors field is used to add class or combination of class pairs to get the final product price on which to apply Scalapay installments.

  • Inspect the price element to retrieve the correct price class name


To select the correct price to use for the installment calculation add the appropriate selectors in the Product Page - Price Selectors box.
To add new price css selector add new selectors in order of priority to use. Find all your price selectors (normal price, special price etc) and paste them in the box, separated by comma.
Use the second box Product Page - Price Selector when prices are loaded by ajax. We recommend using the selector that doesn’t change dynamically.


To change Scalapay widget position change the css selector in Product Page - Text Position text area. It will show Scalapay description after the css selector.

Checkout Page settings

By Default, Scalapay description is already set on the Checkout page. No changes are needed. However if you want to update the text you can simply go to module files located at modules/scalapay/translations/, edit the file and save after updating text.

Scalapay restriction settings

Set minimum and maximum Scalapay amount

In Scalapay plugin configuration, a minimum and maximum amount are set, as default, for displaying and authorizing Scalapay payment on your e-commerce platform.
The minimum amount for displaying the Scalapay plugin and accepting payments is set to 5€. This amount cannot be modified.
Set the maximum amount based on your contract..


Set Scalapay authorized countries and languages

In Scalapay module configuration, you can set authorized countries, languages and currencies.

Be aware that:
● The only authorized countries are Austria, Belgium, Holland, Finland, France, Germany, Italy, Portugal, Spain. Contact your account manager for more information.
● The only authorized currency is Euro.
● Enable the languages according to the countries you operate in.


Now it's time to test your plugin!