pluginOxid eshop

S’abonner


Présentation du plugin OXIP eShop

Structure

Le pluginest mis à disposition sous la forme d'un dossier compressé nommé PaylineForOxidEShop_4.5.x_v1.0.zip contenant trois répertoires : admin, modules et out.
Ces répertoires et leurs sous répertoires correspondent à l'arborescence par défaut d'une installation de OXID eShop 4.5.x. Ils contiennent les éléments permettant l'appel des web services Payline, ainsi que l'intégration de Payline au sein des parties front-office (paiement) et back-office (configuration) de votre boutique OXID eShop.

Compatibilité du plugin

Le pluginOXID eShop est développé et testé avec l'environnement suivant :

  • OXID eShop - community edition 4.5.5_40299
  • systèmes d'exploitation Windows XP Professionnel
  • Apache 2.2.3
  • PHP 5.3

Télécharge le plugin ici :

PaylineForOxidEShop_4.5.…

Fonctionnement

Sélection de la méthode de paiement

Une fois le plugininstallé, configuré et activé en suivant les instructions du chapitre 3, Payline, peut être sélectionnée par les clients de votre boutique OXID eShop à l'étape 3 du processus de commande :

Redirection vers la page web de paiement Payline

Lorsqu'il valide sa commande après avoir choisi Payline comme méthode de paiement, le client est redirigé vers la page web de paiement Payline. Les moyens de paiement correspondant aux contrats choisis dans la configuration du plugin lui sont proposés.
Il peut procéder à la saisie de ses informations de paiement en toute sécurité.

Retour à la boutique

Une fois la saisie de ses informations de paiement validée, le client obtient un écran de confirmation l'informant du résultat de sa transaction. Sur cet écran un bouton « retour à la boutique » lui permet d'être redirigé vers la page de confirmation de commande dans la boutique OXID eShop.
Le retour à la boutique met immédiatement le statut de la commande à jour.
Si la page web de paiement est fermée sans que le client retourne à la boutique, la mise à jour dans OXID eShop sera automatiquement effectuée par le traitement de notification Payline

Intégration du plugin dans votre boutique

Pré-requis

Le plugin OXID eShop repose sur le kit Payline PHP, dont le fonctionnement nécessite l'activation des extensions PHP php_curl, php_http, php_openssl et php_soap.
Vous devez également disposer d'un compte Payline pour configurer votre plugin.
La solution Payline repose sur l'appel de web services, assurez-vous que l'appel de web services sécurisés est donc possible avec votre solution d'hébergement (l'ouverture des ports 8080 et 443 en entrée/sortie est nécessaire).

Installation

Extraire le contenu du dossier compressé vers la racine de votre installation OXID eShop.
Ceci fait, depuis la racine de votre installation OXID eShop vous devez voir apparaitre :

  • un script mnx_payline.php sous le répertoire admin
  • un répertoire mnx_payline sous les répertoires
    • modules
    • out/admin/img/
  • un script mnx_de_lang.php sous le répertoire out/admin/de/
  • un script mnx_en_lang.php sous le répertoire out/admin/en/
  • un script mnx_fr_lang.php sous le répertoire out/admin/fr/
  • un script mnx_payline.tpl sous le répertoire out/admin/tpl/


Une fois ces fichiers proprement déposés sur le serveur web, le pluginPayline est automatiquement détecté par OXID eShop. Un lien Payline pointant vers l'écran de configuration du plugindoit apparaitre dans la rubrique Service du back office (voir Figure 1).
Note : si le lien n'apparait pas, videz le cache de votre boutique (tous les fichiers contenus dans le répertoire tmp de votre installation Oxid e-shop à l'exception du fichier .htaccess) et revenez à l'écran d'accueil de l'admin (bouton Home).


Figure 1



Configuration

Cliquer sur le lien Payline indiqué dans la capture d'écran du paragraphe précédent. L'écran de configuration est affiché (voir Figure 2).
Note : lors du premier affichage de cet écran, un fichier payline_install_<date>.log (<date> au format aaaa-mm-jj) est généré sous le répertoire log de votre installation Oxid e-shop. Il contient la trace de l'insertion des éléments relatifs au plugin Payline dans la base Oxid e-shop.



Figure 2


Authentification

Si vous n'avez pas encore de compte Payline, le lien à la dernière ligne du pavé Module information renvoie vers notre formulaire en ligne permettant de créer un compte de test. Dans le cas contraire, renseignez votre identifiant commerçant et votre clé d'accès dans les champs du pavé Authentication parameters prévus à cet effet.

Proxy

Si les connexions depuis vers votre serveur vers le réseau Internet passent par un proxy, renseignez ses informations dans le pavé Proxy settings.

Contrats

Une fois les pavés Authentication parameters et Proxy settings remplis, cliquez sur le bouton Save configuration. Si votre configuration est incorrecte, un message d'erreur vous indique les champs à rectifier. Sinon, les informations de vos points de ventes sont affichées dans le pavé Contracts settings (voir Figure 3)


Figure 3


Dans la liste déroulante, sélectionnez le point de vente Payline correspondant à votre boutique pour voir les contrats qui lui sont rattachés. Deux cases à cocher sont affichées en face de chaque contrat.
Les contrats pour lesquels la case Primary est cochée seront proposés à l'acheteur sur la page web de paiement Payline. Il est obligatoire de cocher Primary pour au moins 1 contrat
Les contrats pour lesquels la case Secondary est cochée lui seront proposés dans le cas où sa première tentative de paiement est un échec.
Note : si une modification est effectuée sur le point de vente (ajout ou désactivation de contrat, renommge,…) via le centre d'administration Payline, cliquer simplement sur le bouton Save configuration sans rien modifier pour que le pavé Contracts settings soit actualisé.

Paiement

Le dernier pavé de configuration permet de renseigner :

  • Le mode de paiement. Les transactions effectuées en mode authorization devront être validées dans le centre d'administration Payline sous 7 jours pour que le paiement soit effectif. Pour celles effectuées en mode authorization+capture, la validation est automatique et immédiate.
  • Le code d'une personnalisation statique de page web de paiement créée dans le centre d'administration Payline.
  • L'URL d'un template dynamique pour la personnalisation avancée des pages web de paiement.


Activation

Méthode de paiement – paramètres généraux

Par défaut Payline apparait sous le menu Shop Settings > Payment Methods de votre back office OXID eShop sous le nom Payline, comme dans la Figure 4.
Les valeurs des champs Name et Payment Description de l'onglet Main sont celles utilisées pour l'affichage de la méthode de paiement Payline à l'étape 3 du processus de commande.


Figure 4


Méthode de paiement – pays

L'onglet Country permet de sélectionner les pays pour lesquels Payline peut être proposé au client pour réaliser son paiement.

Association à une méthode de livraison

Pour être proposée à l'acheteur, la méthode Payline doit être associée à une méthode de livraison. Cette dernière doit également être associée à des règles de couts, des pays et des groupes utilisateurs pour être active.
Voici les étapes minimales à suivre :

  1. Via le menu Shop Settings > Shipping Cost Rules, créer une règle de cout nommée Basic, englobant les prix allant de 0 à 10000 euros. Associer cette règle à tous les pays, produits et utilisateurs.
  2. Via le menu Shop Settings > Shipping Methods, éditer la méthode Standard pour lui associer la règle de cout Basic créée précédemment.
  3. Via l'onglet Payment de l'écran d'édition de la méthode de livraison Standard, faire le lien avec payline.


Payline sera alors proposé lors de l'étape 3 du processus de commande, et automatiquement associée à la méthode de livraison Standard.
Si les étapes ci-dessus n'ont pas fonctionné, consulter la documentation détaillée fournie par OXID : http://www.oxid-esales.com/fileadmin/files/TechDok/Archiv/oxencz.pdf


Vous avez d’autres questions ? Envoyer une demande

Commentaires

Réalisé par Zendesk