En vue du passage au widget 5.2, deux vérifications sont à faire sur votre intégration : le script V5 et le merchant token. Voici les réponses aux questions les plus fréquentes.

Que dois-je vérifier avant le passage ?

Deux choses : que votre site charge le script du widget V5 et que chaque widget contienne le merchant token. Si les deux conditions sont réunies, le passage à la 5.2 se fait automatiquement.

Comment vérifier rapidement ?

Une minute suffit. Ouvrez une page produit, affichez le code source et recherchez scalapay-widget. Vous y trouverez l’adresse du script et l’attribut merchant-token.

Que se passe-t-il le jour du passage ?

Avec le script V5 et le merchant token, le widget passe automatiquement à la 5.2. Avec le script V5 sans token, il reste en 5.1. Avec V3, V1 ou un loader sans version, l’ancien widget reste en place et la 5.2 n’arrivera pas tant que le marchand n’aura pas fait la mise à jour.

Marchands utilisant un plugin ou une app e-commerce

Ma boutique fonctionne sous WooCommerce, PrestaShop, Magento ou Shopify. Que dois-je faire ?

Mettez à jour le plugin. Vérifiez que vous disposez de la dernière version du plugin Scalapay et, si besoin, installez-la depuis la marketplace de votre plateforme ou depuis developers.scalapay.com. Les anciennes versions chargent le widget V3, qui ne recevra jamais la 5.2.

Où saisir le merchant token ?

Dans les paramètres du widget du plugin, avec le merchant token du Merchant Portal. Si le plugin n’a pas de champ merchant token, il est obsolète : mettez-le d’abord à jour.

Comment vérifier que tout est correct ?

Videz le cache de la boutique, ouvrez une page produit et contrôlez le code source : vous devez trouver le script V5 et un merchant-token sur chaque widget.

Marchands avec une intégration sur mesure

Le widget est intégré dans notre code ou notre thème. Quel script charger ?

Exactement celui-ci : https://cdn.scalapay.com/widget/v5/js/scalapay-widget.js

Comment reconnaître un script obsolète ?

Toute adresse contenant /widget/v3/ ou /js/scalapay-widget/ (V1) est obsolète, tout comme le loader sans ?version=V5, qui charge la V3.

Où placer le merchant token ?

Dans chaque balise <scalapay-widget> (produit, panier, checkout), sous la forme merchant-token='…' avec le token du Merchant Portal, orthographié exactement.

Faut-il aussi modifier les attributs du widget ?

Oui, utilisez le modèle de données de la 5.2. Les attributs V3 comme number-of-installments n’ont aucun effet en V5 et doivent être supprimés.

En résumé

Script V5 et merchant token sur chaque widget : avec ces deux éléments, le passage à la 5.2 se fait tout seul.