WooCommerce

Temps estimé :5 minutes

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

Important : la plateforme CentralPay prend en charge différents moyens de paiement (carte, virement SEPA, prélèvement SEPA, initiation de paiement) et plusieurs modes de paiement (paiement en une fois, abonnement, en plusieurs fois, etc.).
👉 Ce plugin WooCommerce permet uniquement l’encaissement de transactions cartes unitaires. 

Si 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

Téléchargez l’archive ZIP du plugin CentralPay en cliquant ici.

Vous ne devez 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 :
ChampDescriptionAccès à la donnée
Identifiant marchandIl s’agit de votre Merchant Public Key. Ne pas confondre avec le Merchant UUID.Portail utilisateur CentralPay > Administration > Technique > Copier « Merchant Public Key »
Login APIIdentifiant de votre utilisateur API CentralpayPortail utilisateur CentralPay > Administration > Technique > Cliquer sur votre « Identifiant API » > Copier le « login »
Mot de passe APIMot de passe de votre utilisateur API CentralPayPortail utilisateur 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 venteIdentifiant unique de votre point de vente (UUID)Portail utilisateur CentralPay > Configuration > Points de ventes > Copiez l’ID du point de vente concerné
Mode test / productionActivez le mode test si vous souhaitez utiliser l’environnement sandbox (les logins et identifiants doivent être ceux de votre compte de test CentralPay)./
URL de redirectionRedirige 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 compte 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 compte de test CentralPay et renseigner les identifiants de ce compte 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.

CONTENU