VibeFox Helcim for PrestaShop

Présentation

VibeFox Helcim Gateway ajoute à PrestaShop les paiements par carte de crédit via l'API Helcim Payment. Le client saisit sa carte à l'étape de paiement de votre page de paiement, votre serveur l'envoie à Helcim, et la commande est créée à partir de la réponse de Helcim dans la même requête. Visa, Mastercard, American Express, Discover et UnionPay sont acceptées, en CAD ou USD.

Elle convient aux marchands du Canada et des États-Unis disposant d'un compte Helcim qui souhaitent intégrer un formulaire de carte directement sur leur page de paiement. Les coordonnées de carte transitent par votre serveur web, votre boutique a donc besoin du HTTPS et d'un hébergement conforme à la norme PCI DSS (SAQ D). Le module ne prend en charge ni les cartes enregistrées, ni les abonnements, ni les paiements bancaires ou ACH, ni Apple Pay, Google Pay ou 3-D Secure, et ne gère aucun webhook Helcim : les captures, remboursements et annulations effectués dans le tableau de bord Helcim ne sont pas répercutés dans PrestaShop.

Principales fonctionnalités

Formulaire de carte sur votre page de paiement : numéro de carte, date d'expiration, CVC et nom du titulaire, vérifiés avant l'envoi (somme de contrôle du numéro de carte, date d'expiration non échue, longueur du CVC).

Achat ou préautorisation : débitez la carte immédiatement, ou retenez seulement les fonds et capturez-les plus tard avec Capture payment dans le bloc Helcim de la commande.

Commande créée uniquement après approbation : la commande n'est créée qu'après l'approbation de la transaction par Helcim. Une carte refusée ne laisse aucune commande. Si le montant ou la devise approuvés ne correspondent pas au panier, la commande passe en Helcim payment on hold avec une note.

Un seul débit par panier : les soumissions parallèles sont verrouillées, un panier déjà payé n'est jamais débité à nouveau, et chaque tentative utilise une clé d'idempotence. Ainsi, une nouvelle tentative après un dépassement de délai renvoie le résultat Helcim d'origine au lieu de débiter la carte deux fois.

Remboursements depuis la page de commande : remboursements totaux et partiels dans le bloc Helcim de la commande, dans la limite du montant réellement débité par Helcim. Le remboursement complet d'une préautorisation non capturée libère la retenue.

Jetons de production et de test : jetons d'API distincts pour vos comptes Helcim de production et de test. Les captures et les remboursements utilisent toujours le compte avec lequel la commande a été payée.

Bloc Helcim sur la page de commande : identifiant de transaction, type de carte et 4 derniers chiffres, montant approuvé, historique des remboursements et notes du module. Journal d'erreurs sans numéros de carte, CVC, jetons ni données personnelles.

Prérequis

PrestaShop 8.0 à 9.x, PHP 8.0 ou ultérieur. Un compte marchand Helcim (Canada ou États-Unis) et un jeton d'API. HTTPS sur votre boutique et hébergement conforme à PCI DSS. Une clé de licence VibeFox obtenue sur vibefox.net (une clé par domaine).