...
Ci-dessous un exemple : dans le formulaire vierge, on saisi des identifiants sans préciser l'environnement. A l'enregistrement le module appelle le web service getMerchantSettings dans les deux environnements pour déterminer auquel correspondent les identifiants saisis. Si aucun appel ne fonctionne, une erreur est affichée. Ici le module a déterminé que les identifiants saisis correspondent à l'environnement d'homologation. Le formulaire est rafraichi pour mettre les libellés des champs en cohérence et proposer les champs de saisie pour l'environnement de production.
Annexe technique
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.
Sélecteur d'environnement
...
Lors de la sauvegarde des paramètres d'authentification, le module 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.
Annexe technique
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.
Configuration du paiement
...
- Cochez les moyens de paiement que vous souhaitez proposer à vos clients pour payer leur commande
- Associez-leur une plage de montant pour filtrer leur affichage en fonction du total de la commande
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
Expérience utilisateur
Le module Payline peut s'intégrer dans le checkout Magento 2 de 3 façons :
...
- A la commande : les paiements sont réalisés en mode autorisation+validation
- A l'expédition : les paiement sont réalisés en mode autorisation. Sélectionnez le statut de commande qui déclenche la facturation de la commande, et la validation du paiement
- En différé : les paiements sont réalisés en mode autorisation. Dans le centre d'administration Payline votre contrat VAD est paramétré pour une validation automatique à J+x. Aucune action dans le back office Magento n'interfère avec ce fonctionnement.
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é.
Paiement One Click
Activez cette option 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 module et associé au compte acheteur.
Configuration des statuts de commande
...