Magento 2

Scalapay provides a ready-to-install extension for your Magento 2 store.
Plugin Installation
Plugin Configuration
Scalapay Widget

🚧

WARNING!

Scalapay plugin is compatible starting from the 2.2.2 Magento version

⇲ Install your plugin

Please follow the instructions below to install our plugin.

  1. Login via SSH into your server
  2. Go to the Magento root
  3. Enable maintenance mode by runningphp bin/magento maintenance:enable
  4. Download the module by running composer require scalapay/scalapay-magento-2
  5. Enable the module by runningphp bin/magento module:enable Scalapay_Scalapay
  6. Apply database updates by running php bin/magento setup:upgrade
  7. Deploy the static content by running php bin/magento setup:static-content:deploy
  8. Compile the source by running php bin/magento setup:di:compile
  9. Clear the cache by running php bin/magento cache:clean
  10. Disable maintenance mode by running php bin/magento maintenance:disable

✔ Configure your plugin

CONFIGURE AND ENABLE SCALAPAY PLUGIN

To configure and enabled Scalapay plugin, please follow this path: Stores(in left side menu header) → ConfigurationSalesPayment Methods

There you will find a dedicated dropdown section for each of the Scalapay available products: Pay in 3 and Pay in 4.

IMPORTANT!

When the plugin is installed, by Default, all products (PAY IN 3, 4) are Disabled.

You need to:

  • Enter the product tab of your interest (as per contractual terms)
  • Enable the product
  • Configure it and test the plugin (for the configuration please, keep reading the document)
  • Once the testing phase is completed, you will be provided with the Live API Key and you will be able to activate the plugin in Live mode.

PLEASE NOTE
Only product agreed as per contractual terms can be activated.
For any information or clarifications about the actionable products, please refer to your Scalapay Sales referent.

Each product section features settings that allow you to configure, test and then activate in live mode the plugin.

Enable disable Scalapay in live mode
The Test API key is present by Default and will allow you to test the correct plugin functioning.
Once the testing phase is completed, you will be provided with the Live API Key and you will be able to activate the plugin in Live mode.

Enable disable Delayed capture
The plugin features the Delayed Capture option, this feature can be activated per product

Scalapay Maximum amount and Scalapay minimum amount
These fields allow you to adjust the default minimum and maximum amount, according to your contractual terms. The minimum amount for displaying the Scalapay plugin and accepting payments is set to 5€.

Category restrictions
This field allows you to select the categories you want Scalapay to be activated on (we suggest that you activate Scalapay on all categories)

Product type restrictions
This field allows you to select the product categories you want Scalapay to be activated on

Payment Applicable From
The only authorized countries are Austria, Belgium, Holland, Finland, France, Germany, Italy, Portugal, Spain

PLEASE NOTE that the only authorized currency is EURO

❤ Scalapay Widget

To configure and customize Scalapay widget, please follow this path: Stores(in left side menu header) → ConfigurationSalesScalapay

There you will find a dedicated dropdown section for each of the Scalapay available products: Pay in 3 and Pay in 4.

This section allow you to configure and customize Scalapay widget in Product page, Cart Page and Checkout Page.

🚧

Product page - Price selectors

Price selctors field is used to add class or combination of class pairs to get the final product price on which to apply Scalapay installments.

To identify and set correct selectors, inspect the price element to retrieve the correct price class name. You can also add multiple price selectors by separating them with commas.

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 third box Product Page - Price Box Selector when prices are loaded by ajax. We recommend using the selector that doesn’t change dynamically.

CHECKOUT PAGE SETTINGS

The settings in this section allow you to customize Scalapay widget in Checkout page.

  • Price selectors and Widget position are set as Default. If your theme is customized, please verify what the correct selectors are.
  • Show title and Hide installment amount fields allow you to customize the checkout visualization as follows

Show title Enable, Hide installment amount Disable (Default settings)

Show title Enable, Hide installment amount Enable

Show title Disable

 

 

“In Page Checkout” feature

The “In page checkout” gives customers the possibility to finalize the Scalapay payment steps in a pop-up, without being redirected outside the merchant’s site. Below you can find the steps to configure this feature.
This feature is available only for Magento 2.4.4 or higher versions.

Visit the Scalapay - In Page Checkout tab, open the accordion and select “Yes” value from the “Enabled” list. Save the Configuration clicking on the orange button and then clean the properly Magento cache layer (the Configuration one).

FieldValueRequiredEditable
EnabledY/NYY
Checkout Place Order Button SelectorHTML selectors (pre-filled with default selector)YY

change if a different Place Order Button selector is used
Scalapay Place Order Button Wrapper StyleCSS inline style to manage the button dimensionNY