WooCommerce

Ce guide vous accompagne dans l’installation, la configuration et l’utilisation du plugin CentralPay pour WooCommerce (WordPress).

ℹ️ La plateforme CentralPay prend en charge différents moyens (carte, virement et prélèvement SEPA, initiation de paiement) et modes de paiement (paiement en une fois, abonnement, en plusieurs fois, etc.). Ce plugin permet uniquement l'encaissement de transactions cartes unitaires. 

Vous souhaitez demander une évolution du plugin, rendez-vous sur https://support.centralpay.com : Support & Paramétrage > Suggérer une nouvelle fonctionnalité.

1. Téléchargement du plugin

• Pour WooCommerce ➝ Télécharger l’archive ZIP du plugin CentralPay

⚠️ Veillez à ne pas la décompresser manuellement.

2. Installation sur WordPress

1. Connectez-vous à votre interface d’administration WordPress
2. Allez dans Extensions > Ajouter
3. Cliquez sur Téléverser une extension
4. Sélectionnez le fichier centralpay220.zip et cliquez sur Installer maintenant
5. Une fois l’installation terminée, cliquez sur Activer l’extension

3. Configuration du module

1. Allez dans WooCommerce > Réglages > Paiements
2. Cliquez sur CentralPay pour accéder à la configuration
3. Renseignez les champs suivants puis cliquez sur Enregistrer les modifications :

Champ	Description	Accès à la donnée
Identifiant marchand	Il s’agit de votre Merchant Public Key. Ne pas confondre avec le Merchant UUID.	Portail Marchand CentralPay > Administration > Technique > Copier « Merchant Public Key »
Login API	Identifiant de votre utilisateur API CentralPay	Portail Marchand CentralPay > Administration > Technique > Cliquer sur votre « Identifiant API » > Copier le « login »
Mot de passe API	Mot de passe de votre utilisateur API CentralPay	Portail Marchand CentralPay > Administration > Technique > Cliquer sur votre « Identifiant API » > Modifier > Générer un mot de passe > Copier le mot de passe > cliquer sur « Mettre à jour »
ID du point de vente	Identifiant unique de votre point de vente (UUID)	Portail Marchand CentralPay > Configuration > Points de ventes > Copiez l’ID du point de vente concerné
Mode test / production	Activez le mode test si vous souhaitez utiliser l’environnement sandbox (les logins et identifiants doivent être ceux de votre profil marchand CentralPay de test).	/
URL de redirection	Redirige vos clients vers une page personnalisée après paiement sur notre formulaire.	Renseignez l’URL de votre page de confirmation de paiement.

4. Statut de commande

Le plugin WooCommerce de CentralPay intègre automatiquement une URL de retour (return_url) dans le lien du formulaire de paiement. Cette URL permet de rediriger le client vers la page de confirmation de commande (/checkout/order-received/) et d’actualiser le statut de la commande en fonction du résultat du paiement.

Si le client final ferme la fenêtre de paiement avant d’être redirigé, la mise à jour de la commande peut ne pas se déclencher correctement côté WooCommerce.

Pour garantir la mise à jour fiable du statut de commande, nous recommandons de mettre en place un Hook (callback serveur à serveur) dans votre Backoffice CentralPay.

Étapes de configuration :

1. Accédez à :
   Production : https://backoffice.centralpay.net/admin/hook/
   Test : https://test-backoffice.centralpay.net/admin/hook/
2. Créez un Hook avec les paramètres suivants :
   • Événement : Point de Vente > TRANSACTION_SUCCEDEED
   • Affecté au Point de Vente : sélectionnez votre Point de Vente WooCommerce
   • URL : https://votre-site-woocommerce.com/?wc-api=cpay_validation
     (Remplacez par l’URL de votre site WooCommerce.)
3. Sauvegardez le Hook

Le paramètre /?wc-api=cpay_validation est nécessaire pour que le plugin WooCommerce de CentralPay reconnaisse la notification et déclenche la mise à jour du statut de la commande.

Cette configuration doit être réalisée à la fois dans votre environnement de test et sur votre profil marchand de production.

5. Personnalisation du logo

Vous pouvez également personnaliser l’interface de paiement en ajoutant le logo de votre site via le Backoffice :

1. Accédez à : https://backoffice.centralpay.net/admin/point_of_sale/
2. Dans le détail de votre Point de Vente, cliquez sur Modifier
3. Importez votre logo dans la section Logo

Ce logo sera affiché directement dans le formulaire de paiement pour une expérience utilisateur plus cohérente.

6. Mode test

• Activez le mode test dans la configuration (attention, vous devez disposer d’un profil marchand CentralPay de test et renseigner les identifiants de ce profil de test)
• Utilisez les cartes de test fournies par CentralPay pour simuler des paiements
• Vérifiez le bon fonctionnement :
  • Du formulaire de paiement
  • Des redirections
  • Des statuts de commande

7. Suivi des paiements

• Retrouvez tous vos paiements dans WooCommerce > Commandes
• Le plugin CentralPay met à jour automatiquement les statuts des commandes
• En cas de besoin, un journal des événements est disponible dans le fichier error.log du plugin

8. Langues disponibles

Le plugin est disponible en :

• 🇫🇷 Français
• 🇬🇧 Anglais

Vous pouvez modifier ou ajouter vos propres traductions via les fichiers .po présents dans le dossier /languages, ou en utilisant un plugin comme Loco Translate.

9. Désinstallation

Pour désinstaller le plugin :

• Désactivez-le via le menu des extensions
• Cliquez sur Supprimer
• Le script de désinstallation supprimera les paramètres du plugin

10. Support

Pour toute question ou assistance, contactez notre support technique depuis https://support.centralpay.com.
Merci d’indiquer votre identifiant marchand, l’URL de votre site et le plus de détails possible sur votre besoin.