Scalapay fournit une extension prête à l’installation pour les boutiques Magento 2.
Vous trouverez toutes les instructions pour télécharger et installer notre plugin au lien suivant : https://developers.scalapay.com/docs/magento-2-plugin
📘 COMPATIBILITÉ
Le plugin Scalapay est compatible à partir de la version 2.2.2 de Magento.
❤ Installation du plugin
Veuillez suivre les instructions ci-dessous pour installer notre plugin.
Connectez-vous via SSH à votre serveur
Allez à la root de Magento
Activez le mode maintenance en lançant
php bin/magento maintenance:enableTéléchargez le module en lançant
composer require scalapay/scalapay-magento-2Activez le module en lançant
php bin/magento module:enable Scalapay_ScalapayAppliquez les mises à jour de la base de données en lançant
php bin/magento setup:upgradeDéployez le contenu statique en lançant
php bin/magento setup:static-content:deployCompilez le code source en lançant
php bin/magento setup:di:compileVidez le cache en lançant
php bin/magento cache:cleanDésactivez le mode maintenance en lançant
php bin/magento maintenance:disable
❤ Configurer le plugin
Pour configurer et activer le plugin Scalapay, suivez ce chemin :
Stores (dans le menu latéral) → Configuration → Sales → Payment Methods. Vous trouverez une section drop-down dédiée à Scalapay.
❤ General settings
Ici, vous trouverez les paramètres généraux du plugin et vous pourrez ajouter la Live API Key une fois que le plugin aura été correctement installé, configuré et testé.
Enable/disable Scalapay in Live mode (Activez/désactivez Scalapay en mode Live)
La Test API Key est présente par défaut et vous permettra de tester le bon fonctionnement du plugin.
Une fois la phase de test terminée, vous recevrez la Live API Key et pourrez activer le plugin en mode Live.Test API key
Lors de l’installation du plugin, la clé API de test générale est définie par défaut : qhtfs87hjnc12kkos.Test merchant token
Lors de l’installation du plugin, le token marchand de test général est défini par défaut : 8KDS3SPEL.Live merchant token
Une fois la phase de test terminée, vous recevrez le Live merchant token et pourrez activer le plugin en mode Live. Vous trouverez votre merchant token dans votre Scalapay Merchant Portal, dans la section "Developer".Live API key
Une fois la phase de test terminée, vous recevrez la Live API key et pourrez activer le plugin en mode Live. Vous trouverez votre Live API key dans votre Scalapay Merchant Portal, dans la section "Developer".Enable/disable Delayed capture
Le plugin propose l’option Delayed capture : cette fonctionnalité peut être activée produit par produit.
❤ Payment configurations
Voici la liste de toutes les configurations qui vous permettent de configurer, tester puis activer le plugin en mode Live.
Scalapay Minimum amount et Scalapay Maximum amount
Ces champs vous permettent d’ajuster le montant minimum et maximum par défaut, selon vos termes contractuels.
Le montant minimum pour afficher le plugin de Scalapay et accepter les paiements est fixé à 5€.Disable Scalapay for specific countries
Sélectionnez les pays où vous ne souhaitez pas que Scalapay apparaisse.
Les pays autorisés sont : Autriche, Belgique, Finlande, France, Guyane française, Allemagne, Guadeloupe, Italie, Martinique, Mayotte, Pays-Bas, Portugal, Réunion et Espagne.Disable Scalapay for specific categories
Ce champ vous permet de sélectionner les catégories de produits dans lesquelles vous ne souhaitez pas que Scalapay apparaisse.
❤ Widget configurations
Cette section vous permet de configurer et personnaliser le widget Scalapay sur la page Produit, la page Panier et la page Checkout.
1. Product page settings
Les paramètres de cette section vous permettent de personnaliser le widget de Scalapay sur la page Produit.
Widget amount selectors et Widget position
Ces champs sont définis par défaut. Si votre thème est personnalisé, veuillez vérifier les bons sélecteurs.Hide widget
Ce champ est disponible mais nous recommandons de ne pas l’utiliser car le widget de Scalapay est un atout très important pour augmenter la conversion et la valeur moyenne des commandes.
📘 Price selectors
Le champ Price selectors est utilisé pour ajouter une classe ou une combinaison de classes afin d’obtenir le prix final du produit auquel appliquer les mensualités Scalapay.
Pour identifier et définir les bons sélecteurs, inspectez l’élément prix pour récupérer le nom correct de la classe. Vous pouvez également ajouter plusieurs sélecteurs de prix en les séparant par des virgules.
Pour ajouter un nouveau sélecteur CSS de prix, ajoutez les nouveaux sélecteurs dans l’ordre de priorité. Trouvez tous vos sélecteurs de prix (prix normal, prix spécial, etc.) et collez-les dans le box, séparés par une virgule.
2. Cart page settings
Les paramètres de cette section vous permettent de personnaliser le widget de Scalapay sur la page Panier.
Widget amount selectors et Widget position
Ces champs sont définis par défaut. Si votre thème est personnalisé, veuillez vérifier les bons sélecteurs.Hide widget
Ce champ est disponible mais nous recommandons de ne pas l’utiliser car le widget Scalapay est un atout très important pour augmenter la conversion et la valeur moyenne des commandes.
3. Checkout page settings
Les paramètres de cette section vous permettent de personnaliser le widget Scalapay sur la page du checkout.
Widget amount selectors
Ce champ est défini par défaut. Si votre thème est personnalisé, veuillez vérifier les bons sélecteurs.
Go Live!
📘 REMINDER
Avant de passer en mode Live avec Scalapay, nous vous recommandons de tester votre intégration en passant au moins une commande test.
Connectez-vous au Scalapay Merchant Portal : dans la section "Developer", vous trouverez votre Live API key (commençant par sp_) et votre Live merchant token. Vous recevrez vos identifiants de connexion par email de la part de votre Integration Manager de Scalapay.
Dans le backend de Magento 2, allez dans Stores (menu latéral) → Configuration → Sales → Payment Methods : désactivez le mode Test et cliquez sur Save Config.
3. Activez le mode Live, saisissez le Production (Live) merchant token et la Production (Live) API key dans les champs correspondants. Vous trouverez tous les deux dans le Scalapay Merchant Portal, dans la section "Developer".
4. Cliquez sur Save Config et vérifiez votre site web !