BluePay for WooCommerce
Ajoutez BluePay à votre boutique WordPress sans écrire une ligne de code.
⬇ Télécharger bluepay-for-woocommerce.zipInstallation
Installer le plugin
Dans votre panneau WordPress, allez dans Extensions → Ajouter → Mettre en ligne une extension, puis sélectionnez le fichier bluepay-woocommerce.zip et cliquez sur Activer.
Accéder aux réglages
Allez dans WooCommerce → Réglages → Paiements. BluePay apparaît dans la liste — cliquez sur Gérer.
Récupérer vos clés
Dans votre Dashboard BluePay, copiez votre Clé API (Paramètres → Clés API) et votre Secret Webhook (Paramètres → Webhooks).
Configuration
| Champ | Description |
|---|---|
| Clé API | bluepay_test_… (test) ou bluepay_live_… (production). Disponible dans Dashboard → Clés API. |
| Secret Webhook | Clé secrète pour valider les notifications IPN. Dashboard → Paramètres → Webhooks. |
| Environnement | Test = aucun vrai paiement. Production = paiements réels. |
| Statut après paiement | "Terminé" pour les produits numériques, "En cours" pour les commandes physiques. |
bluepay_test_…. Aucun vrai paiement ne sera débité.Webhook IPN
BluePay notifie votre boutique à chaque paiement confirmé. Configurez l'URL suivante dans Dashboard → Webhooks :
https://votre-boutique.sn/bluepay/ipnLe plugin vérifie automatiquement la signature HMAC-SHA256 de chaque notification :
$body = file_get_contents('php://input');
$signature = $_SERVER['HTTP_X_BLUEPAY_SIGNATURE'] ?? '';
$expected = hash_hmac('sha256', $body, $webhook_secret);
if (!hash_equals($expected, $signature)) {
http_response_code(401);
die('Signature invalide');
}
// ✓ Paiement confirmé — mettre à jour la commande WooCommerce
$payload = json_decode($body, true);
$order_id = $payload['data']['metadata']['order_id'];
$order = wc_get_order($order_id);
$order->payment_complete();Tester
Clé API test
bluepay_test_a8be60f2d216b37b9c2133a5d4c2a5a9
Environnement
Test
Numéro téléphone
N'importe quel numéro à 9 chiffres
Résultat
Commande marquée payée (simulé)
ngrok http 80. Copiez l'URL https://xxxx.ngrok.io/bluepay/ipn dans le dashboard.Dépannage
La commande reste en "En attente" après le paiement›
BluePay n'a pas pu atteindre votre URL IPN. Vérifiez l'URL configurée dans le dashboard et que votre site est accessible depuis internet.
Erreur "Signature invalide" dans les logs›
Le Secret Webhook du plugin ne correspond pas à celui du Dashboard. Recopiez la valeur exacte sans espaces.
Le module n'apparaît pas sur la page de paiement›
Vérifiez que la case "Activer" est cochée dans les réglages et que la clé API est renseignée.
Prêt à accepter des paiements ?
Téléchargez le plugin et créez votre compte — opérationnel en moins d'une heure.