Historique des versions

1. Introduction

Le module de paiement PayXpert permet d'intégrer la passerelle de paiement Connect2Pay dans votre boutique PrestaShop.

Il prend en charge plusieurs modes et méthodes de paiement, les abonnements récurrents, ainsi que la journalisation des transactions.

2. Contraintes

1. La version php minimum du serveur requis est 7.4.

2. La version minimum de PrestaShop est la version 1.7.8.

3. Installation du module

1. Connectez-vous au back-office PrestaShop.

2. Allez dans Modules > Module Manager.

3. Cliquez sur Ajouter un nouveau module.

4. Importez le fichier payxpert.zip depuis notre documentation (https://developers.payxpert.com/integrations/plugins ) ou notre page Github (https://github.com/payxpert )

5. Cliquez sur Installer.

6. Une fois installé, cliquez sur Configurer.

4. Configuration globale du module

Clés API & Information

Open

• Informations sur la configuration du serveur et du CMS

• Formulaire de contact de l’envoi des informations au support : assistance@payxpert.com

• Clé d'API publique et privée : Fournies par mail par PayXpert à la suite de l’ouverture du contrat

• Activation : Oui / Non.

Méthodes de paiement

Open

• Liste des méthodes de paiement : Choisir les méthodes de paiement à afficher en front office

• Activation : par oui ou non

• Le passage de la souris sur les libellés affiche des informations supplémentaires.

Vous pouvez activer/désactiver les méthodes telles que :

• Carte bancaire (Visa, Mastercard...)

• Apple Pay

• Paiements récurrents (si abonnements activés) - Fonction à venir

Paramètres de paiement

Open

• Mode de capture :

  • Automatique : la transaction est automatiquement remise en banque à j+1, les fonds sur le compte apparaitront à j+X, selon conditions particulières du contrat avec PayXpert.

  • Manuelle : Le commerçant a la possibilité de décaler la remise en banque afin par exemple de vérifier son stock. Dans ce cas, il est impératif d’effectuer la remise manuelle avant 7j afin de bénéficier de l’éventuelle garantie (Transfert de responsabilité). A défaut, les fonds seront automatiquement remis en banque au 7^e jour par le module.

• Email de notification pour les captures manuelles : Réception d’une alerte par mail à j+5

• Mode de redirection : Affichage du bloc de paiement en Redirection ou iframe

  • Tous les moyens de paiement ne sont pas éligibles à l’iframe

  • Redirection : la page de paiement apparait dans une nouvelle page du navigateur

  • iframe : le pavé de paiement apparait dans le site marchand.

• Activation du PayByLink : Active le bouton sur les commandes quand le statut est en attente paiement PayByLink. La fonctionnalité permet de renvoyer par mail une demande de transaction pré-renseignée à partir de la transaction initiale.

Paramètres de paiement échelonné

Open

• Si les paiements en plusieurs fois sont activés

• Montant minimum pour proposer le paiement en plusieurs fois : l’option ne sera visible pour les clients que si le panier atteint le minimum indiqué (et prochainement ne dépasse pas le maximum indiqué).

• Pourcentage du premier versement : Le reliquat du panier sera divisé équitablement entre les autres occurrences mensuelles.

  • Par exemple : pour un paiement en 3 fois, premier paiement indiqué à 50%, la 2^e échéance sera de 25% du panier et la 3^e également.

Personnalisation

Open

• Personnalisation des libellés, en français et en anglais

Notifications

Open

• Notification de demande de paiement. Nécessite d’être activé aussi dans le backoffice PayXpert. Contacter votre chargé de compte pour activer l’option.

• Choix de la langue par défaut

5. Utilisation quotidienne

Gestion des transactions

Vous pouvez accéder à vos transactions via Modules > PayXpert > Transactions.

Cette zone affiche les paiements, statuts, dates, et montants :

Open

• ID de transaction : est le numéro à retrouver dans le BO de PayXpert. C’est ce numéro qui permet d’identifier l’unicité d’une transaction.

• Transaction de référence : est présente en cas de chaînage d’une transaction à une autre, comme dans un paiement en plusieurs fois ou d’un abonnement.

• ID de commande : est la référence créée par Prestashop

• Transfert de responsabilité : en cas d’authentification réussie (3DS) par le client, le commerçant bénéficie d’une garantie de paiement durant 7 jours. Temps limite pour la capture manuelle.

• Méthode de paiement : indique le moyen de paiement utilisé par le client

• Operation : présente la nature de l’opération réalisée (Sale, Authorize, Cancel, Refund…)

• Montant : montant total du panier

• Message : Code retour de la plateforme de paiement

• Créé le : est la date de création de la transaction

Vous pouvez également explorer une transaction spécifique. Pour cela, rendez-vous sur Commandes > Détail d’une commande. Affiche un pavé spécifique aux détails des mouvements de paiement PayXpert :

Open

Dans cet onglet, vous retrouvez les informations identiques et vous pouvez en plus modifier les statuts des transactions (Etat), éditer les factures et les bons de livraison

Open

Dans le détail d’une transaction, le tableau de l’onglet PayXpert/Transactions est repris en bas de page. Il est également possible d’utiliser le lien de paiement (via l’envoi d’un email) pour les transactions échouées.

Gestion des abonnements- Fonction à venir

Vous pouvez activer les produits récurrents dans le catalogue.

Vous pouvez les suivre via via Modules > PayXpert > Abonnements.

Remboursements

• Gérez le remboursement total ou partiel directement dans le détail de la commande.

  • Depuis le détail d’une transaction, cliquer sur « Remboursement partiel ». Remplissez la quantité et le montant à rembourser, sélectionner « Générer un avoir » et valider. Le remboursement sera visible dans le détail de la transaction sur le BO Prestashop et comme une transaction (Refund) à part entière sur le BO de PayXpert.

6. Front office

Affiche du bloc de paiement lors de la sélection des paiements. Les logos CB/VISA/Mastercard peuvent se masquer ou s’afficher.

En redirection vers la Page de paiement :

Open

En iframe :

Tous les moyens de paiement ne sont pas compatibles avec le mode d’affichage en iframe :

Open

Lien de paiement

Il est possible depuis le BO du module d’envoyer un lien de paiement à votre client pour une commande, soit depuis une transaction échouée soit par la création d’une nouvelle commande.

Pour accéder à ce service, vous devez modifier le statut d'une commande comme suit :

Open

Dans le détail de la commande, sera alors disponible ces 4 boutons (si les options de paiement en plusieurs fois sont activées).

Open

Open

Votre client recevra alors cet exemple de mail.

Tâches planifiées (CRON)

• Activez les crons pour :

  • effectuer la synchronisation des transactions

  • effectuer le traitement des abonnements

7. Questions Recurrentes

Comment savoir si ma clé API est valide ? Ma clé est invalide

• A la sauvegarde du pavé "Votre compte marchand" (PayXpert/Configuration), un bandeau précise la réussite de la mise à jour, et donc de l'acceptation des clés API publiques et privées.

• Dans le pavé "Informations de configuration CMS " (PayXpert/Configuration), une icône précise la validité des clés API

• En cas de clés API non valides, vérifier l’absence d’espace avant ou après les valeurs. A défaut, contacter le support, pour obtenir de nouvelles clés.

Open

Quels sont les moyens de paiement activés pour mon compte ?

• Il faut distinguer la possibilité de voir le moyen de paiement sur le BO de Prestashop, sur le FrontOffice (FO) en page de checkout et enfin la possibilité de finaliser une transaction avec tel ou tel moyen de paiement.

• Sur le BO de Prestashop, les APM peuvent s'activer sans contrainte :
  
  

  Open

  

   

• Sur le FO, certaines conditions peuvent limiter l'affichage. Par exemple, pour que le bouton ApplePay soit présent, il faut que le client final utilise un device Apple et Safari. Pour le paiement en plusieurs fois, des critères de taille de panier peuvent limiter la présence sur la page de checkout.
  
  

  Open

  

   

• Enfin, pour qu'un paiement puisse se finaliser, le commerçant doit disposer des droits dans le SI de PayXpert. c'est donc une des étapes de vérification à réaliser pour répondre à la question.

Pourquoi ApplePay n'apparait pas dans les moyens de paiement proposés sur le FO ?

ApplePay est activé par défaut sur la page de paiement.

Open

Ce moyen de paiement n'est pas à activer en soi et ne nécessite aucune démarche de la part du client.
Pré-requis :

• Utilisation par le client final d'un device Apple et de Safari (les plus anciennes versions de Safari ne sont pas compatibles avec ApplePay)

• l'utilisation du mode d'affichage en redirection

Le bouton radio ApplePay dans les moyens de paiement sur le BO de Prestashop permet d'afficher le logo ApplePay sur le FO.

Pourquoi une transaction apparait toujours en attente ?

Il existe plusieurs statuts de transactions induites pour le module PayXpert :

• En attente de capture du paiement (PayXpert)

  • Transaction acceptée par le client avec authentification réussie. Il convient de capturer (remettre en banque) la transaction avant le 7e jour pour ne pas perdre les fonds.

• En attente de paiement par PayByLink (PayXpert)

  • Avec ce statut, il est possible d’expédier un mail à un client, soit depuis une nouvelle commande créée dans le BO ou depuis une transaction échouée. Une fois la commande payée, une nouvelle commande (nouveau)

• Les autres statuts (Expédié, Livré, Erreur de paiement, Paiement accepté, Remboursé…) sont natifs à Prestashop, et le module les utilise en fonction de la situation.

Pourquoi je ne reçois pas les notifications par mail de mon activité ?

• Certaines informations ou notifications ne sont pas gérées par le module en lui-même mais par la plateforme de paiement.

• Il faut donc veiller à ne bloquer leur arrivée dans l’environnement marchand, notamment en cas de blocage par le serveur du marchand de certaines IP ou URL.

• L’autre problématique peut provenir du système de mail non/mal paramétré dans le BO de Prestashop (Configurer/Paramètres avancés/Email)
  
  

  Open

  

Je n’arrive pas à installer mon module, et j’ai un message d’erreur

• Dans certains environnements clients, il est possible que lors de l’installation, la mise à jour ou le paramétrage, le module rencontre des difficultés pour exécuter l’action demandée.

• Les actions possibles :

  • Vider le cache : Configurer/Paramètres avancés/Performance puis cliquer sur « Vider le cache »

  • Désinstaller le module et réinstaller la dernière version.

L’affichage de ma page de checkout est anormale ?

• La page de checkout est essentiellement gérée par le module de paiement PayXpert, mais des conflits peuvent apparaitre notamment en cas de surcharge ou avec d’autres modules/thèmes installés.

• Pour vérifier lequel, il est conseillé de les désinstaller, vider le cache et tester l’affichage.

• Dans le panneau de configuration du module PayXpert, il est possible de vérifier également la présence d’une surcharge ou d’un thème.
  
  

  Open