Scalapay provides a ready-to-install extension for Magento 2 stores.
You can find all the instructions for downloading and installing our plugin in the following link: https://developers.scalapay.com/docs/magento-2-plugin
📘 COMPATIBILITY
The Scalapay plugin is compatible starting from the 2.2.2 Magento version.
❤ Plugin installation
Please follow the instructions below to install our plugin.
Login via SSH to your server
Go to the Magento root
Enable maintenance mode by running
php bin/magento maintenance:enableDownload the module by running
composer require scalapay/scalapay-magento-2Enable the module by running
php bin/magento module:enable Scalapay_ScalapayApply database updates by running
php bin/magento setup:upgradeDeploy the static content by running
php bin/magento setup:static-content:deployCompile the source by running
php bin/magento setup:di:compileClear the cache by running
php bin/magento cache:cleanDisable maintenance mode by running
php bin/magento maintenance:disable
❤ How do I configure the plugin?
To configure and enable the Scalapay plugin, please follow this path:
Stores (on the left side menu) → Configuration → Sales → Payment Methods
You will find a dedicated drop-down section for Scalapay.
❤ General settings
Here you will find the plugin general settings and you will add the Live API key once the plugin has been correctly installed, configured and tested.
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.Test API key
When you install the plugin, the general test API key is set by default: qhtfs87hjnc12kkos.Test merchant token
When you install the plugin, the general test merchant token is set by default: 8KDS3SPEL.Where can I find the merchant token?
Once the testing phase has been completed, you will be provided with the Live merchant token and you will be able to activate the plugin in Live mode. You will find your merchant token on your Scalapay Merchant Portal, in the "Developer" section.Where can I find the Scalapay Live API key?
Once the testing phase has been completed, you will be provided with the Live API key and you will be able to activate the plugin in Live mode. You will find your Live API key on your Scalapay Merchant Portal, in the "Developer" section.Enable/disable Delayed capture
The plugin features the Delayed capture option: this feature can be activated per product.
❤ Payment configurations
Here's the list of all the configurations that allow you to set up, test and then activate the plugin in Live mode.
Scalapay Minimum amount and Scalapay Maximum 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€.Can I hide Scalapay in certain countries?
Select the countries where you don't want Scalapay to appear.
The authorised countries are Austria, Belgium, Finland, France, French Guiana, Germany, Guadeloupe, Italy, Martinique, Mayotte, Netherlands, Portugal, Réunion and Spain.How to restrict Scalapay to certain categories?
This field allows you to select the product categories in which you don't want Scalapay to appear.
❤ Widget configurations
This section allows you to configure and customise the Scalapay widget on Product page, Cart page and Checkout page.
1. Product page settings
The settings in this section allow you to customise the Scalapay widget on the Product page.
Widget amount selectors and Widget position
These fields are set by default. If your theme is customised, please verify the correct selectors.Hide widget
This field is available but we recommend not to use it as the Scalapay widget is an extremely important asset for increasing conversion and average order value.
📘Price selectors
The Price selectors field is used to add a class or a combination of class pairs to get the final product price to which apply the Scalapay instalments.
To identify and set the 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 a 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 a comma.
2. Cart page settings
The settings in this section allow you to customise Scalapay widget on the Cart page.
Widget amount selectors and Widget position
These fields are set by default. If your theme is customised, please verify the correct selectors.Hide widget
This field is available but we recommend not to use it as the Scalapay widget is an extremely important asset for increasing conversion and average order value.
3. Checkout page settings
The settings in this section allow you to customise the Scalapay widget at checkout page.
Widget amount selectors
This field is set by default. If your theme is customised, please verify the correct selectors.
Go Live!
📘REMINDER
Before going live with Scalapay we recommend to test your integration by placing at least one test order.
1. Login to the Scalapay Merchant Portal: in the Developer section you will find your Live API key (starting with sp_) and your Live merchant token. You will receive your login credentials by email from your Scalapay Integration Manager.
2. In the backend of your Magento 2, go to Stores (on the left side menu) → Configuration → Sales → Payment Methods: disable the Test mode and click on Save Config.
3. Enable the Live mode, enter the Production (Live) merchant token and the Production (Live) API key in the related fields. You find both on the Scalapay Merchant Portal, in the Developer section.
4. Click on Save Config and check your website!