Historique des versions

1. Introduction

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

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.2.

2. La version minimum de Wordpress est la version 6.0

3. La version minimum de Woocommerce est la version 7.6.0.

3. Installation du module

1. Connectez-vous au back-office Wordpress.

2. Allez dans Extension > Ajouter une extension.

3. Cliquer sur le bouton « Téléverser une extension »

4. Importez le fichier payxpert.zip depuis notre documentation (PayXpert ) ou notre page Github (PayXpert )

5. Cliquez sur Installer maintenant.

6. Une fois installé, aller dans Woocommerce > PayXpert.

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

• Renseigner Identifiant de l’expéditeur / mot de passe fournis

• Cliquer sur le bouton « Se connecter »

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.

Méthodes de paiement

Open

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

  • Cartes Bancaires CB/Visa/MasterCard

  • American Express

  • Paiement En 2 fois par carte

  • Paiement en 3 fois par carte

  • Paiement en 4 fois par carte

  • ApplePay

• Activation : par case à cocher.

Personnalisation

Open

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

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 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.

• Renseigner l’adresse mail du destinateur de la notification

• Choix de la langue par défaut

5. Utilisation quotidienne

Gestion des transactions

Open

Vous pouvez accéder à vos transactions via Woocommerce > PayXpert - Transaction

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

• ID : est la référence créée par Woocomerce

• Numéro de commande : est la référence de commande créée par Woocommerce

• 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

• Montant : montant total du panier

• Devise : Devise de la transaction

• 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…)

• Résultat : 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 > Clique sur la commande. Affiche un bloc spécifique aux détails des mouvements de paiement PayXpert :

Remboursements

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

  • Depuis la commande, cliquer sur « Remboursement ».

  • Cocher si vous souhaitez remettre en stock les articles remboursés.

  • Remplissez le montant à rembourser

  • Remplissez le motif de remboursement (facultatif)

  • Cliquer sur Rembourser manuellement ou cliquer sur Remboursement via Cartes bancaire par Payxpert

  • Le remboursement sera visible dans le détail de la transaction sur le BO Woocommerce 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.

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

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.

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 Woocomerce, 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 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.

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.

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 :

• Capture du paiement en attente (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.

• Paiement échelonnés en attente (PayXpert)

  • Statuts de commande lors d’une transaction par paiement échelonné non complète.

• Les autres statuts (En cours, Terminée, Echoué, Annulée, Remboursée…) sont natifs à Woocommerce, 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 Woocommerce (Réglages/E-mails)

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 :

  • 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.