Skip to content

Magento ​

Introduction ​

Stancer propose des infrastructures de paiement simples, accessibles et transparentes, pour aider les entrepreneurs et les entreprises Ă  se dĂ©velopper au quotidien. Ce module officiel permet d’accepter les paiements en carte bancaire via la plateforme Stancer directement sur Magento/Adobe Commerce. Avant de pouvoir accepter des paiements via ce module, il est nĂ©cessaire de crĂ©er un compte Stancer.

Version supportĂ©s ​

Magento versionPHP Version
2.x7.4 ou ultérieure

GenĂ©ration des clĂ©s API ​

Afin de configurer le module Magento, il est nĂ©cessaire d’obtenir des informations que vous pouvez trouver dans votre compte Stancer via le lien https://manage.stancer.com/fr/.

Une fois connectĂ©, se rendre dans l’onglet "DĂ©veloppeurs". Lors de la crĂ©ation de votre compte, des clĂ©s privĂ©es et publiques de test sont automatiquement gĂ©nĂ©rĂ©es.

Les clés API dans l'onglet developpeurs

Pour obtenir des clés de Production, il est nécessaire de finaliser votre inscription Stancer et que votre compte soit validé.

Installation et configuration du module Ă©tape par Ă©tape ​

Le module peut ĂȘtre installĂ© de deux maniĂšres. Soit par la Magento Marketplace directement ( maintenantAdobe Commerce marketplace), soit Ă  la main. Bien que passer par la marketplace ne soit pas une obligation, le processus d'installation y est plus simple.

Configuration initiale ​

Pour toute l'installation et la configuration de notre module si aucun dossier n'est spécifié lors de commande bash, considérez qu'il s'agit du dossier racine de votre installation magento.

Faire une sauvegarde de votre site ​

Avant de commencer, faites une sauvegarde de votre site, fichier et base de données comprise.

Passez en mode maintenance ​

bash
php bin/magento maintenance:enable

Installation par le Magento/Adobe Commerce Marketplace ​

Afin d’installer le module Stancer depuis la marketplace, vous aurez besoin de vos clĂ©s Adobe Commerce. AprĂšs vous ĂȘtre connectĂ© sur votre espace personnel Magento, vous les trouverez dans: "My Profile" > onglet "Marketplace" > "My Products" > "Access Key" .

  • Commandez le module Stancer (stancer/module-payments) depuis la marketplace
  • Sur votre serveur oĂč est installĂ© Magento, ouvrez une console dans le dossier d'installation. Puis, entrez la commande suivante :
bash
composer require stancer/module-payments

Il est fortement conseillé de choisir un numéro de version en production, en l'ajoutant à la fin du nom du module, par exemple: stancer/module-payments:1.0.1

Si vous n'avez pas défini vos clés Magento dans Composer, il vous sera demandé de les rentrer.

Installation Manuelle ​

Téléchargez l'extension Stancer dans votre serveur [Lien de l'extension].

Extraire l'extension ​

Allez au dossier d'installation Magento et extrayez votre zip dans le dossier app/code/StancerIntegration/Payments.

Mettez à jour votre fichier composer ​

Ouvrez le fichier composer.json dans le dossier racine de votre installation et ajoutez dans la section repositories :

json
"repositories":[
  {
    "type": "path",
    "url": "app/code/StancerIntegration/Payments"
  }
]

ou directement dans la console depuis le dossier racine de Magento:

bash
composer config repositories.stancer path app/code/StancerIntegration/Payments

Installez l'extension par composer ​

Tapez dans votre console dans le dossier racine de votre installation:

bash
composer require stancer/module-payments

Afin de spécifier la dépendance a notre module (et de lancer l'installation des dépendances de celui-ci).

Il est fortement conseillé de choisir un numéro de version en production, en l'ajoutant à la fin du nom du module, par exemple: stancer/module-payments:1.0.1

Activation ​

Une fois l'extension installée, que ce soit depuis le marketplace ou manuellement, il faut l'activer, pour ce faire, lancez les commandes suivantes :

bash
php bin/magento module:enable StancerIntegration_Payments
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento cache:clean
php bin/magento setup:static-content:deploy -f
php bin/magento cache:flush

DĂ©sactiver le mode maintenance ​

Une fois l'extension installée et activée. Il faut désactivez le mode maintenance de Magento.

bash
php bin/magento maintenance:disable

Configurer le module depuis le back-office magento ​

Connectez vous Ă  votre back-office, puis allez Ă  la page Stores -> Configuration -> Sales -> Payment Methods. Sur cette page cliquez sur configure dans la section Stancer.

ClĂ©s API ​

  • Choisissez l’environnement de votre module (test ou live).

  • Entrez vos clĂ©s publiques et privĂ©es.

  • Choisissez le mode d'affichage souhaitĂ©:

    • (Notre recommandation) IntĂ©grĂ© dans la page de paiement de votre site: le formulaire de paiement est directement proposĂ© sur votre boutique.
    • Redirection vers une page externe Stancer: l’utilisateur sera automatiquement redirigĂ© vers une page Stancer, puis une fois le paiement acceptĂ©, sera redirigĂ© sur votre boutique sur une page de confirmation de commande.

Moyens de paiement disponibles ​

  • Le module permet de rĂ©aliser des paiements par carte bancaire.

  • Les paiements sont compatibles 3D Secure. Le montant Ă  partir duquel se dĂ©clenche le 3D Secure est configurable depuis le module dans le back-office Magento.

Cartes de test ​

Cartes de tests disponibles