VibeFox HyperPay for PrestaShop

Présentation

VibeFox HyperPay Payment Gateway ajoute à PrestaShop les paiements par carte via le widget COPYandPAY de HyperPay. Après avoir confirmé la commande dans le tunnel de commande, le client voit le widget de paiement HyperPay sur une page de paiement de votre boutique et y règle avec VISA, Mastercard, mada, American Express, STC Pay ou Apple Pay. Les données de carte ne sont saisies que dans le widget HyperPay et n'atteignent jamais votre serveur. La commande n'est créée qu'après confirmation du paiement par HyperPay : les paiements abandonnés ou refusés ne laissent donc aucune commande impayée.

Elle convient aux boutiques d'Arabie saoudite, des Émirats arabes unis, de Jordanie, de Bahreïn, d'Oman, du Qatar, d'Égypte et des autres marchés MENA disposant d'un compte marchand HyperPay. Le module ne gère ni remboursements ni annulations depuis PrestaShop (effectuez-les dans le tableau de bord HyperPay), ni cartes enregistrées, ni abonnements, ni vérification de domaine Apple Pay, ni entité distincte par marque, ni solutions de paiement en plusieurs fois (buy-now-pay-later).

Principales fonctionnalités

Widget HyperPay : le widget COPYandPAY sur la page de paiement, chargé avec Subresource Integrity, dans la langue du client lorsque HyperPay la prend en charge. Vous choisissez les marques qu'il affiche.

Payée seulement après confirmation de HyperPay : par une requête de statut serveur à serveur lorsque le client revient, et par des webhooks chiffrés (AES-256-GCM) lorsque le navigateur est fermé. L'URL de retour seule ne crée jamais une commande payée.

Contrôlée par rapport au panier : le paiement doit appartenir à l'une des sessions de paiement créées pour ce panier, et le montant et la devise doivent correspondre. En cas d'écart, la commande passe en HyperPay payment on hold avec une note.

Aucun traitement en double : chaque résultat n'est appliqué qu'une fois. Les webhooks répétés ou les rechargements de page ne créent jamais une seconde commande. Les paiements en double, les paiements reçus après une annulation et les extournes sont consignés sur la commande.

Débit ou préautorisation : débit immédiat, ou réservation du montant à capturer plus tard avec Capture payment dans le bloc HyperPay de la commande.

Test et production : Access Token, Entity ID et clé de webhook distincts pour chaque mode. Les vérifications de statut, les captures et les webhooks utilisent toujours le mode dans lequel la session de paiement a été créée.

Messages clairs : les paiements refusés, non finalisés ou non encore confirmés sont expliqués au client dans le tunnel de commande, et le panier est conservé pour un nouvel essai.

Bloc HyperPay sur la page de commande : identifiant de paiement, session de paiement, montant, résultat et bouton de capture. Journal sans données de carte, clés ni données clients.

Prérequis

PrestaShop 8.0 à 9.x, PHP 8.0 ou ultérieur avec l'extension OpenSSL. Un compte marchand HyperPay avec Access Token et Entity ID (test et production), et un webhook de paiement avec sa clé de déchiffrement. Une clé de licence VibeFox obtenue sur vibefox.net (une clé par domaine).