Téléchargement du module

Pour installer l'extension, 2 options s'offrent à vous : via Composer ou depuis un fichier .zip.

Option 1 : Installer l’extension en utilisant le Composer (recommandé)

• Assurez-vous que le Composer soit installé
• Si vous utilisez le thème Magento par défaut, exécutez les commandes ci-dessous:
  composer require fintecture/payment

php bin/magento module:enable Fintecture_Payment

php bin/magento module:status Fintecture_Payment

• Si vous utilisez Hyvä Checkout :
  composer require fintecture/payment-hyva

php bin/magento module:enable Fintecture_HyvaPayment

php bin/magento module:status Fintecture_HyvaPayment​

• Après l'installation des modules, exécutez les commandes ci-dessous (Magento CLI) :
  php bin/magento setup:upgrade

php bin/magento setup:static-content:deploy -f

php bin/magento setup:di:compile

php bin/magento cache:clean
​

Option 2 : Installer l’extension depuis un fichier zip.

Via le thème Magento par défaut

• Décompressez le fichier .zip présent sur notre Github
• Créez un autre répertoire appelé app/code/Fintecture/Payment/
• Téléchargez le répertoire app/code/Fintecture/Payment/ dans le répertoire racine de votre installation Magento. Tous les répertoires doivent correspondre à la structure de répertoires existants.
• Accédez au répertoire racine et exécutez les commandes suivantes :
  php bin/magento setup:upgrade

php bin/magento setup:di:compile

php bin/magento setup:static-content:deploy -f

php bin/magento cache:flush

php bin/magento cache:clear

Via le thème Hyvä Checkout

• Décompressez le fichier .zip présent sur notre Github
• Créez un autre répertoire appelé app/code/Fintecture/HyvaPayment/
• Téléchargez le répertoire app/code/Fintecture/HyvaPayment/ dans le répertoire racine de votre installation Magento. Tous les répertoires doivent correspondre à la structure de répertoires existants.
• Accédez au répertoire racine et exécutez les commandes suivantes :
  php bin/magento setup:upgrade

php bin/magento setup:di:compile

php bin/magento setup:static-content:deploy -f

php bin/magento cache:flush

php bin/magento cache:clear
​

Configuration du module

Utilisez le Dashboard Magento pour configurer le module :

• Depuis votre "Admin Panel", rendez-vous sur la page "Modes de paiement" (Boutiques > Configuration > Ventes)
• Cliquez sur la flèche sur "Other Payment Methods" et "Virement Maitrisé" apparaîtra

Les configurations possibles sont les suivantes :

• Effectuez des paiements en environnement de test
• Effectuez des paiements en environnement de production
• Personnalisez la page de paiement
• Mettez en avant la solution sur votre site
• Configurez les statuts Magento
• Gérez vos commandes
• Paiements en magasin
• Personnaliser la clé de réconciliation

Effectuer des paiements en environnement de test

• Suivez la documentation suivante pour créer votre boutique sur l'Espace Virement Maitrisé, en sélectionnant "Magento" comme plateforme e-commerce et "Sandbox" comme environnement
• Sur Magento, dans "Paramètres", sélectionnez "Sandbox" dans "Environnement"
• Copiez l'APP ID de votre boutique Virement Maitrisé et collez-là dans le champ "Fintecture APP ID"
• Copiez l'APP SECRET de votre boutique Virement Maitrisé et collez-là dans le champ "Fintecture APP secret"
• Dans "Clé privée de Fintecture" cliquez "Choisir un fichier" pour charger le fichier .pem préalablement généré depuis votre espace Virement Maitrisé
• Cliquez sur "Test de connexion" afin de vérifier la bonne configuration

Vous pouvez alors enregistrer ! Votre module Virement Maitrisé sera désormais visible sur votre page de paiement.

Effectuer des paiements en environnement de production

• Suivez la documentation suivante pour créer votre boutique sur l'Espace Virement Maitrisé, en sélectionnant "Magento" comme plateforme e-commerce et "Production" comme environnement
• Sur Magento, dans "Paramètres", sélectionnez "Production" dans "Environnement"
• Copiez l'APP ID de votre boutique Virement Maitrisé et collez-là dans le champ "Fintecture APP ID"
• Copiez l'APP SECRET de votre boutique Virement Maitrisé et collez-là dans le champ "Fintecture APP secret"
• Dans "Clé privée de Fintecture" cliquez "Choisir un fichier" pour charger le fichier .pem préalablement généré depuis votre espace Virement Maitrisé
• Cliquez sur "Test de connexion" afin de vérifier la bonne configuration

Vous pouvez alors enregistrer ! Votre module Virement Maitrisé sera désormais visible sur votre page de paiement.

Personnaliser la page de paiement

Affichage sur la page de paiement

Vous pouvez configurer ce que vos clients verront lorsqu'ils arriveront sur la page de paiement.

Rendez-vous dans la section "Options d'affichage" dans la configuration de votre module Virement Maitrisé, et choisissez l'affichage souhaité :

1. "Version longue" : une explication du parcours est présentée à vos clients
2. "Version courte" : seul le nom de la solution de paiement est affiché

Position sur la page de paiement

Cette fonctionnalité n'est pas disponible si vous utilisez Hyvä Checkout !

Vous pouvez placer le moyen de paiement Virement Maitrisé en première position de la liste des moyens de paiement sur la page de paiement, selon le montant.

Rendez-vous dans la section "Options d'affichage" dans la configuration de votre module Virement Maitrisé.

Pour activer cette fonctionnalité, sélectionnez "Oui" dans la section "Première position en fonction du montant du panier" et définissez le "Montant minimum du panier pour placer Virement Maitrisé en première position". Cliquez ensuite sur "Enregistrer la configuration" en haut à droite de votre écran.

Mettre en avant la solution sur votre site

Badge recommandé

Cette fonctionnalité n'est pas disponible si vous utilisez Hyvä Checkout !

Vous pouvez ajouter un badge "recommandé" sur les moyens de paiement Virement Maitrisé sur la page de paiement.

Rendez-vous dans la section "Options d'affichage" dans la configuration de votre module Virement Maitrisé.

Pour activer cette fonctionnalité, sélectionnez "Oui" dans la section "Badge recommandé". Cliquez ensuite sur "Enregistrer la configuration" en haut à droite de votre écran.

Configurer les statuts Magento

Vous pouvez personnaliser la correspondance entre les statuts du module Virement Maitrisé et vos statuts Magento personnalisés.

Rendez-vous dans la section "Paramètres avancés" dans la configuration de votre module Virement Maitrisé, puis "Mappage des statuts de paiement entre Virement Maitrisé et Magento".

Ici, vous pouvez faire correspondre nos statuts de commande avec les vôtres. Par défaut, la correspondance est configurée pour utiliser les statuts natifs de Magento et les statuts personnalisés de Virement Maitrisé.

Correspondance des statuts de commande

Lorsqu'une commande est effectuée via le Virement Simplifié, 3 statuts sont possibles :

• Statut "Paiement accepté" : le paiement est accepté par la banque du client
• Statut "Paiement en attente" : le paiement est en cours de traitement dans la banque du client
• Statut "Echec du paiement" : une erreur s'est produite pendant le paiement

Lorsqu'une commande est effectuée via le Virement Classique, 4 statuts sont possibles :

• Statut "Paiement accepté" : le paiement a été effectué par le client
• Statut "Paiement en attente" : le paiement est en attente de réception du virement par le client
• Statut "Paiement partiel" : le virement a été reçu mais le montant est inférieur à celui de la commande
• Statut "Paiement avec surplus" : le virement a été reçu mais le montant est supérieur a celui de la commande

Gérer vos commandes

Vous pourrez effectuer différentes actions sur vos commandes depuis votre back office Magento.

Rembourser une commande

Pour effectuer un remboursement complet d'une commande, rendez-vous sur la commande, puis sur la facture correspondante et cliquez sur "Émettez un avoir". Définissez ensuite votre remboursement et cliquez sur "Rembourser".

Après le changement de statut, vous recevrez un email de confirmation de notre part.

Expiration automatique

Cette fonctionnalité vous permet de faire expirer les commandes qui ne seraient pas payées.

Rendez-vous dans la section "Paramètres avancés" dans la configuration de votre module Virement Maitrisé, puis dans "Expiration automatique des commandes en cours".

Pour activer cette fonctionnalité, sélectionnez "Oui" dans la section "Activer l'expiration automatique des commandes en attente" et définissez le nombre de minutes minimum pour l'expiration dans la section "Expiration automatique des commandes en attente après". Cliquez ensuite sur "Enregistrer la configuration" en haut à droite de votre écran.

Annuler une commande

Vous pouvez annuler une commande liée à un paiement Virement Classique, qui a comme statut "Paiement en attente" (voir la section correspondante).

Pour annuler une commande, allez dans le détail d'une commande et cliquez sur "Annuler".

Personnaliser la clé de réconciliation

Pour vos paiements Virement Classique, vous pouvez définir vous-même la logique de génération des IBAN virtuels.

Exemple : plusieurs de vos clients proviennent de la même entreprise, vous souhaitez à ce qu'ils partagent tous le même IBAN virtuel pour faciliter leurs paiements. Sélectionnez alors votre champ personnalisé du type 'company_id'

Rendez-vous dans la section "Paramètres avancés" dans la configuration de votre module Virement Maitrisé, puis dans "Virement Classique".

Pour activer cette fonctionnalité, sélectionnez "Oui" dans la section "Activer le champ personnalisé pour le rapprochement" et sélectionnez votre champ personnalisé dans la section "Champ personnalisé pour le rapprochement". Cliquez ensuite sur "Enregistrer la configuration" en haut à droite de votre écran.

Paiements en magasin

Similaire à notre fonctionnalité de demande de paiements, cette option vous permet d'utiliser Magento pour envoyer le lien de paiement par SMS, par email ou en affichant un QR code.

Rendez-vous dans la section "Paramètres avancés" dans la configuration de votre module Virement Maitrisé, puis dans "Méthodes de paiement alternatives pour la fonction "Se connecter en tant que client"".

Pour activer cette fonctionnalité, sélectionnez "Oui" dans la section "Activer d'autres méthodes de paiement pour la fonction "Se connecter en tant que client"" et sélectionnez votre choix d'envoi dans la section "Choisissez la méthode de paiement alternative pour la fonction "Se connecter en tant que client"".

Cliquez ensuite sur "Enregistrer la configuration" en haut à droite de votre écran.