VibeFox Kushki for PrestaShop

Présentation

VibeFox Kushki Payment ajoute à PrestaShop les paiements par carte via Kushki pour les boutiques d'Équateur et de Colombie. À l'étape de paiement, le client saisit sa carte dans le formulaire hébergé par Kushki, affiché dans votre page de paiement mais servi par Kushki. Le formulaire renvoie un jeton à usage unique, que votre boutique débite côté serveur via l'API Kushki. Les numéros de carte n'atteignent jamais votre site. La commande n'est créée qu'après l'approbation du débit par Kushki : les paiements refusés ou abandonnés ne laissent donc aucune commande impayée.

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. Le module ne gère que les paiements par carte en une étape. Il ne prend en charge ni remboursements partiels, ni cartes enregistrées, ni abonnements, ni paiements en espèces, ni virements bancaires (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 de paiement de la commande PrestaShop. Les paiements en plusieurs fois (diferido) choisis dans le formulaire sont transmis au débit.

Payée seulement après confirmation de Kushki : la commande n'est créée qu'après que Kushki a approuvé le débit avec un numéro de ticket. Un montant ou une devise différents signalés par Kushki placent la commande dans Kushki payment on hold avec une note.

Taxe transmise comme IVA : le montant et la devise proviennent toujours du panier. La taxe du panier est transmise à Kushki sous le nom IVA, les lignes non taxées séparément.

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

Aucun débit en double : un verrou par panier empêche les doubles débits lors d'un double clic ou d'un second onglet, et les webhooks répétés ne créent jamais une seconde commande.

Modes test et réel : identifiants marchands et signatures de webhook distincts pour chaque mode. Les remboursements vont toujours vers le mode dans lequel le paiement a été effectué.

Remboursements complets depuis la page de commande : le bloc Kushki payment de la commande rembourse le montant total débité par Kushki. La commande passe à Refunded.

Bloc Kushki sur la page de commande : numéro de ticket, référence, environnement, historique des remboursements et notes Kushki de la commande. Le journal ne contient ni identifiants marchands, ni jetons de carte, ni adresses e-mail des clients.

Prérequis

PrestaShop 8.0 à 9.x, PHP 8.0 ou ultérieur. Une devise de panier USD ou COP. Un compte Kushki avec les identifiants marchands publics et privés 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).