VibeFox Paystack for OpenCart

Présentation

VibeFox Paystack Payment ajoute les paiements Paystack à OpenCart 3 et OpenCart 4. À la dernière étape de la commande, le client clique sur Confirm Order, est redirigé vers la page de paiement sécurisée hébergée par Paystack et paie avec n'importe quel canal activé sur votre compte Paystack, comme les cartes, le virement bancaire, USSD ou l'argent mobile. Les données de carte ne transitent jamais par votre site. OpenCart crée la commande avant le paiement, mais la commande ne reçoit un statut qu'une fois Paystack le paiement confirmé ; les tentatives non payées restent donc des commandes sans statut.

Elle convient aux boutiques qui vendent en NGN, USD, GHS, ZAR, KES, XOF, EGP ou RWF et disposent d'un compte Paystack. Seules les clés secrètes sont nécessaires. L'extension ne propose ni formulaire de paiement intégré ou en fenêtre contextuelle (redirection uniquement), ni cartes enregistrées, ni abonnements, ni paiements fractionnés ou sous-comptes, ni choix des canaux de paiement.

Principales fonctionnalités

Payée uniquement après confirmation de Paystack : ni le retour du client ni le contenu du webhook ne sont considérés comme fiables. L'extension lit la transaction côté serveur via l'API Paystack et vérifie sa référence, son statut, son montant et sa devise par rapport à la commande. OpenCart envoie ensuite ses e-mails de commande habituels.

Webhooks signés : Paystack signe chaque webhook avec votre clé secrète, il n'y a donc aucune clé supplémentaire à configurer. Les virements bancaires et les paiements USSD finalisés plus tard sont confirmés par le webhook.

Contrôle du montant et de la devise : un écart place la commande dans un statut de vérification avec une note. Les frais Paystack répercutés sur le client sont pris en charge.

Un panier, un paiement : le retour du client et le webhook peuvent arriver au même moment sans appliquer deux fois un paiement. Une nouvelle tentative pour un panier déjà payé mène directement à la page de succès, et un paiement en double est signalé pour remboursement.

Modes test et réel : clés secrètes distinctes. La page des réglages signale une clé manquante, une clé de test en mode réel, une clé réelle en mode test ou une clé publique saisie dans un champ de clé secrète, et le mode de paiement reste masqué tant que le problème n'est pas corrigé.

Remboursements depuis la page de la commande : remboursements totaux et partiels dans l'onglet VibeFox Paystack Payment de la commande, dans le mode (test ou réel) utilisé pour le paiement, et pour le montant et la devise effectivement débités par Paystack.

Vos propres statuts de commande : choisissez le statut OpenCart d'une commande payée, d'une commande finalisée automatiquement, d'un paiement encore en cours de traitement, d'un paiement en vérification, d'un paiement échoué et d'un remboursement total.

Conditions OpenCart : zone géographique, montant minimum de la commande et ordre de tri. Journal sans clés ni données clients.

Prérequis

OpenCart 3.0.x (testé avec la version 3.0.5.0) ou 4.0.2 et ultérieures (testé avec la version 4.1.0.3), PHP 8.0 ou ultérieur. Un seul téléchargement contient les paquets pour les deux versions. Un compte Paystack avec des clés secrètes de test et/ou réelles. Devise de la commande : NGN, USD, GHS, ZAR, KES, XOF, EGP ou RWF, selon ce qui est activé sur votre compte Paystack. Une clé de licence VibeFox obtenue sur vibefox.net (une clé par domaine).