Plugin WooCommerce

Le plugin CajouPay pour WooCommerce ajoute à votre boutique le moyen de paiement Payer avec mon application bancaire (PI-SPI) : le client paie tout de suite, dans l'application de sa banque ou de son portefeuille mobile.

Prérequis : WordPress 6.6, WooCommerce 9.0 et PHP 8.1 ou plus récents, boutique en francs CFA (XOF) avec des prix entiers. Le paiement en blocs et le tunnel de commande classique sont pris en charge.

Installation

1. Extensions › Ajouter › Téléverser : choisissez cajoupay-woocommerce.zip, puis activez.
2. WooCommerce › Réglages › Paiements › CajouPay (PI-SPI) :
   • cochez Activer ;
   • collez votre clé secrète de test (sk_test_…), et plus tard celle de production ;
   • laissez Mode test coché tant que vous testez. L'enregistrement vérifie la clé auprès de CajouPay.
3. Dans le tableau de bord CajouPay, Développeurs › Webhooks, ajoutez l'adresse affichée dans les réglages (https://votre-boutique.ci/wp-json/cajoupay/v1/webhook) et collez son secret whsec_… dans le plugin. Sans webhook, une commande se met à jour au retour du client sur votre site, mais pas s'il ferme la page avant.

Statuts des commandes

Côté CajouPay	Commande WooCommerce
Paiement reçu	En cours (ou Terminée pour un produit virtuel), avec le TxId et le montant crédité en note
Refusé, expiré ou en échec	Échouée : le client peut payer à nouveau depuis son compte
Commande annulée	le paiement CajouPay encore ouvert est annulé

Le lien de la transaction, sur la commande, ouvre le paiement dans votre tableau de bord CajouPay. Si le montant payé ne correspond pas à la commande, elle passe En attente avec une note.

Tester

En mode test, passez une commande et utilisez les alias de test sur la page de paiement : +225 0000000001 paie, +225 0000000002 refuse.

Journal

Cochez Journal dans les réglages : les échanges avec CajouPay s'affichent dans WooCommerce › État › Journaux (source cajoupay). Ni les clés ni les alias complets n'y figurent.

Les remboursements ne se font pas encore depuis WooCommerce.