VibeFox HyperPay for OpenCart

Présentation

VibeFox HyperPay Payment Gateway ajoute les paiements par carte via le widget COPYandPAY de HyperPay à OpenCart 3 et OpenCart 4. Lorsque le client clique sur Confirm Order, une page de paiement de votre boutique affiche le widget HyperPay, et le client paie là 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 ne transitent jamais par votre serveur. OpenCart crée la commande avant le paiement, mais la commande ne reçoit un statut qu'après la confirmation du paiement par HyperPay ; les paiements abandonnés ou refusés restent donc des commandes manquantes.

Elle convient aux boutiques d'Arabie saoudite, des Émirats arabes unis, de Jordanie, de Bahreïn, d'Oman, du Qatar, d'Égypte et d'autres marchés MENA disposant d'un compte marchand HyperPay. L'extension ne propose pas de remboursements ni d'annulations depuis OpenCart (à effectuer dans le tableau de bord HyperPay), ni de cartes enregistrées, ni d'abonnements, ni de vérification de domaine Apple Pay, ni d'entité distincte par marque, ni de solutions de paiement différé.

Fonctionnalités principales

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 affichées.

Payée uniquement 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 marque jamais une commande comme payée. OpenCart envoie ensuite ses e-mails habituels de commande.

Vérifiée par rapport à la commande : le paiement doit appartenir à l'un des checkouts de la commande, et le montant et la devise doivent correspondre. En cas d'écart, la commande passe dans un statut de vérification avec une note.

Aucun double traitement : chaque résultat n'est appliqué qu'une fois. Les webhooks répétés ou les rechargements de page n'appliquent jamais un paiement deux fois, et un panier déjà payé avec une autre commande n'est pas débité à nouveau. Les paiements en double, les paiements effectués après annulation et les annulations de paiement sont notés sur la commande.

Débit immédiat ou pré-autorisation : débit immédiat, ou réservation du montant à capturer plus tard avec Capture payment dans l'onglet de la page de 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 le checkout a été créé.

Vos propres statuts de commande : choisissez le statut OpenCart pour un paiement payé, autorisé, en attente de confirmation, suspendu, annulé et remboursé.

Conditions OpenCart : zone géographique, montant minimum de commande et ordre de tri. Journal sans données de carte, clés ni données clients.

Prérequis

OpenCart 3.0.x (testé sur 3.0.5.0) ou OpenCart 4.0.2 et ultérieur (testé sur 4.1.0.3), PHP 8.0 ou ultérieur avec l'extension OpenSSL. Un téléchargement contient les paquets pour les deux versions. 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).