VibeFox Kushki for OpenCart

Présentation

VibeFox Kushki Payment ajoute à OpenCart 3 et OpenCart 4 les paiements par carte via Kushki pour les boutiques d'Équateur et de Colombie. À l'étape Confirm Order, le client saisit sa carte dans le formulaire de carte hébergé par Kushki, affiché dans votre page de paiement mais servi par Kushki. Le formulaire renvoie un jeton à usage unique, et votre boutique débite ce jeton côté serveur via l'API Kushki. Les numéros de carte n'atteignent jamais votre site. OpenCart crée la commande avant le paiement, mais la commande ne reçoit un statut qu'après l'approbation du débit par Kushki ; les paiements refusés ou abandonnés restent donc des commandes sans statut (missing orders).

Elle convient aux boutiques qui encaissent en USD ou en COP et souhaitent un formulaire de carte sur leur propre page de paiement sans manipuler de données de carte. L'extension ne gère que les paiements en une seule étape. Elle ne propose ni remboursements partiels, ni cartes enregistrées, ni abonnements, ni paiements en espèces ou par virement bancaire (PSE), ni paiements par carte de débit avec redirection, ni autorisation et capture séparées.

Principales fonctionnalités

Formulaire de carte hébergé par Kushki : le formulaire de carte de Kushki à l'étape Confirm Order du paiement OpenCart. Le paiement est envoyé dès que le client appuie sur le bouton de paiement du formulaire. Les paiements en plusieurs fois (diferido) choisis dans le formulaire sont transmis au débit.

Payée seulement après confirmation de Kushki : le statut de la commande n'est défini qu'après l'approbation du débit par Kushki, avec un numéro de ticket. Si Kushki signale un montant ou une devise différents, la commande passe dans un statut de vérification avec une note. OpenCart envoie ensuite ses e-mails habituels de commande.

Taxes en IVA : le montant et la devise proviennent de la commande. La taxe de la commande est transmise à Kushki comme IVA, les lignes non taxées séparément.

Webhooks signés : les webhooks facultatifs confirment un paiement dont la réponse de l'API a été perdue et ajoutent des notes pour les annulations (voids) et les remboursements effectués dans la Kushki Console. Les notifications sans signature valide sont rejetées.

Aucun double débit : un verrou par panier empêche les doubles débits lors d'un double clic ou d'un second onglet, et un panier déjà payé n'est jamais débité à nouveau. Les webhooks répétés n'appliquent jamais deux fois un paiement.

Modes test et production : identifiants marchands (Merchant ID) et signatures de webhook distincts pour chaque mode. Les remboursements sont toujours effectués dans le mode où le paiement a été réalisé.

Remboursements complets depuis la page de commande : l'onglet VibeFox Kushki Payment de la commande rembourse la totalité du montant débité par Kushki et affiche le numéro de ticket, la référence, l'historique des remboursements et les notes Kushki.

Vos propres statuts de commande et conditions OpenCart : choisissez le statut OpenCart pour une commande payée, un paiement en cours de vérification, un paiement échoué, une commande annulée et une commande remboursée. Zone géographique, montant minimum de la commande et ordre d'affichage. Journal sans identifiants marchands, jetons de carte ni adresses e-mail des clients.

Prérequis

OpenCart 3.0.x (testé avec la version 3.0.5.0) ou OpenCart 4.0.2 et ultérieur (testé avec la version 4.1.0.3), PHP 8.0 ou ultérieur. Un seul téléchargement contient les paquets des deux versions. Une devise de commande en USD ou en COP. Un compte Kushki avec les identifiants marchands publics et privés (Public et Private Merchant ID) de test et de production, et HTTPS pour les paiements réels. Une clé de licence VibeFox obtenue sur vibefox.net (une clé par domaine).