ComNpay - Développeur

Extensions CMS

Introduction

Les CMS (Content Management System) sont des applications Web permettant de créer une boutique en ligne dans le but de réaliser du commerce sur internet rapidement et facilement. Vous avez la possibilité de rajouter des modules pour développer votre boutique en ligne. Le module ComNpay s'intègre aux principaux CMS ci-dessous :

logo-prestashop logo-woocommerce logo-magento logo-drupal logo-hikashop

Extension Prestashop

Présentation de l'extension Prestashop

Prestashop est une solution open-source d'e-commerce permettant de créer une boutique en ligne. Il est possible d'y ajouter des modules pour étendre les fonctionnalités du site et ainsi le personnaliser en fonction de vos besoins.

ComNpay a créé un module gratuit qui vous permet d'intégrer facilement et rapidement la solution PSP à votre boutique.

Installation de l'extension Prestashop

Pour installer le module, vous devez commencer par le télécharger en cliquant sur l'un des boutons ci-dessous

TÉLÉCHARGER
(Prestashop 1.5 / 1.6)

TÉLÉCHARGER
(Prestashop 1.7)

Si votre boutique Prestashop est en version 1.4.7, vous devrez utiliser le module suivant : module-prestashop-1.4.7.

Vous devez ensuite :

  • vous rendre sur l'administration de votre boutique dans l'onglet Modules > Modules
  • cliquez sur le bouton Ajouter un nouveau module
  • choisir le fichier zip que vous avez téléchargé puis valider en cliquant sur Charger le module
  • le module apparaît dans la liste des modules (catégorie : Paiement), il vous reste à cliquer sur Installer
  • le module ComNpay est installé, vous arrivez sur la page de configuration

Configuration de l'extension Prestashop

Pour configurer le module ComNpay, vous devez :

  • vous rendre sur l'interface d'administration de votre boutique Prestashop et allez dans l'onglet Modules > Modules

  • sur la ligne correspondant au module ComNpay, cliquez sur Configurer

  • vous pouvez ensuite personnaliser les éléments suivants :

    • Numéro de TPE : le numéro de votre TPE Virtuel qui vous a été communiqué par AfonePaiement
    • Clé secrète : la clé secrète qui vous a été communiquée par AfonePaiement. Attention : cette information est personnelle et ne doit jamais être communiquée à un tiers.
    • Type de passerelle à utiliser : Homologation pour tester votre installation ou Production
    • URL pour l'homologation : l'adresse URL de la page PSP ComNpay pour l'homologation
    • URL pour la production : l'adresse URL de la page PSP ComNpay pour la Production
    • Autorise le paiement en trois fois : cochez la case pour permettre à vos clients de payer en 3 fois sans frais. Le paiement en une fois sera toujours possible.
./static/config_prestashop1.png ./static/config_prestashop2.png

Si vous souhaitez modifier l'ordre d'apparition des modules de paiement et que votre version de prestashop le permet, vous devez :

  • vous rendre sur l'interface d'administration de votre boutique Prestashop et allez dans l'onglet Modules et Services > Positions
  • il faut ensuite rechercher la configuration de la partie displayPayment ou payment
  • vous pouvez alors modifier l'ordre d'apparition des modules de paiement
./static/prestashop_position_module.png

Changelog

Version ComNpay Version min prestashop Date de livraison Descriptif
2.1.1 1.7 12/10/2017 Ajout de la traduction pour l'Italie
2.1.0 1.7 10/08/2017 Corrections mineures
2.0.0 1.7 13/07/2017 Version stable avec l'ajout de la traduction anglaise
1.4.0 1.7 15/05/2017 Compatibilité avec la version 1.7 de prestashop (version Beta)
1.3.1 1.5 15/05/2017 Corrections mineures et gestion de la traduction anglaise
1.3.0 1.5 15/05/2017 Corrections mineures
1.2.6 1.5 09/03/2016 Corrections mineures
1.2.5 1.5 15/12/2015 Corrections mineures
1.2.4 1.5 10/08/2015 Meilleur support des versions de PHP < 5.5
1.2.3 1.5 17/06/2015 Ajout d'un message d'information si la configuration SSL du serveur ne respecte pas les conditions requises pour l'utilisation de certaines fonctionnalités
1.2.2 1.5 10/06/2015 Ajout d'un paramétrage pour spécifier un montant minimum afin de proposer le paiement en 3 fois
1.2.1 1.5 26/05/2015 Validation des identifiants lors du paramétrage du module et ajout d'un widget sur la fiche d'une commande dans l'admin indiquant l'échéancier dans le cadre d'un paiement en 3 fois
1.2.0 1.5 02/02/2015 Ajout du paiement en 3 fois

Extension WooCommerce sur WordPress

Présentation de l'extension WooCommerce

WooCommerce est une extension open source pour WordPress permettant de créer une boutique en ligne. Il est conçu pour les petites et grandes entreprises en ligne utilisant WordPress. Le plugin est rapidement devenu célèbre pour sa simplicité d'installation et de personnalisation. WooCommerce et WooCommerce Multilingual sont dans le répertoire des extensions de WordPress.

ComNpay a créé une extension gratuite qui vous permet d'intégrer facilement et rapidement la solution PSP à votre boutique.

Installation de l'extension WooCommerce

Avant d'installer le module ComNpay, vous devez installer le module WooCommerce

Ensuite, pour installer le module ComNpay vous devez commencer par télécharger le module en cliquant sur le bouton ci-dessous

TÉLÉCHARGER

Vous devez ensuite :

  • vous connecter au back office de WordPress
  • vous rendre dans le menu Extensions > Ajouter > Mettre une extension en ligne
  • importer le fichier .zip téléchargé
  • vous rendre dans le menu WooCommerce > Réglages > Commande > Passerelles de Paiement

Vous trouverez votre module ComNpay dans la liste des passerelles. Vous pourrez d'ailleurs modifier l'ordre d'affichage des moyens de paiement à vos clients.

Configuration de l'extension WooCommerce

Pour configurer l'extension ComNpay, vous devez :

  • cliquer sur le module ComNpay dans la liste des passerelles (voir la dernière étape de l'installation)

  • vous pouvez ensuite personnaliser les éléments suivants :
    • Activer/Désactiver : Cochez la case pour proposer le paiement ComNpay à vos clients
    • Titre : le texte qui apparaitra à l'utilisateur lors du choix du type de paiement
    • Message avant paiement : le texte qui apparaitra à l'utilisateur avant la redirection vers la page de paiement
    • Message après règlement : le texte qui apparaitra à l'utilisateur sur la page de remerciement
    • Numéro de TPE : le numéro de votre TPE Virtuel qui vous a été communiqué par AfonePaiement
    • Clé secrète : la clé secrète qui vous a été communiquée par AfonePaiement. Attention : cette information est personnelle et ne doit jamais être communiquée à un tiers.
    • URL pour l'homologation : adresse URL de la page PSP ComNpay pour l'homologation
    • URL pour la production : adresse URL de la page PSP ComNpay pour la production
    • Plateforme : Homologation pour tester votre installation et Production pour prendre les paiements de vos clients
./static/config_woocommerce.png

Extension Magento

Présentation de l'extension Magento

Magento est une solution open-source d'e-commerce permettant de créer une boutique en ligne. Il est possible d'y ajouter des extensions pour étendre les fonctionnalités du site et ainsi le personnaliser en fonction de ses besoins.

ComNpay a créé une extension gratuite qui vous permet d'intégrer facilement et rapidement la solution PSP à votre boutique.

Installation de l'extension Magento

Pour installer l'extension, vous devez :

  • télécharger le module suivant :
TÉLÉCHARGER
  • depuis l'interface d'administration de votre boutique Magento, allez dans le menu Configuration > Magento Connect > Magento Connect Manager
  • une fois identifié, dans l'onglet Direct package file upload cliquez sur Parcourir et choisissez le fichier télécharger précédemment (format .tgz), puis cliquez sur Upload
  • l'extension ComNpay est installée

Si vous avez personnalisé votre boutique en créant un nouveau template ou un nouveau thème, vous devez copiez le dossier

  • app/design/frontend/base/default/template/comnpay

dans

  • app/design/frontend/<votrepaquet>/<votretheme>/template/

Configuration de l'extension Magento

Pour configurer l'extension ComNpay, vous devez :

  • vous rendre sur l'interface d'administration de votre boutique Magento et allez dans le menu Système, puis Configuration

  • dans le menu de gauche, cliquez sur Modes de paiement

  • cliquez sur ComNpay pour y configurer les éléments suivants :
    • Activé : oui pour proposer le paiement ComNpay à vos clients, non pour le désactiver
    • Titre : le texte qui apparaitra à l'utilisateur lors du choix du type de paiement
    • Statut d'une nouvelle commande : définit le statut lors de la création d'une nouvelle commande (avant son paiement)
    • Numéro de TPE : le numéro de votre TPE Virtuel qui vous a été communiqué par AfonePaiement
    • Clé secrète : la clé secrète qui vous a été communiquée par AfonePaiement. Attention : cette information est personnelle et ne doit jamais être communiquée à un tiers.
    • Type de passerelle à utiliser : Homologation pour tester votre installation et Production pour prendre les paiements de vos clients
    • URL pour l'homologation : adresse URL de la page PSP ComNpay pour l'homologation
    • URL pour la production : adresse URL de la page PSP ComNpay pour la production
    • Devise : la devise (EUR par défaut)
    • Langue : la langue utilisée sur la page de paiement (FR par défaut)
    • Ordre de tri : définit la position de la méthode de paiement ComNpay dans la liste des méthodes de paiement proposées au client
./static/config_magento.png

Autoriser le paiement en trois fois (cette option doit être activée sur Afone Paiement) :

  • Activé : Oui pour permettre à vos clients de payer en trois fois sans frais. Le client pourra toujours payer en une seule fois.
./static/p3f_magento.png

Extension Drupal Commerce

Présentation de l'extension Drupal Commerce

Drupal Commerce est un module à part entière du CMS open source Drupal. Ce module permet de déployer une boutique en ligne sur un site utilisant déjà Drupal. Pour les utilisateurs qui débutent avec Drupal, il est possible de télécharger la distribution Commerce KickStart qui intègre à la fois le cœur de Drupal et tous les modules nécessaires pour créer un site marchand.

ComNpay a créé un module gratuit qui vous permet d'intégrer facilement et rapidement la solution PSP à votre boutique.

Installation de l'extension Drupal Commerce

Pour installer le module, vous devez commencer par le télécharger en cliquant sur le lien ci-dessous (version testée avec Drupal 7.X) :

TÉLÉCHARGER

Vous devez ensuite :

  • vous rendre sur l'interface d'administration des modules dans l'onglet Site Settings > Modules
  • cliquez sur le bouton Install new module
  • choisir le fichier zip que vous avez téléchargé ci-dessus puis valider en cliquant sur Install
  • revenez sur la liste des modules et recherchez le module comNpay via le moteur de recherche ou en vous rendant dans la catégorie Commerce Payments
  • cochez la case correspondante au module et cliquez sur le bouton Save Configuration
  • le module ComNpay pour Drupal est activé

Configuration de l'extension Drupal Commerce

Pour configurer le module comNpay, vous devez :

  • vous rendre sur l'interface d'administration de votre boutique Drupal Commerce et allez dans l'onglet Store Settings > Payment methods ou Store > Configuration > Payment methods selon la distribution que vous utilisez.

  • Dans le tableau Disabled payment method rules sur la ligne correspondant au module comNpay, cliquez sur Edit

  • dans la règle Actions, cliquez sur le bouton Edit dans la colonne Operations correspondant à la ligne Enable payment method: Payer avec comNpay

  • dans la section Payment Settings, vous pouvez configurer les éléments suivants :

    • Numéro de TPE : le numéro de votre TPE Virtuel qui vous a été communiqué par AfonePaiement
    • Clé secrète : la clé secrète qui vous a été communiquée par AfonePaiement. Attention : cette information est personnelle et ne doit jamais être communiquée à un tiers.
    • URL pour l'homologation : l'adresse URL de la page PSP ComNpay pour l'homologation
    • URL pour la production : l'adresse URL de la page PSP ComNpay pour la production
    • Type de passerelle à utiliser : Homologation pour tester votre installation ou Production une fois les tests validés
    • Type de transaction : Débit immédiat sur la carte du client ou Pré-Autorisation (prélèvement du client après validation de votre part). A NOTER : la Pré-autorisation n'est pas implémentée dans la version actuelle du module.
    • Langue : french si votre boutique est en français ou english si votre boutique est en anglais. La passerelle de paiement sera automatiquement traduite selon la langue choisie.
./static/config_drupal.png

Autoriser le paiement en trois fois (cette option doit être activée sur Afone Paiement) :

Dans l'interface de gestion des méthodes de paiement (Store Settings > Payment methods), sur la ligne correspondant à la méthode de paiement en trois fois, cliquez sur Enable (Activer).

./static/p3f_drupal.png

Si vous souhaitez traduire le module en français,

Pré-Requis : Le module Content Translation doit être activé

  • vous rendre sur l'interface d'administration de votre boutique et allez dans l'onglet Site Settings > Configuration > Translate Interface
  • dans l'onglet Import, choisir le fichier fr.po qui se trouve dans l'archive contenant le module comNpay (comnpay/translations/fr.po)
  • dans le menu déroulant Import into, choisir "French"
  • Validez en cliquant sur le bouton Import

Extension HikaShop

Présentation de l'extension HikaShop

HikaShop est un plugin permettant de transformer n'importe quel site utilisant Joomla en site marchand. Ce Plug-in est payant et disponible dans différentes versions selon vos besoins. Le module est disponible sous Joomla 1.5, 2.5 et 3.X

ComNpay a créé un module gratuit qui vous permet d'intégrer facilement et rapidement la solution PSP à votre boutique.

Installation de l'extension HikaShop

A SAVOIR : le module sera intégré de base dans les prochaines versions de HikaShop. Vous pouvez donc passer directement à l'étape suivante Configuration de l'extension HikaShop si le module ComNpay est déjà présent dans la liste des plug-ins. Si ce n'est pas le cas ou si vous ne savez pas, vous devez commençer par télécharger le module en cliquant sur le lien ci-dessous :

TÉLÉCHARGER

Vous devez ensuite :

  • vous rendre sur l'interface d'administration de votre boutique Extensions > Gestion des extensions
  • choisir le fichier zip que vous avez téléchargé ci-dessus puis valider en cliquant sur le bouton Envoyer & Installer
  • le module comNpay doit maintenant apparaître dans la liste des plugins Extensions > Gestion des plug-ins

Configuration de l'extension HikaShop

Pour configurer le module HikaShop, vous devez :

  • vous rendre sur l'interface d'administration de votre boutique HikaShop et allez dans l'onglet Composants > hikashop

  • dans le menu Système du module hikashop, cliquez sur le sous-menu Modes de paiement

  • cliquez sur le bouton Nouveau et choisir le plug-in Hikashop comNpay Payment Plugin

  • vous arrivez sur la page de configuration, vous pouvez configurer les éléments suivants :

    • Numéro de TPE : le numéro de votre TPE Virtuel qui vous a été communiqué par AfonePaiement
    • Clef d'accès secrète : la clé secrète qui vous a été communiquée par AfonePaiement. Attention : cette information est personnelle et ne doit jamais être communiquée à un tiers.
    • URL Homologation : l'adresse URL de la page PSP ComNpay pour l'homologation
    • URL Production : l'adresse URL de la page PSP ComNpay pour la production
    • Débogage : vous pouvez activer ou non l'affichage des erreurs dans les logs sur votre plateforme de test
    • Plateforme : Homologation pour tester votre installation ou Production une fois les tests validés
    • URL d'annulation : URL de la page vers laquelle le client sera redirigé quand il annule sa commande ou si le paiement est refusé. Laisser vide pour être redirigé vers la page par défaut.
    • URL de retour : URL de la page vers laquelle le client sera redirigé quand le paiement est accepté. Laisser vide pour être redirigé vers la page par défaut.
    • Autoriser le paiement en 3 fois : Oui pour permettre à vos clients de payer en trois fois sans frais. Cette option doit être activée sur Afone Paiement.
    • Type de Transaction : Débit immédiat sur la carte du client ou Pré-Autorisation (prélèvement du client après validation de votre part). A NOTER : La Pré-autorisation n'est pas implémentée dans la version actuelle du module.
    • Statut vérifié : statut de la commande après validation du paiement par comNpay
    • Statut invalide : statut de la commande après refus du paiement par comNpay
./static/config_hikashop.png
  • N'oubliez pas d'activer le module dans la section Configuration générique. Vous pouvez également personnaliser le nom du module et la description du module qui apparaît lorsque le client choisit son mode paiement.