VibeFox Pesapal for PrestaShop

Présentation

VibeFox Pesapal Pay Gateway ajoute les paiements Pesapal à PrestaShop. Il se connecte à l’API 3.0 de Pesapal. À l’étape du paiement, le client choisit Pesapal, est redirigé vers la page de paiement Pesapal et paie avec M-Pesa, Airtel Money, MTN, par carte, par virement bancaire ou avec un autre moyen proposé par Pesapal dans son pays. Les données de carte ne transitent jamais par votre site. La commande n’est créée qu’après la confirmation du paiement par Pesapal : les paiements abandonnés ne laissent donc aucune commande impayée.

Il convient aux boutiques du Kenya, d’Ouganda, de Tanzanie, du Rwanda, de Zambie, du Malawi et du Zimbabwe qui vendent en KES, UGX, TZS, ZMW, RWF ou USD et disposent d’un compte marchand Pesapal. Seuls la clé et le secret consommateur sont nécessaires. Le module ne propose ni remboursement depuis la page de commande (le remboursement se fait dans le tableau de bord Pesapal), ni cartes enregistrées, ni abonnements ou paiements récurrents, ni formulaire de paiement sur votre propre site, ni conversion de devises.

Principales fonctionnalités

Payée uniquement après confirmation de Pesapal : les notifications de Pesapal et le retour du client ne contiennent aucune donnée de paiement ; le module ne leur fait donc jamais confiance. À chaque fois, il demande à Pesapal le statut de la transaction au moyen d’une requête authentifiée de serveur à serveur.

Contrôle du montant et de la devise : la commande n’est marquée comme payée que lorsque Pesapal signale le paiement comme terminé et que le montant et la devise payés correspondent au panier. En cas d’écart, la commande passe en Pesapal payment on hold avec une note.

Configuration automatique de l’IPN : l’URL de notification est enregistrée auprès de Pesapal lors du premier paiement, séparément pour le sandbox et la production. Rien n’est à configurer dans le tableau de bord Pesapal.

Aucun double traitement : les notifications répétées et une notification reçue en même temps que le retour du client ne créent jamais une seconde commande. Les commandes annulées et remboursées ne sont jamais rouvertes, et un second paiement pour une commande déjà payée est signalé pour remboursement.

Chaque tentative est conservée : un paiement effectué sur une ancienne page Pesapal du même panier, par exemple dans un second onglet du navigateur, est tout de même reconnu.

Modes sandbox et production : des clés distinctes pour chaque mode. Un paiement est toujours vérifié dans le mode dans lequel il a été lancé.

Annulations de paiement : un paiement signalé comme annulé par Pesapal fait passer la commande payée à Refunded.

Bloc de paiement Pesapal sur la page de commande : identifiant de suivi, référence marchand, mode, statut Pesapal, moyen de paiement, code de confirmation, toutes les tentatives de paiement et les notes. Journal facultatif, sans clés, jetons ni données clients.

Prérequis

PrestaShop 8.0 à 9.x, PHP 8.0 ou ultérieur. Un compte marchand Pesapal avec la clé et le secret consommateur (sandbox et/ou production). Votre boutique doit être accessible depuis Internet pour recevoir les notifications de paiement. Devise du panier : KES, UGX, TZS, ZMW, RWF ou USD. Une clé de licence VibeFox obtenue sur vibefox.net (une clé par domaine).