Contenu
La configuration du plugin Payline est répartie en plusieurs volets, accessibles via le menu : Stores > Configuration > SALES > Payment Methods
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 ?
Authentification
Renseignez votre identifiant commerçant et votre clé d'accès dans les deux champs correspondants.
Lorsque les paramètres des deux environnements sont renseignés, un bouton permet d'indiquer quel environnement utiliser
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).
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.
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.
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 configuratin des moyens de paiement.
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.
Dans cette liste :
Annexe technique
Ces contrats sont passés dans la liste selectedContractList du web service doWebPayment.
Sélection des moyens de paiement secondaires
Augmentez votre taux de transformation en permettant immédiatement à vos acheteurs une nouvelle tentative de paiement après un échec.
Sélectionnez dans la liste affichée les moyens de paiement qui seront proposés pour cette retentative.
Annexe technique
Ces contrats sont passés dans la liste secondSelectedContractList du web service doWebPayment.
Vous pouvez ajuster les configurations :
Vous trouvez un détail des paramètres ci-dessous.
Le plugin Payline peut s'intégrer dans le checkout Magento 2 de 3 façons :
Quand souhaitez-vous que vos acheteurs soient débités ?
Annexe 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é.
Activez l'option "Activer les portefeuilles" (Magento et Payline) 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.
Annexe 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.
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.
Le paramétrage par défaut est proposé comme indiqué ci dessous :
Définissez ici la correspondance entre le résultat du paiement renvoyé par Payline, et le statut de la commande.
Le traitement permet de distinguer 7 résultats :
Vous pouvez personnaliser les messages en fonction du type de return code.