Passer au contenu principal

Shopify

Comment intégrer Scalapay dans Shopify

Mis à jour cette semaine

Scalapay propose une application native pour Shopify.

Vous trouverez toutes les instructions pour télécharger et installer Scalapay au lien suivant : https://developers.scalapay.com/docs/shopify-plugin

L’installation de Scalapay sur un site Shopify se compose de deux étapes obligatoires :

Vous devrez installer deux applications différentes (une pour le checkout et une pour le widget sur la page produit et la page panier), toutes les deux disponibles sur le Shopify Store. Cela vous permettra de bénéficier de l’ensemble de l’expérience de paiement Scalapay.

Installation et activation de l’application de paiement pour avoir Scalapay au checkout

Vous devez installer l’application en allant dans les Paramètres du menu de gauche de votre interface Shopify.

Allez dans Payments → Additional payment methods → Add payment method. Recherchez Scalapay, cliquez dessus et installez l’application.

Si nécessaire, voici le lien direct :

📘 PRODUIT À ACTIVER

Seulement le produit/les produits convenus selon les termes contractuels peuvent être activés.

Pour toute information ou clarification concernant les produits à activer, vous pouvez consulter les termes de votre contrat, contacter votre interlocuteur commercial Scalapay ou votre Integration Manager.

Lorsque vous cliquez sur « Install », une page Scalapay s’ouvrira et vous devrez entrer votre API key.

Install the Scalapay App to have Scalapay at checkout

Cette API key doit être activée par un Scalapay Integration Manager et elle est disponible uniquement sur votre Scalapay Merchant Portal, dans la section Développeur.

Si vous n’êtes pas encore un Scalapay Merchant, veuillez vous inscrire sur notre site officiel Scalapay.

Enter you API key to activate Scalapay at checkout

📘 SCALAPAY AU CHECKOUT

En raison des configurations de Shopify, Scalapay apparaîtra comme disponible au checkout pour tout montant et toute adresse.

Si un client tente de passer une commande avec un montant supérieur au montant autorisé ou depuis un pays non éligible, un message d’erreur s’affichera et l’achat ne sera pas finalisé.

Il n’est pas possible de personnaliser ce message d’erreur.

Shopify ne permet aucune modification des configurations du checkout.

Shopify - Scalapay widget

Installer l'application pour le widget sur la page produit et la page panier

Téléchargez ici l'application Scalapay pour installer le widget sur la page produit et la page panier : Scalapay widget for Shopify.

Allez dans la section "Apps" de votre interface Shopify, cliquez dessus et tapez "Scalapay" dans la barre de recherche en haut de la page. Sélectionnez le résultat "Scalapay On-Site Messaging" dans la fenêtre pop-up qui apparaîtra.

Install the App to have Scalapay on Product page and Cart page

📘 COMPATIBILITÉ DU THÈME SHOPIFY

Si votre thème Shopify est compatible avec l'application Scalapay On-Site Messaging, vous pouvez cliquer sur les deux premiers boutons pour installer automatiquement le widget sur la page produit et la page panier.

Si votre thème Shopify n’est pas compatible, un message vous en informera. Dans ce cas, cliquez sur le bouton "Use Embed App" et consultez notre guide pour découvrir comment installer le widget sur la page produit et la page panier.

Install the App to have Scalapay on Product page and Cart page

❤ Configurer l'application pour le widget sur la page produit

Le widget Scalapay doit apparaître sur la page produit de tous les articles de votre site eCommerce.

Le texte et le pop-up sont définis par Scalapay, mais certains champs permettent de configurer le widget.

Voici les étapes pour installer le widget Scalapay :

  • Cliquez sur "Add to Product page".

  • L’interface de la page produit apparaîtra.

  • Dans la colonne de gauche, vous trouverez toutes les sections de la page produit, y compris une appelée "Scalapay on-page message" : il s’agit du widget qui apparaîtra sur la page produit et qui contient ses paramètres.

  • Si la section "Scalapay on-page message" n’apparaît pas ou si vous souhaitez en ajouter une nouvelle, cliquez sur "Add block", puis sur "Apps", et vous la trouverez dans la liste.

  • Faites glisser le bloc du widget sous la section "Price" (le prix du produit).

  • En cliquant sur "Scalapay on-page message", un nouveau menu apparaîtra, vous permettant de modifier les paramètres du widget.

  • ENTRER VOTRE MERCHANT TOKEN
    Vous devrez saisir votre Merchant Token dans la section Merchant Token afin d'afficher correctement vos produits Scalapay dans le widget.
    Vous trouverez votre Merchant Token dans votre Scalapay Merchant Portal, dans la section "Developer".

Scalapay widget configurations on Shopify backend

Parameter

Options

Description

Merchant Token

Le Merchant Token doit être ajouté afin d’afficher les produits corrects de Scalapay.

Il est disponible dans le Scalapay Merchant Portal, dans la section "Développeur".

DOM selectors for price

Ajoutez tous vos sélecteurs de prix (normal price, special price etc.) séparés par une virgule ([". current-price-value",". price-selector-2"]).

DOM selectors for granular positioning

Ajoutez le sélecteur CSS pour modifier la position du widget Scalapay (copiez-collez le code).

Countries where widget is enabled

Valeur par défaut (full list of allowed countries): AT, BE, FI, FR, DE, IT, NL, PT, ES, YT, RE, GF, GP, MQ

La liste des codes des pays où le widget sera affiché.

Hide below this price amount

Par défaut : 5 €

Montant minimum pour afficher le widget. Par défaut : 5 €. Veuillez l’adapter selon les conditions de votre contrat.

Hide above this price amount

Par défaut : 2000 €

Montant maximum pour afficher le widget. Veuillez l’adapter selon les conditions de votre contrat.

CSS Style to add to the on-page message

Personnalisez le widget via CSS (e.g. font size, margin, position).

Si vous utilisez différents templates de page produit dans votre backend, vous devez vous assurer d’ajouter le widget de Scalapay sur chacun d’eux : dans ce cas, utilisez l’Embed Scalapay App for Shopify.

❤ Configurer l'application pour le widget sur la page panier

Après avoir installé le widget sur la page produit, retournez dans l’application Scalapay et cliquez sur "Add to Cart page".

Go back to the App to add Scalapay to the Cart page

Pour configurer le widget sur la page panier, vous devrez ajouter un produit au panier dans votre backend.

Comme pour la page produit, dans la colonne de gauche, vous trouverez toutes les sections de la page panier, y compris une appelée "Scalapay on-page message" : il s’agit du widget qui apparaîtra sur la page panier et qui contient ses paramètres.

Si la section "Scalapay on-page message" n’apparaît pas ou si vous souhaitez en ajouter une nouvelle, cliquez sur Add block, puis sur Apps, et vous la trouverez dans la liste.

  • Faites glisser le bloc du widget sous la section Checkout button.

  • En cliquant sur "Scalapay on-page message", un nouveau menu apparaîtra, vous permettant de modifier les paramètres du widget.

  • ENTREZ VOTRE MERCHANT TOKEN
    Vous devrez saisir votre Merchant Token dans la section Merchant Token afin d'afficher correctement vos produits Scalapay dans le widget.
    Vous trouverez votre Merchant Token dans votre Scalapay Merchant Portal, dans la section "Developer".

Scalapay widget configurations on Cart page

Embed Scalapay App for Shopify

Installer l’application

Il est recommandé d’utiliser l’Embed Scalapay App pour Shopify dans les cas suivants :

  • lorsque le plugin Scalapay n’est pas compatible avec le thème utilisé par le merchant sur Shopify

  • lorsque sur le site du merchant la page classique du panier n’est pas visible et qu’il est nécessaire d’ajouter le widget Scalapay dans le mini panier

  • lorsqu’il y a plusieurs templates différents pour les pages produit

Veuillez suivre les étapes ci-dessous pour installer correctement le widget Scalapay via l’Embed App.

  1. Dans le backend Shopify, dans le menu à gauche, cliquez sur Apps, tapez Scalapay dans la barre de recherche en haut de la page, puis sélectionnez Scalapay On-Site Messaging.

Install the App to have Scalapay on Product page and Cart page

2. Cliquez sur Use Embed App.

3. Activez le Scalapay Widget dans le menu à gauche et cliquez sur le texte pour modifier les configurations du widget.

❤ Configurer l’application

  1. ENTREZ VOTRE MERCHANT TOKEN

Vous devrez saisir votre Merchant Token dans la section Merchant Token afin d’afficher correctement vos produits Scalapay dans le widget.

Vous trouverez votre Merchant Token dans votre Scalapay Merchant Portal, dans la section "Developer".

Vous recevrez vos identifiants de connexion pour le Merchant Portal par email de la part de votre Integration Manager de Scalapay.

Pay in 3 section

2. Après avoir ajouté votre Merchant Token, les paramètres du widget doivent être configurés pour s’assurer qu’il est bien installé et visible en frontend.

Pay in 3 section

3. Pour afficher le widget sous le prix de l’article sur la page produit, faites un clic droit sur le prix puis sélectionnez Inspect afin de trouver la position correcte et les sélecteurs de prix.
Inscrivez ensuite ces informations dans le box Widgets Configuration située sur la partie gauche.

Comme expliqué ci-dessous le box Widget Configurations, il est nécessaire de suivre des règles précises et un ordre spécifique.

  • Chaque élément est séparé par | (c’est un caractère pipe, pas un "i" majuscule);

  • Le premier élément correspond au type de widget(product or cart);

  • Ensuite, vient la position du widget;

  • Enfin, les sélecteurs de prix sont indiqués à la fin.

Exemples

Pour afficher le widget sur la page produit, sous l’élément avec la classe .price et le prix du produit est indiqué par un élément avec une classe .price-product-amount :

product|.price|.price-product-amount

Pour afficher le widget sur la page produit, sous l’élément avec la classe .price at lorsque le prix du produit peut être réduit (donc il y a deux prix pour le même produit), veuillez indiquer d’abord l’élément du prix réduit (.price-product-amount-discounted) puis l’élément du prix plein (.price-product-amount-full):

product|.price|.price-product-amount-discounted|.price-product-amount-full

Pour afficher le widget sur la page panier, sous l’élément avec l’id #totals et lorsque le montant du panier est indiqué par un élément avec la classe .total-amount:

cart|#totals|.total-amount

4. Pour ajouter le widget sur la page panier, il est nécessaire d’ajouter un produit dans le panier (dans ce cas, c’est un mini panier), sélectionner le prix, faire un clic droit, sélectionner Inspecter pour chercher la position correcte et les sélecteurs de prix, puis écrire les informations dans la boîte Widgets Configuration sur la gauche.


Après avoir écrit cart|, indiquez les paramètres de position (e.g. .cart-subtotal) puis les sélecteurs de prix (e.g. |#mini-cart-subtotal-val).


Par exemple: cart|.cart-subtotal|#mini-cart-subtotal-val

Avez-vous trouvé la réponse à votre question ?