VibeFox IntaSend for OpenCart

Présentation

VibeFox IntaSend Pay Gateway ajoute les paiements IntaSend à OpenCart 3 et OpenCart 4 pour les boutiques du Kenya et d'Afrique de l'Est. À la dernière étape du paiement, le client clique sur Confirm Order, est dirigé vers la page de paiement hébergée d'IntaSend, paie par M-Pesa, par carte ou par une autre méthode activée sur votre compte IntaSend, puis revient dans votre boutique. OpenCart crée la commande avant le paiement, mais la commande n'obtient un statut qu'après la confirmation du paiement par IntaSend ; les tentatives non payées restent donc des commandes manquantes.

Elle convient aux boutiques qui souhaitent accepter M-Pesa et les cartes avec un compte IntaSend, sans formulaire de paiement sur leur propre site. L'extension ne gère que les paiements uniques. Les remboursements ne sont pas envoyés à IntaSend depuis la boutique, et l'extension ne propose ni cartes enregistrées, ni abonnements, ni formulaire de paiement intégré (popup).

Principales fonctionnalités

Paiement hébergé IntaSend : un paiement pour le total de la commande dans la devise de la commande. Devises prises en charge : KES, USD, EUR, GBP, UGX, TZS, NGN, GHS, XAF et XOF. UGX, XAF et XOF sont envoyées sans décimales.

Payée seulement après confirmation d'IntaSend : le statut de la commande n'est défini qu'après que votre serveur a interrogé l'API de statut de paiement d'IntaSend avec votre clé secrète. Rien de ce qui est envoyé par le navigateur ou dans le corps du webhook n'est considéré comme fiable. OpenCart envoie ensuite ses e-mails de commande habituels.

Webhook avec challenge : les paiements sont confirmés même si le client ferme le navigateur ou si M-Pesa confirme plus tard. Les webhooks avec un mauvais challenge sont rejetés.

Contrôle du montant et de la devise : le montant et la devise communiqués par IntaSend sont comparés à la commande. Une différence ou un paiement partiel place la commande dans un statut de vérification avec une note.

Aucun traitement en double : un paiement n'est appliqué qu'une fois, même si le retour du client et le webhook arrivent en même temps. Un panier n'est payé qu'une fois, et un second paiement est signalé par une note.

Modes bac à sable (sandbox) et production : des paires de clés distinctes pour chaque mode. La méthode de paiement est masquée tant que les clés du mode actuel sont absentes ou appartiennent à l'autre mode. Les anciens paiements sont toujours vérifiés dans le mode où ils ont été effectués.

Messages clairs : un message après un paiement échoué ou abandonné, et une page « en cours de confirmation » avec un bouton Check again tant que M-Pesa confirme encore.

Conditions OpenCart et onglet de commande : zone géographique, montant minimum de commande, ordre de tri et vos propres statuts de commande. La page de commande comporte un onglet avec les tentatives de paiement et les factures IntaSend. Le journal ne contient ni clés ni données clients.

Prérequis

OpenCart 3.0.x (testé sur 3.0.5.0) ou OpenCart 4.0.2 et ultérieur (testé sur 4.1.0.3), PHP 8.0 ou ultérieur avec cURL. Un seul téléchargement contient les paquets des deux versions. Un compte IntaSend avec des clés API publique et secrète, et un webhook avec une phrase de challenge. HTTPS pour les paiements réels. Une clé de licence VibeFox obtenue sur vibefox.net (une clé par domaine).