WalleoPay pour WooCommerce

FAQ

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.