Passerelle Waarie pour WooCommerce (WordPress)

Acceptez instantanément les paiements Mobile Money (Wave, Orange Money, MTN MoMo, Moov Money) et Cartes Bancaires (Visa, Mastercard) sur votre boutique WooCommerce en Afrique de l'Ouest (Sénégal, Côte d'Ivoire, Bénin, Togo, Mali, Burkina Faso) et Centrale.

🚀 Installation Rapide

Méthode 1 : Via l'administration WordPress (Fichier ZIP)

1. Téléchargez l'archive waarie-woocommerce-plugin.zip depuis votre espace Console Marchand Waarie > Développeurs > Téléchargements.
2. Dans votre tableau de bord WordPress, rendez-vous dans Extensions > Ajouter une extension > Téléverser une extension.
3. Sélectionnez le fichier .zip et cliquez sur Installer maintenant, puis sur Activer l'extension.

Méthode 2 : Via FTP / Dossier wp-content

1. Décompressez l'archive dans le dossier /wp-content/plugins/waarie-woocommerce/.
2. Rendez-vous dans Extensions installées et activez Waarie Payments for WooCommerce.

⚙️ Configuration

1. Dans votre tableau de bord WordPress, allez dans WooCommerce > Réglages > Onglet Paiements.
2. Cliquez sur Gérer en face de la passerelle Waarie (Mobile Money & Cartes).
3. Renseignez les paramètres suivants :
   • Activer la passerelle : Cochez pour afficher Waarie au checkout.
   • Mode Test (Sandbox) : Cochez pour tester sans débiter de fonds réels.
   • Clé Secrète Test (sk_test_...) : Copiez votre clé test depuis la console Waarie.
   • Clé Secrète Live (sk_live_...) : Copiez votre clé live de production.
   • Secret Webhook : Copiez le secret webhook fourni par la console Waarie.
4. Cliquez sur Enregistrer les modifications.

🔔 Configuration du Webhook (Validation Instantanée)

Pour que WooCommerce valide automatiquement les commandes payées par vos clients dès confirmation par l'opérateur Mobile Money :

1. Connectez-vous à votre Console Marchand Waarie.
2. Rendez-vous dans Webhooks > Ajouter un point de terminaison (Endpoint).
3. Entrez l'URL webhook WooCommerce affichée directement dans la page de configuration du plugin :

   https://votre-boutique.com/?wc-api=wc_gateway_waarie

4. Sélectionnez les événements payment.completed et payment.failed.
5. Sauvegardez et collez la clé secrète générée dans le champ Secret Webhook de WooCommerce.

🛠️ Fonctionnalités Clés

• ✅ Redirection Sécurisée & Hébergée : Pas besoin de conformité PCI-DSS lourde sur votre serveur WordPress.
• ✅ Support Multi-Devises : XOF (FCFA UEMOA), XAF (FCFA CEMAC), EUR, USD.
• ✅ Validation Cryptographique HMAC-SHA256 : Protection contre les fausses confirmations d'opérateurs ou attaques de rejeu.
• ✅ Gestion Automatique des Statuts de Commande :
  • Paiement réussi : Commande passée à En cours (ou Terminée si produits virtuels).
  • Échec : Commande passée à Échouée avec note d'audit privée dans l'historique WooCommerce.
• ✅ Mode Sandbox Intégré : Simulez des paiements Wave et Orange Money instantanément sans compte marchand bancaire vérifié.

🔒 Sécurité & Idempotence

Chaque tentative de transaction génère un jeton d'idempotence unique basé sur l'identifiant de la commande WooCommerce (order_id) et le timestamp de commande pour éliminer tout risque de double facturation.

📄 Licence

Ce plugin est distribué sous licence MIT. Support technique : support@waarie.com