VibeFox Helcim for OpenCart

Présentation

VibeFox Helcim Gateway ajoute à OpenCart 3 et OpenCart 4 les paiements par carte de crédit via l'API de paiement Helcim. À la dernière étape de la commande, le client saisit sa carte dans un formulaire situé au-dessus du bouton Confirm Order, votre serveur l'envoie à Helcim, et la commande reçoit son statut d'après la réponse de Helcim dans la même requête. Visa, Mastercard, American Express, Discover et UnionPay sont acceptées, en CAD ou en USD.

Elle convient aux marchands du Canada et des États-Unis disposant d'un compte Helcim qui souhaitent afficher un formulaire de carte directement sur leur page de paiement. Les données de carte transitent par votre serveur web : votre boutique doit donc utiliser HTTPS et un hébergement conforme à la norme PCI DSS (SAQ D). L'extension ne gère ni cartes enregistrées, ni abonnements, ni paiements par ACH ou virement bancaire, ni Apple Pay, Google Pay ou 3-D Secure, ni webhooks Helcim : les captures, remboursements et annulations effectués dans le tableau de bord Helcim ne sont pas reflétés dans OpenCart.

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 dépassée, longueur du CVC).

Achat ou pré-autorisation : débiter la carte immédiatement, ou seulement bloquer les fonds et les capturer plus tard avec Capture payment dans l'onglet de la commande.

Statut seulement après approbation : OpenCart crée la commande avant le paiement, mais elle ne reçoit un statut qu'une fois Helcim la transaction approuvée. Une carte refusée ne laisse donc qu'une commande manquante. Si le montant ou la devise approuvés ne correspondent pas à la commande, celle-ci passe dans votre statut de vérification, avec une note.

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

Remboursements depuis la page de commande : remboursements totaux et partiels dans l'onglet VibeFox Helcim Gateway de la commande, dans la limite du montant réellement débité par Helcim. Une pré-autorisation non capturée est libérée en totalité.

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

Vos propres statuts de commande : choisissez le statut OpenCart pour une commande payée, une pré-autorisation, une commande en vérification, une pré-autorisation libérée et un remboursement total. Zone géographique, montant minimum et ordre de tri comme pour tout mode de paiement OpenCart. Journal d'erreurs sans numéros de carte, CVC, jetons ni données personnelles.

Prérequis

OpenCart 3.0.x (testé avec 3.0.5.0) ou OpenCart 4.0.2 et ultérieur (testé avec 4.1.0.3), PHP 8.0 ou ultérieur. Le téléchargement contient les paquets pour les deux versions. Un compte marchand Helcim (Canada ou États-Unis) et un jeton API. Devise de la commande CAD ou USD. HTTPS sur votre boutique et hébergement conforme à la norme PCI DSS. Une clé de licence VibeFox obtenue sur vibefox.net (une clé par domaine).