Guide d'installation Prestashop

Intégrez KohortPay à votre boutique Prestashop.

Pré-requis

Afin de procéder à l'installation et la configuration du module, vous devez :

  1. Avoir un accès au back-office de la boutique Prestashop avec le role nécessaire pour installer les modules et configurer les modes de paiement.

  2. Avoir un compte KohortPay. Si ce n'est pas le cas, vous pouvez créer un compte KohortPay en 1 minute sur notre site. Ce compte vous permettra d'accéder à notre API et de configurer votre module KohortPay sur Prestashop.

  3. Utilisez le module uniquement avec la devise EUR et uniquement en langue Française (fr_FR) ou Anglaise (en_US).

  4. Dans le cas du parrainage sans nouveau mode de paiement, il faut s'assurer que votre module de paiement par carte bancaire permet le remboursement à travers les avoirs de Prestashop. Si ce n'est pas le cas, vous devrez faire les remboursements manuellement depuis l'interface bancaire.

Installation du module

Vous les différentes étapes pour installer le module sur votre boutique Prestashop :

  1. Téléchargez le module depuis la marketplace ou depuis notre dépôt GitHub.

  2. Connectez-vous à votre back-office Prestashop

  3. Allez dans Modules > Gestionnaire de modules

  4. Cliquez sur le bouton en haut à droite "Télécharger un module" et sélectionnez le module ZIP

Après que l'installation soit terminé avec succès, vous pouvez configurer le module (voir ci-dessous).

Configuration du module (sans nouveau mode de paiement)

  1. Commencez par accéder à la page de configuration du module via le bouton "Configurer" sur la page "Gestionnaire de modules" ou la page "Moyen de paiement".

  2. Activez ou Désactiver le module via le menu déroulant "Activation".

  3. Entrez vos informations d'identification (Clé secrète API KohortPay) puis appuyez sur "Enregistrer". Si vous n'avez pas encore les identifiants (Clé secrète API KohortPay) , vous pouvez les générer et les récupérer ici : https://dashboard.kohortpay.com/live/settings/developer (KohortPay Dashboard > Paramètres du développeur > Clés API)

  4. Créer un nouveau webhook (Dashboard Kohortpay > Paramètres du développeur> Nouveau webhook), renseigner l'URL de votre site suivi de "/module/kohortpay/webhook", puis sélectionner l'évènement "payment_intent.cashback_sent". Une fois créé, il suffit de renseigner votre clef secrète WEBHOOK dans la configuration du module.

  5. Vous pouvez éventuellement définir le montant total minimum de la commande pour créer un groupe de parrainage (minimum par défaut 30€).

  6. N'oubliez pas de sélectionner les modes de paiements qui sont autorisés à créer des groupes de parrainage (notamment le mode de paiement par carte bancaire).

  7. Une fois les actions réalisés, les commandes payées seront transmis à KohortPay et les groupes de parrainage seront créés. De plus, le champs code de promotion sera affiché et permettra de renseigné de code de parrainage pour rejoindre des groupes.

Configuration du module (Avec nouveau mode de paiement)

  1. Commencez par accéder à la page de configuration du module via le bouton "Configurer" sur la page "Gestionnaire de modules" ou la page "Moyen de paiement".

  2. Activez ou Désactiver le module via le menu déroulant "Activation".

  3. Entrez vos informations d'identification (Clé secrète API KohortPay) puis appuyez sur "Enregistrer". Si vous n'avez pas encore les identifiants (Clé secrète API KohortPay) , vous pouvez les générer et les récupérer ici : https://dashboard.kohortpay.com/live/settings/developer (KohortPay Dashboard > Paramètres du développeur > Clés API)

  4. Vous pouvez éventuellement définir le montant total minimum de la commande pour afficher le mode de paiement KohortPay (minimum par défaut 30€).

  5. Une fois les actions réalisées, le mode de paiement KohortPay devrait être affiché dans votre tunnel de commande.

Dépannage

  • Vous n'arrivez pas à installer le module ZIP => Vérifier que votre compte Prestashop possède bien les droits pour gérer les modules et que votre dossier "modules" a bien les droits du serveur en écriture.

  • Votre clef ne fonctionne pas => Vérifier que vous avez bien copier la totalité du texte de la clef secrète sans espace avant ou après (elle commence par "sk_" ou "sk_test_" pour le mode test).

  • Le mode de paiement ne s'affiche pas => Vérifier tout d'abord que le module soit bien activé, que la clef soit bien présente et que le total du panier est au dessus de votre configuration. Si le mode ne s'affiche toujours pas, veuillez vérifier la configuration de la page "Mode de paiement > Préférence", KohortPay doit être coché pour la devise, le groupe de client, le transporteur et le pays de votre commande.

  • Il y a une erreur à la redirection vers la page de paiement => Vérifier que la configuration de la boutique utilise bien uniquement 2 décimales pour les prix et les arrondis à chaque article.

  • Mes commandes payés ne sont pas transmis à KohortPay et donc aucun groupe de parrainage n'est créé => Veuillez vérifier que le module est bien activé, le minimum d'achat atteint et vos modes de paiement activés pour le parrainage. Si tout cela est fait et que cela ne fonctionne toujours pas, veuillez vous rendre dans les logs de Prestashop pour vérifier la cause.

N'hésitez pas à nous contacter via [email protected] si vous rencontrez un problème ou avez besoin de plus d'informations !

Last updated