Contenu

• Plugin Magento 2 - Intégration
• Plugin Magento 2 - Configuration
• Magento publiera un correctif corrigeant une vulnérabilité

La clé d'accès (Access key) doit être récupérée directement depuis votre centre d'administration Payline, si besoin d'aide, consulter ce lien Qu’est ce que la clé d’accès et où la trouver ?

Identifiant du marchand / Clé d'accès

• • Renseignez votre identifiant commerçant et votre clé d'accès dans les deux champs correspondants.

Environnement

• • Lorsque les paramètres des deux environnements sont renseignés, un bouton permet de sélectionner l'environnement. Veuillez modifier la clé d'accès API.

Nom du commerçant

• • Nom du commerçant obligatoire pour le moyen de paiement Equens, avec le nom dans la configuration du moyen de paiement dans le centre administration de Payline (version 1.2.12).

Smartdisplay

• • Permet de sélectionner les moyens de paiement d'un point de vente d'un commerçant. Ce paramètre éviter d'afficher tous les moyens de paiement. 
    Pour cela il suffit de valoriser ce paramètre et de valoriser la même valeur dans le configuration du menu Affichage des moyens de paiement dans le centre administration de Monext.

Avancé

Debug 

• • Permet le paramétrage des logs pour les Erreurs, Att, Notice, Information.

Utilisation des jetons 

• • Utilisation des token de sesion des webservices permet de faciliter la gestion des notifications. En conservant l'historique, les logs fera apparaitre tous les appels permettant d'analyser un paiement ou une commande. En recyclant le token/jeton de session, cela permet de limiter les accès à Payline dans un délai de 12 minutes : ce cas est spécifique à certains moyens de paiement (maCarte). 
    
    

Désactivation de la bascule à la source

• • Ce paramètre désactive le CDN en cas d’erreur réseau pour réduire les impacts, mais cela peut ralentir le chargement des ressources.

Proxy activé

• • Lors de la sauvegarde des paramètres d'authentification, le plugin détecte si un proxy empêche la connexion vers Payline (la librairie renvoie un erreur code XXXXX, "could not connect to host"). Le cas échéant, 4 champs sont affichés pour la saisie de l'hôte et du port de votre proxy internet, ainsi que des paramètres d'authentification auprès de ce dernier.
    
    
  • Note technique 1
    Le proxy est détecté via la réponse du web service getMerchantSettings.
    Un code retour XXXXX indique une erreur de connexion vers Payline, le message complémentaire "could not connect to host" indique la présence d'un proxy.
    
    
  • Note technique 2
    Le web service getMerchantSettings est appelé lors de la validation du formulaire pour vérifier la bonne saisie des identifiants et déterminer l'environnement.
    Sa réponse doit être stockée pour la configuration des moyens de paiement.

Personnalisation des messages d'erreurs technique (01, 02, 03, 04 et défaut).
Vous pouvez personnaliser les messages en fonction du type de return code.

La liste des moyens de paiement configurés sur votre compte Payline est automatiquement importée lors de la sauvegarde de vos paramètres d'authentification.

Contrats

• • Cochez les moyens de paiement que vous souhaitez proposer à vos acheteurs pour payer leur commande.
• • Note technique
    Ces contrats sont passés dans la liste selectedContractList du web service doWebPayment.

Vous pouvez ajuster les configurations des paiements comptants CPT, des paiements N Fois et des paiements Récurrents.

Payline - Web Payment CPT 

Le plugin Payline peut s'intégrer dans le parcours checkout de Magento 2  :

Actif

• • permet d'activer/désactiver le mode de paiement directement depuis la console.

Titre de l'encart de paiement 

• • Permet de proposer un titre selon vos besoins.

Type d'intégration

• • Redirection: après avoir validé le récapitulatif commande, l'acheteur est redirigé vers la page de paiement Payline. La liste personnalisation de page permet de sélectionner le code de personnalisation, parmi ceux créés via le centre d'administration, qui s'applique à votre page de paiement.
    
    •   Mode redirection : Vous devez vérifier que le paramètre Token de session de L'URL de retour est bien configuré. 
      Le Nom du paramètre du Point de vente doit être paylinetoken pour que l'URL de retour redirige l'acheteur sur la boutique.
      
      
• • Intégré : le formulaire de saisie des données de paiement est partie intégrante du formulaire de checkout. Deux options de mise en page du composant sont disponibles : tab et column
    
    

• Nom du template
•  
  • column : le widget de paiement en colonne, consulter la documentation.
  • tab : le widget de paiement avec des onglets, consulter la documentation.
  • lightbox : le formulaire de saisie des données de paiement apparait dans une fenêtre en surimpression, lorsque le récapitulatif commande est validé, consulter la documentation.

•  Intégration ACS 3DS iframe

• • Permet d'appeler une URL externe avec le widget pour autoriser à s'afficher=YES. Ce paramètre doit être activer uniquement pour le mode Inshop.

Custom payment page code

• • En mode redirection vous pouvez personnaliser une page de paiement hébergée chez Payline. Saisissez l'identifiant de la page dans ce champ, consulter la documentation.

Action de paiement

• • Autoriser et capturer : réalise un paiement à la commande.
  • Autoriser : réalise un paiement à l'expédition. Valider vos commandes dans la console de Magento en sélectionnant le statut de commande qui déclenche la facturation de la commande, et la validation du paiement.
  • Note technique
    Le paiement à la commande correspond au code action 101 dans l'appel à doWebPayment. Pour le paiement en différé et à l'expédition, le code 100 est utilisé. 

Options de retours 

• • Si le paiement échoué alors vous pouvez afficher le panier avec les articles, l'historique des commande ou vider le panier. 

Activer le portefeuille 

• • Permet d'afficher le portefeuille électronique lors du paiement pour proposer l'enregistrement des données de paiement à vos acheteurs.

    Lors de futures commandes, elles seront affichées à côté du formulaire de saisie d'une nouvelle carte.

  • Note technique
    L'activation du One Click correspond à la valorisation du paramètre buyer.walletId de doWebPayment, identifiant uniqué généré par le plugin et associé au compte acheteur.  

Statuts de la commande

Définissez ici la correspondance entre le résultat du paiement renvoyé par Payline, et le statut de la commande. Cette configuration permet d'ajuster certains cas spécifiques de commande.

Web Paiement N fois 

Ce mode de paiement permet aux commerçants de proposer aux acheteurs le paiement des achats en plusieurs échéances en mode uniquement en redirection, consulter la documentation.

Web Paiement Récurrent

Ce mode de paiement permet aux commerçants de proposer aux acheteurs le paiement par abonnement de type récurrent.

Vous devez renseigner les informations nécessaires pour proposer un abonnement,  consulter la documentation.

Il est également proposé de lister les Produits éligibles avec la famille de produit,  les identifiants produits ou les références produits.

Paiements spéciales à redirection

Logs

Permet de tracer tous les appels des web services du plugin entre Magento et Monext.

SoftDescriptor

Le libellé du champ est généré en concaténant le nom du marchand (MerchantName), l'identifiant du panier et la date, le tout limité à une longueur maximale de 22 caractères. Ce champ est traité que si le customer ID existe.