Intégration WordPress

​

Prérequis

• WordPress 5.0 ou supérieur
• WooCommerce 4.0 ou supérieur
• PHP 7.4 ou supérieur
• Un compte marchand Yabetoo avec les clés API
• Un certificat SSL installé (HTTPS requis)

​

Installation

​

Méthode 1 : Répertoire des plugins WordPress (Recommandé)

1. Allez dans votre tableau de bord WordPress admin
2. Naviguez vers Extensions > Ajouter
3. Recherchez “Yabetoo Payment Gateway”
4. Cliquez sur Installer maintenant, puis Activer

​

Méthode 2 : Installation manuelle

1. Téléchargez le plugin depuis Yabetoo Dashboard
2. Allez dans Extensions > Ajouter > Téléverser une extension
3. Sélectionnez le fichier ZIP téléchargé
4. Cliquez sur Installer maintenant, puis Activer

​

Configuration

​

Étape 1 : Accéder aux paramètres du plugin

1. Allez dans WooCommerce > Réglages
2. Cliquez sur l’onglet Paiements
3. Trouvez “Yabetoo” et cliquez sur Gérer

​

Étape 2 : Configurer les clés API

Activer/Désactiver : ✓ Activer la passerelle de paiement Yabetoo
Titre : Paiement Mobile Money
Description : Payez en toute sécurité avec Mobile Money (MTN, Airtel)

Paramètres API :
- Clé secrète : sk_test_XXXXXXXXXXXXXXXXXXXXXXXX
- Clé publique : pk_test_XXXXXXXXXXXXXXXXXXXXXXXX
- Environnement : Sandbox (pour les tests) / Production (pour le live)

​

Étape 3 : Configurer le Webhook

1. Dans votre tableau de bord Yabetoo, allez dans Développeurs > Webhooks
2. Ajoutez un nouveau webhook avec l’URL : https://votreboutique.com/?wc-api=yabetoo_webhook
3. Sélectionnez les événements : intent.completed, disbursement.completed
4. Copiez le secret du webhook et collez-le dans les paramètres du plugin

​

Étape 4 : Tester l’intégration

1. Gardez l’environnement sur Sandbox
2. Créez une commande test sur votre boutique
3. Complétez le paiement avec les numéros de téléphone de test
4. Vérifiez que le statut de la commande se met à jour correctement

​

Numéros de téléphone de test

​

Passer en Production

1. Connectez-vous à votre Tableau de bord Yabetoo
2. Complétez le processus de vérification du compte
3. Obtenez vos clés API de production
4. Mettez à jour les paramètres du plugin :
   • Remplacez les clés de test par les clés de production
   • Changez l’environnement en Production
5. Mettez à jour l’URL du webhook pour utiliser l’endpoint de production

​

Fonctionnalités

​

Méthodes de paiement supportées

• MTN Mobile Money - Congo, Cameroun, Côte d’Ivoire
• Airtel Money - Congo, Gabon
• Orange Money - Cameroun, Côte d’Ivoire

​

Gestion des commandes

• Met à jour le statut de la commande quand le paiement est confirmé
• Envoie les emails de confirmation de commande
• Enregistre les détails du paiement dans les notes de commande
• Gère les notifications webhook

​

Options de personnalisation

​

Dépannage

​

Le paiement ne se traite pas

1. Vérifiez que les clés API sont correctes
2. Vérifiez que le certificat SSL est valide
3. Assurez-vous que l’URL du webhook est accessible
4. Consultez les logs WooCommerce dans WooCommerce > État > Journaux

​

Le webhook ne reçoit pas les événements

1. Vérifiez que l’URL du webhook est correcte dans le tableau de bord Yabetoo
2. Vérifiez que votre serveur autorise les requêtes POST
3. Assurez-vous que le secret du webhook correspond aux deux endroits
4. Testez la connectivité du webhook depuis le tableau de bord

​

Le statut de la commande ne se met pas à jour

1. Vérifiez que le webhook est configuré correctement
2. Vérifiez que le secret du webhook correspond
3. Consultez les logs d’erreur PHP
4. Assurez-vous que WooCommerce est à jour

​

Hooks et Filtres

// Modifier la description du paiement
add_filter('yabetoo_payment_description', function($description, $order) {
    return 'Paiement pour la commande #' . $order->get_id();
}, 10, 2);

// Action personnalisée après un paiement réussi
add_action('yabetoo_payment_complete', function($order_id, $transaction_id) {
    // Votre logique personnalisée ici
}, 10, 2);

// Modifier les pays supportés
add_filter('yabetoo_supported_countries', function($countries) {
    return ['CG', 'CM', 'CI', 'GA'];
});

​

Questions Fréquentes

​

Support

• Email : [email protected]
• Documentation du plugin : Outils développeur
• Documentation API : Référence API