WordPress Plugin
Le plugin officiel Kobara WordPress permet d’accepter facilement les paiements MonCash sur votre boutique WooCommerce sans écrire de code.
Le plugin transforme votre site WordPress en plateforme de paiement moderne connectée à :
- Kobara ;
- MonCash ;
- votre dashboard Kobara ;
- vos webhooks ;
- vos analytics.
Fonctionnalités principales
Le plugin permet :
✅ Paiements MonCash WooCommerce ✅ Checkout sécurisé Kobara ✅ Mode Test & Live ✅ Synchronisation automatique des paiements ✅ Notifications temps réel ✅ Support Webhooks ✅ Historique des transactions ✅ Gestion automatique des commandes ✅ Compatible mobile ✅ Compatible WooCommerce moderne
Compatibilité
| Système | Support |
|---|---|
| WordPress 6+ | ✅ |
| WooCommerce | ✅ |
| PHP 8+ | ✅ |
| Elementor | ✅ |
| Astra Theme | ✅ |
| Flatsome | ✅ |
Installation
Téléchargez le plugin officiel :
Terminalkobara-woocommerce-gateway.zip
Étape 1 — Télécharger le plugin
Dans votre dashboard Kobara :
TerminalDevelopers → Integrations → WordPress Plugin
Cliquez :
TerminalDownload Plugin
Étape 2 — Installer dans WordPress
Dans votre dashboard WordPress :
TerminalExtensions → Ajouter
Puis :
TerminalTéléverser une extension
Sélectionnez :
Terminalkobara-woocommerce-gateway.zip
Cliquez :
TerminalInstaller maintenant
Étape 3 — Activer le plugin
Après installation :
TerminalActiver l’extension
Étape 4 — Activer Kobara dans WooCommerce
Dans WordPress :
TerminalWooCommerce → Réglages → Paiements
Activez :
TerminalKobara WooCommerce Gateway
Étape 5 — Ajouter vos clés API
Dans les paramètres Kobara WooCommerce :
Clé publique
Terminalkbr_pk_live_xxxxx
Clé secrète
Terminalkbr_sk_live_xxxxx
Étape 6 — Configurer le mode
Le plugin supporte :
| Mode | Description |
|---|---|
| Test | Développement |
| Live | Paiements réels |
Test Mode
Utiliser :
Terminalkbr_pk_test_ kbr_sk_test_
Live Mode
Utiliser :
Terminalkbr_pk_live_ kbr_sk_live_
Fonctionnement du paiement
1. Client clique “Payer”
Sur votre boutique WooCommerce.
2. WooCommerce appelle Kobara
Le plugin :
- sécurise les données ;
- crée le paiement Kobara ;
- contacte l’API Kobara.
3. Kobara communique avec MonCash
Kobara :
- prépare le checkout MonCash ;
- sécurise la transaction ;
- génère la session paiement.
4. Redirection MonCash
Le client est redirigé vers :
Terminalcheckout.kobara.app
5. Confirmation paiement
Après paiement :
- Kobara reçoit confirmation ;
- le webhook est déclenché ;
- WooCommerce met à jour la commande.
Statuts WooCommerce
| Statut | Description |
|---|---|
| Pending | Paiement en attente |
| Processing | Paiement reçu |
| Completed | Paiement terminé |
| Failed | Paiement échoué |
| Refunded | Paiement remboursé |
Webhooks automatiques
Le plugin configure automatiquement :
- synchronisation paiements ;
- confirmation commandes ;
- mise à jour temps réel.
URL Webhook WooCommerce
Exemple :
Terminalhttps://votre-site.com/?wc-api=kobara_webhook
Vérification signature
Le plugin vérifie automatiquement :
- la signature webhook ;
- la sécurité ;
- la validité des événements.
Interface Checkout
Le plugin fournit :
- checkout mobile-first ;
- expérience MonCash moderne ;
- paiement rapide ;
- UX optimisée Haïti.
Fonctionnalités avancées
Support QR Code
Le plugin peut afficher :
- QR paiement ;
- liens rapides ;
- checkout mobile.
Paiements mobiles
Compatible :
- Android ;
- iPhone ;
- navigateur mobile ;
- application MonCash.
Notifications automatiques
Le plugin peut :
- envoyer email confirmation ;
- mettre à jour commande ;
- notifier admin ;
- synchroniser dashboard Kobara.
Dashboard Kobara
Toutes les transactions apparaissent automatiquement dans :
TerminalDashboard → Payments
Données synchronisées
| Donnée | Synchronisée |
|---|---|
| Paiements | ✅ |
| Clients | ✅ |
| Commandes | ✅ |
| Montants | ✅ |
| Status | ✅ |
| Retraits | ✅ |
Sécurité
Le plugin :
- utilise HTTPS ;
- chiffre les requêtes ;
- utilise les webhooks signés ;
- protège les clés API.
Important sécurité
⚠️ Vos Secret Keys restent uniquement sur votre serveur WordPress.
Elles ne sont jamais :
- envoyées au navigateur ;
- exposées au client ;
- visibles publiquement.
Architecture sécurisée
TerminalClient ↓ WooCommerce ↓ Plugin Kobara ↓ API Kobara ↓ MonCash Infrastructure ↓ MonCash
Gestion des erreurs
Le plugin gère automatiquement :
- paiements échoués ;
- timeout ;
- erreurs réseau ;
- annulations utilisateur.
Messages utilisateur
Exemple :
TerminalPaiement confirmé avec succès.
ou :
TerminalLe paiement a échoué. Veuillez réessayer.
Logs WooCommerce
Disponible dans :
TerminalWooCommerce → Status → Logs
Sandbox & Tests
Le mode test permet :
- tester sans argent réel ;
- simuler paiements ;
- tester webhooks ;
- tester WooCommerce.
Bonnes pratiques
À faire
✅ utiliser HTTPS ✅ activer webhooks ✅ utiliser mode test avant production ✅ sauvegarder WordPress ✅ utiliser clés Live uniquement en production
À éviter
❌ exposer Secret Key ❌ modifier le plugin directement ❌ utiliser le mode live pendant les tests
Cas d’utilisation
Le plugin est idéal pour :
- boutiques ecommerce ;
- ventes digitales ;
- formations ;
- abonnements ;
- dons ;
- marketplaces ;
- SaaS.