VibeFox Pesapal for OpenCart

Présentation

VibeFox Pesapal Pay Gateway ajoute les paiements Pesapal à OpenCart 3 et OpenCart 4. Elle se connecte à l'API Pesapal 3.0. À la dernière étape du paiement, le client clique sur Confirm Order, est redirigé vers la page de paiement Pesapal et paie avec M-Pesa, Airtel Money, MTN, carte, virement bancaire ou une autre méthode proposée par Pesapal dans le pays du client. Les données de carte ne transitent jamais par votre site. OpenCart crée la commande avant le paiement, mais la commande n'obtient un statut qu'après la confirmation du paiement par Pesapal ; les tentatives non payées restent donc des commandes manquantes.

Elle convient aux boutiques du Kenya, de l'Ouganda, de la Tanzanie, du Rwanda, de la 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 consumer key et le consumer secret sont nécessaires. L'extension ne propose pas de remboursements depuis la page de commande (effectuez-les dans le tableau de bord Pesapal), ni de cartes enregistrées, ni d'abonnements ou de paiements récurrents, ni de formulaire de paiement sur votre propre site, ni de conversion de devises.

Principales fonctionnalités

Payée seulement après confirmation de Pesapal : les notifications de Pesapal et le retour du client ne contiennent aucune donnée de paiement ; l'extension ne s'y fie donc jamais. À chaque fois, elle demande à Pesapal le statut de la transaction par une requête serveur à serveur authentifiée. OpenCart envoie ensuite ses e-mails de commande habituels.

Contrôle du montant et de la devise : la commande n'est marquée payée que si Pesapal indique Completed et si le montant et la devise payés correspondent à la commande. En cas d'écart, la commande passe dans un statut de vérification avec une note.

Configuration automatique de l'IPN : l'URL de notification est enregistrée auprès de Pesapal au premier paiement, séparément pour le sandbox et le mode réel. Rien n'est à configurer dans le tableau de bord Pesapal.

Aucun double traitement : les notifications répétées et une notification arrivant en même temps que le retour du client n'appliquent jamais un paiement deux fois. Les commandes annulées et remboursées ne sont jamais rouvertes, et un second paiement pour une commande ou un panier déjà payé est signalé pour remboursement.

Chaque tentative est mémorisée : un paiement effectué sur une page Pesapal plus ancienne du même panier, par exemple dans un second onglet du navigateur, est toujours reconnu, et une nouvelle tentative vérifie d'abord les précédentes.

Modes sandbox et réel : clés distinctes pour chaque mode. Un paiement est toujours vérifié dans le mode où il a été lancé.

Vos propres statuts de commande : choisissez le statut OpenCart pour une commande payée, un paiement en vérification, une commande annulée et un paiement annulé. Un paiement que Pesapal signale comme annulé fait passer la commande payée au statut Refunded.

Onglet Pesapal sur la page de commande : identifiant de suivi, référence marchand, mode, statut Pesapal, méthode de paiement, code de confirmation, toutes les tentatives de paiement et les notes. Zone géographique, total minimum et ordre de tri d'OpenCart. Journal facultatif sans clés, jetons ni données clients.

Prérequis

OpenCart 3.0.x (testé sur 3.0.5.0) ou 4.0.2 et ultérieures (testé sur 4.1.0.3), PHP 8.0 ou ultérieur. Un seul téléchargement contient les paquets pour les deux versions. Un compte marchand Pesapal avec la consumer key et le consumer secret (sandbox et/ou mode réel). Votre boutique doit être accessible depuis Internet pour recevoir les notifications de paiement. Devise de la commande : KES, UGX, TZS, ZMW, RWF ou USD. Une clé de licence VibeFox obtenue sur vibefox.net (une clé par domaine).