VibeFox Adyen for OpenCart

Présentation

VibeFox Adyen Gateway ajoute à OpenCart 3 et OpenCart 4 les paiements via Adyen Payment Links. À la dernière étape de la commande, le client clique sur Confirm Order, est redirigé vers la page de paiement hébergée par Adyen, paie avec n'importe quel moyen activé sur votre compte marchand Adyen (cartes, portefeuilles et moyens de paiement locaux) et revient sur votre boutique. Les données de carte ne transitent jamais par votre site. OpenCart crée la commande avant le paiement, mais la commande n'obtient un statut qu'après qu'Adyen a confirmé le paiement par un webhook signé ; les tentatives non payées restent donc des commandes manquantes.

Elle convient aux boutiques disposant d'un compte marchand Adyen qui souhaitent utiliser les moyens de paiement de ce compte sans créer de formulaire de paiement sur leur propre site. L'extension ne gère ni abonnements ni paiements récurrents, ni cartes enregistrées, ni champs de carte sur le site (Drop-in ou Components), ni boutons de capture ou d'annulation dans OpenCart. La capture suit les paramètres de votre compte Adyen.

Principales fonctionnalités

Adyen Payment Links : un lien de paiement est créé pour le total de la commande dans la devise de la commande, avec les unités mineures attendues par Adyen pour chaque devise (sans décimale, comme JPY, KRW, IDR ; à trois décimales, comme KWD, BHD).

Payée seulement après confirmation d'Adyen : le statut de la commande n'est fixé que par un webhook AUTHORISATION signé par HMAC. Revenir sur la boutique ne paie jamais une commande. OpenCart envoie ensuite ses e-mails de commande habituels.

Contrôle du montant et de la devise : le montant et la devise confirmés par Adyen sont comparés à la commande. En cas d'écart, la commande passe dans un statut de vérification avec une note.

Aucun double traitement : les livraisons répétées ou parallèles de webhooks n'enregistrent jamais un paiement deux fois. Une nouvelle tentative de paiement fait expirer les liens de paiement précédents de la commande et du panier, et un second paiement réussi pour une commande déjà payée ajoute une note d'avertissement.

Modes test et production : clés API et clés HMAC distinctes pour chaque environnement. Une notification de test ne confirme jamais un paiement réel, et les remboursements sont toujours envoyés à l'environnement et au compte marchand du paiement.

Remboursements depuis la page de commande : remboursements totaux et partiels dans l'onglet VibeFox Adyen Gateway de la commande, dans le montant et la devise autorisés par Adyen. Adyen confirme le résultat par webhook. Un remboursement total place la commande au statut Refunded.

Vos propres statuts de commande : choisissez le statut OpenCart d'une commande payée, d'un paiement en vérification, d'un paiement annulé et d'un remboursement total.

Conditions OpenCart et journal : zone géographique, montant minimum de commande et ordre d'affichage. Journal sans clés API ni données personnelles des acheteurs.

Prérequis

OpenCart 3.0.x (testé sur 3.0.5.0) ou OpenCart 4.0.2 et versions ultérieures (testé sur 4.1.0.3), PHP 8.0 ou ultérieur. Un même téléchargement contient les paquets pour les deux versions. Un compte marchand Adyen avec des clés API, un webhook Standard avec une clé HMAC et, pour les paiements réels, le préfixe d'URL de production. Une clé de licence VibeFox obtenue sur vibefox.net (une clé par domaine).