WalleoPay pour WooCommerce
| 开发者 |
vsptech
walleopay |
|---|---|
| 更新时间 | 2026年11月10日 11:37 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 6.7 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
- Redirection vers la page de paiement hébergée par WalleoPay : aucune donnée sensible ne transite par votre serveur.
- Notifications (webhooks) signées en HMAC SHA-256, vérifiées en temps constant et fenêtre de tolérance de 300 secondes.
- Aucune commande n’est marquée payée sur la seule foi d’un webhook ou d’un retour navigateur. L’extension ré-interroge systématiquement l’API WalleoPay et contrôle que le montant et la devise correspondent à la commande avant validation.
- Gestion du statut « en attente de confirmation » (paiement au code marchand) : la commande passe en attente avec une note explicative, puis est validée automatiquement une fois le rapprochement terminé.
- Bouton « Rafraîchir le statut WalleoPay » sur l’écran de commande, et action équivalente dans la liste déroulante des actions de commande.
- Compatible avec le stockage haute performance des commandes (HPOS).
- Journalisation via WooCommerce → État → Journaux (source « walleopay »), sans jamais écrire les clés secrètes.
- Aucune dépendance : uniquement l’API HTTP de WordPress.
安装:
- Copiez le dossier de l’extension dans
wp-content/plugins/walleopay-for-woocommerce, ou téléversez l’archive ZIP depuis Extensions → Ajouter. - Activez « WalleoPay pour WooCommerce ».
- Rendez-vous dans WooCommerce → Réglages → Paiements → WalleoPay.
- Choisissez le mode (Test ou Production) et collez la clé secrète correspondante (
sk_test_…ousk_live_…), disponible dans votre tableau de bord WalleoPay. - Dans le tableau de bord WalleoPay, rubrique Applications → Notifications, copiez le secret de signature (
whsec_…, un seul par compte, le même en test et en production) et collez-le dans le champ « Secret de webhook ». L’adresse de notification (de la formehttps://votre-boutique.tld/wc-api/walleopay) n’a pas à être déclarée : l’extension l’envoie avec chaque paiement, et WalleoPay la préfère à l’URL par défaut du compte. - Cochez « Activer le paiement WalleoPay » et enregistrez.
常见问题:
Dans quelle devise dois-je configurer ma boutique ?
En francs CFA (XAF). WalleoPay encaisse des montants entiers en francs, entre 100 et 1 000 000 FCFA. Un avertissement s’affiche dans les réglages si la devise de la boutique n’est pas XAF.
Pourquoi une commande reste-t-elle « en attente » ?
Le statut awaiting_confirmation signifie que le client a payé au code marchand et que le rapprochement est effectué manuellement par WalleoPay ; cela peut prendre plusieurs heures. La commande est placée en attente avec une note, puis validée automatiquement dès réception de la confirmation. Vous pouvez aussi cliquer sur « Rafraîchir le statut WalleoPay » dans l’encart de la commande.
L’URL de notification n’est pas accessible depuis Internet, est-ce grave ?
Oui : sans webhook, les commandes ne seront validées qu’au retour du client sur la boutique. Si le client ferme son navigateur avant de revenir, il faudra rafraîchir le statut manuellement. Sur un site en développement ou derrière une authentification HTTP, exposez l’URL ou utilisez un tunnel.
Le webhook est-il suffisant pour valider une commande ?
Non, et l’extension ne s’y fie jamais. Après vérification de la signature et de l’horodatage, elle ré-interroge GET /payments/{id} et n’accepte la commande que si l’API répond succeeded avec un montant (commission du client mise à part) et une devise identiques à ceux de la commande. En cas d’écart, la commande est placée en attente avec une note, jamais validée.
Le mode Test utilise-t-il de l’argent réel ?
Oui. Le mode Test n’est pas une simulation : il passe par un vrai canal de paiement, débite réellement le client et crédite votre solde WalleoPay, commission comprise. Seuls les clés, l’historique et les statistiques restent séparés de la production. Choisissez le mode Test, utilisez votre clé sk_test_… et faites vos essais avec de petits montants. Le mode effectivement appliqué découle toujours de la clé utilisée, jamais d’un paramètre de requête.
Mon client peut-il réessayer après un paiement échoué ou expiré ?
Oui. La commande reste payable, et « Payer la commande » ouvre une nouvelle tentative sous sa propre référence (numéro de commande, puis -2, -3…) et sa propre clé d’idempotence. Une nouvelle tentative ne s’ouvre qu’une fois la précédente close : il n’y a jamais deux paiements payables à la fois pour une même commande, et un paiement réussi ou en cours de rapprochement bloque toute nouvelle demande.
Mon client paie la commission : la commande est-elle validée ?
Oui. Quand la commission est à la charge du client, WalleoPay l’ajoute au montant demandé : le paiement porte sur le total de la commande plus la commission. L’extension met la commission de côté avant de comparer, valide la commande et ajoute une note indiquant la commission payée. Tout autre écart laisse la commande en attente.
Où consulter les échanges avec l’API ?
Activez « Journalisation » dans les réglages, puis ouvrez WooCommerce → État → Journaux et sélectionnez la source « walleopay ». Les clés secrètes et secrets de webhook y sont systématiquement masqués.
更新日志:
- Première version publique.
- Création de paiement avec clé d’idempotence déterministe et redirection vers la page de paiement WalleoPay.
- Tentatives de paiement : après un échec, une annulation ou une expiration, « Payer la commande » ouvre une nouvelle tentative (référence suffixée
-2,-3…, clé propre), jamais deux paiements payables à la fois ; la notification d’une tentative remplacée ne touche plus la commande ; un second paiement réussi est signalé par une note. - Webhook signé (HMAC SHA-256,
hash_equals, tolérance de 300 s) avec re-vérification obligatoire auprès de l’API. - Contrôle du montant et de la devise avant toute validation de commande.
- Page de retour client re-vérifiée côté serveur.
- Encart d’administration et action de commande « Rafraîchir le statut WalleoPay ».
- Compatibilité HPOS déclarée.