WordPress et WooCommerce

Le plugin officiel ajoute Cartflox comme moyen de paiement de votre boutique WooCommerce. Cinq minutes, sans code, et tout se règle depuis WooCommerce.

Télécharger cartflox-payment.zipPlugin officiel, version 4.0.0. WordPress 6.2+, WooCommerce 7.6+, PHP 7.4+.

Installation

WordPress : Extensions, Ajouter, Téléverser une extension. Choisissez le fichier .zip, Installer maintenant, puis Activer.
WooCommerce : Réglages, Paiements, Cartflox, Gérer.
Collez votre clé secrète af_live_sec_... (tableau de bord Cartflox, rubrique API et journaux). Elle fonctionne pour un espace Cartflox comme pour un espace Cartflox Connect.
Enregistrez. Le plugin vérifie la clé et déclare lui-même l’adresse de webhook de votre boutique dans Cartflox. Le panneau « État de la connexion » vous dit où vous en êtes, et le bouton « Tester la connexion » le confirme à tout moment.

Ce que fait le plugin

À la validation de la commande, crée une session Cartflox et envoie le client sur la page de paiement (Mobile Money, carte). Le client revient ensuite sur votre boutique.
Reçoit le webhook signé (HMAC-SHA256 vérifié avec votre clé secrète, horodatage contrôlé) et passe la commande en « payée », sans action du client.
Au retour du client, interroge le statut de la session si le webhook n’est pas encore arrivé ; la page de remerciement se met à jour toute seule pendant la confirmation.
Toutes les 5 minutes, vérifie les commandes encore en attente (24 h) : filet de sécurité si le webhook ne peut pas arriver.
Contrôle que le montant et la devise reçus correspondent à la commande ; sinon elle passe « en attente » avec une note explicative.
Sur chaque commande, une boîte Cartflox : statut du paiement, opérateur, référence, bouton « Vérifier maintenant », lien vers la transaction dans Cartflox.
Compatible tunnel de commande classique et en blocs, stockage des commandes HPOS.

Réglages

Section	Ce que vous réglez
Connexion à Cartflox	Activation, clé secrète, état de la connexion, test
Affichage au paiement	Titre, description, logos affichés (Orange Money, Wave, MTN MoMo, Moov Money, carte, M-Pesa, Airtel Money, Free Money, T-Money) et leur taille, texte du bouton de commande, message sur la page de remerciement
Parcours de paiement	Pré-remplissage du nom, de l’e-mail et du téléphone, libellé de la session (variables `{numero}`, `{boutique}`, `{client}`, `{total}`), adresse de retour après paiement, retour après abandon
Commandes	Statut en attendant le paiement, statut une fois payée, vérification automatique, annulation automatique après un délai, référence Cartflox dans les e-mails
Frais et limites	Frais fixes ou en pourcentage quand le client choisit Cartflox, montant minimum et maximum, devises acceptées
Avancé	Enregistrement automatique du webhook, journal détaillé, adresse de l’API

Montants

Cartflox attend des montants entiers : les devises à décimales (USD, EUR, GHS…) sont arrondies à l’unité. Pour le XOF et le XAF, rien ne change. Le numéro de téléphone du client est converti au format international à partir de son pays de facturation.

Pour les développeurs

Filtre cartflox_session_donnees( $donnees, $order ) : modifiez les données envoyées à Cartflox avant la création de la session.
Filtre cartflox_montant_frais( $montant, $cart ) : calculez vous-même les frais de paiement.
Action cartflox_paiement_confirme( $order, $data ) : déclenchée dès qu’un paiement est confirmé.
Journal : WooCommerce, Statut, Journaux, source cartflox.