VibeFox Adyen for OpenCart — Aide

Prérequis

OpenCart : 3.0.x (testé avec la version 3.0.5.0) ou 4.0.2 et versions ultérieures (testé avec la version 4.1.0.3).

PHP : 8.0 ou ultérieur.

Compte Adyen : vous avez besoin du nom de votre compte marchand Adyen, d'une clé API et d'une clé HMAC pour chaque environnement que vous utilisez (test et production), et, pour les paiements réels, du préfixe d'URL de production. La clé API appartient à un identifiant API disposant des rôles Checkout webservice et Merchant PAL webservice. La clé HMAC est générée pour le webhook Standard (voir Configuration). L'espace client de test est ca-test.adyen.com, celui de production ca-live.adyen.com. Les clés de test et de production sont distinctes. Aucune clé client n'est nécessaire, car la page de paiement est hébergée par Adyen.

Clé de licence VibeFox : achetée sur vibefox.net. Une clé fonctionne sur un seul domaine.

Installation

Le téléchargement est un unique fichier zip contenant les paquets pour les deux versions d'OpenCart. Décompressez-le sur votre ordinateur. Il contient README.txt, le paquet OpenCart 3 wcp_adyen_gateway-oc3-(version).ocmod.zip et le paquet OpenCart 4 wcp_adyen_gateway.ocmod.zip. Installez uniquement le paquet correspondant à votre version d'OpenCart. La clé de licence est la même pour les deux versions.

OpenCart 3

1. Dans l'administration, allez dans Extensions > Installer, cliquez sur Upload et sélectionnez le fichier wcp_adyen_gateway-oc3-(version).ocmod.zip. L'extension ne comporte aucune modification OCMOD, donc Extensions > Modifications n'a pas besoin d'être actualisé. Au lieu de l'installateur, vous pouvez aussi copier le contenu du dossier upload de l'archive dans le dossier racine de votre boutique.

2. Allez dans Extensions > Extensions et choisissez le type Payments. Repérez VibeFox Adyen Gateway et cliquez sur Install (le bouton vert +). Votre utilisateur administrateur doit avoir le droit de modifier la liste des extensions de paiement.

3. Cliquez sur Edit (le bouton en forme de crayon) pour ouvrir la page des réglages. Collez votre clé de licence VibeFox dans License key, dans le bloc de licence en haut de la page, puis cliquez sur Activate (voir Clé de licence).

4. Saisissez votre compte marchand, la clé API de test et la clé HMAC de test, puis, plus tard, la clé API de production, la clé HMAC de production et le préfixe d'URL de production.

5. Dans l'espace client Adyen (test et production), ajoutez un webhook Standard avec l'URL affichée dans la section Webhook des réglages (voir Configuration).

6. Activez Enable/Disable, puis cliquez sur Save. Testez un paiement avec Test mode activé, puis désactivez-le.

OpenCart 4

1. Dans l'administration, allez dans Extensions > Installer, cliquez sur Upload et sélectionnez le fichier wcp_adyen_gateway.ocmod.zip. Ne renommez pas le fichier : OpenCart 4 tire le code de l'extension du nom du fichier, et un paquet renommé ne fonctionne pas.

2. Le paquet apparaît dans la liste des extensions installées, sur la même page. Cliquez sur Install (le bouton vert +) à côté.

3. Allez dans Extensions > Extensions et choisissez le type d'extension Payments. Repérez VibeFox Adyen Gateway, cliquez sur Install (le bouton vert +), puis sur Edit (le bouton en forme de crayon).

4. Saisissez la clé de licence et les réglages comme aux étapes 3 à 6 pour OpenCart 3. La page des réglages et ses champs sont identiques dans les deux versions. Seule l'URL du webhook diffère (voir Webhook).

Une nouvelle installation démarre avec le mode de paiement désactivé et le mode test activé.

Configuration

Tous les réglages se trouvent sur la page de l'extension : Extensions > Extensions > Payments > VibeFox Adyen Gateway > Edit. Les sections sont listées à gauche ; le bouton Save situé sous la liste enregistre la page entière. Tant que les réglages du mode actuel sont incomplets, la page affiche Adyen is hidden at checkout until the test settings are complete (ou les réglages de production) et indique ce qui manque : Merchant account, la clé API, la clé HMAC et, en mode production, Live URL prefix. Tant que le mode test est activé, la page affiche Test mode is on: payment links and refunds go to the Adyen test environment, no real money. Sans le droit de modifier l'extension, la page affiche les réglages mais ne peut pas les enregistrer.

Lorsque vous enregistrez, Title doit comporter de 1 à 128 caractères, Sort Order doit être un nombre entier et Total un nombre égal ou supérieur à 0 ; la zone géographique et les statuts de commande doivent exister. Sinon, rien n'est enregistré et la page indique le champ concerné. Une clé HMAC qui n'est pas hexadécimale, ou un préfixe d'URL de production comportant d'autres caractères que des lettres, des chiffres et des tirets, ne sont pas enregistrés : un avertissement indique le champ, la valeur précédente est conservée et les autres réglages sont enregistrés.

Adyen

Enable/Disable : Enable Adyen payment gateway active ou désactive le mode de paiement. Par défaut : désactivé.

Title : le nom du mode de paiement que voient les clients lors du paiement. C'est aussi le nom du mode de paiement enregistré dans la commande. Par défaut : Adyen. Obligatoire, 128 caractères maximum.

Description : le texte affiché au client à l'étape Confirm Order, au-dessus du bouton de confirmation. Par défaut : Pay securely via Adyen.

Sort Order : la position d'Adyen parmi les modes de paiement lors du paiement. Laissez le champ vide ou saisissez un nombre entier.

Geo Zone : proposer Adyen uniquement pour les adresses de paiement situées dans la zone géographique sélectionnée. Par défaut : All zones. Les zones géographiques se configurent dans System > Localisation > Geo Zones.

Total : le montant total du paiement, dans la devise par défaut de la boutique, qu'une commande doit atteindre pour que Adyen soit proposé. Laissez le champ vide pour proposer Adyen quel que soit le montant.

Compte Adyen

Les clés API se créent dans l'espace client Adyen, sous Developers > API credentials (la section renvoie vers l'espace client de test et celui de production). Renseignez les deux jeux de clés ; l'interrupteur Test mode détermine celui qui est utilisé.

Test mode : utilise l'environnement de test d'Adyen (aucun argent réel). Lorsqu'il est activé, les liens de paiement et les remboursements sont envoyés à checkout-test.adyen.com avec la clé API de test. Par défaut : activé. Désactivez-le pour encaisser de vrais paiements. Tant qu'il est activé, les clients voient Test mode: no real payment is taken. à l'étape Confirm Order.

Merchant account : le nom de votre compte marchand Adyen (et non le compte de l'entreprise), par exemple MyShopECOM. Il est généralement identique dans l'espace client de test et celui de production.

Identifiants de test

Utilisés tant que Test mode est activé.

Test API key : depuis l'espace client de test : Developers > API credentials > votre identifiant > API key.

Test HMAC key : depuis l'espace client de test : Developers > Webhooks > votre webhook Standard > HMAC key (hexadécimale). Obligatoire : les webhooks sans signature valide sont rejetés.

Identifiants de production

Utilisés lorsque Test mode est désactivé.

Live API key : depuis l'espace client de production : Developers > API credentials > votre identifiant > API key.

Live HMAC key : depuis l'espace client de production : Developers > Webhooks > votre webhook Standard > HMAC key (hexadécimale).

Live URL prefix : depuis l'espace client de production : Developers > API URLs, par exemple 1797a841fbb37ca7-AdyenDemo à partir de https://1797a841fbb37ca7-AdyenDemo-checkout-live.adyenpayments.com. Vous pouvez coller l'URL complète ; le préfixe en est extrait à l'enregistrement.

Les clés API et les clés HMAC enregistrées ne sont plus jamais affichées. Le champ reste vide et affiche Saved — leave empty to keep it. Saisissez une nouvelle valeur uniquement si vous voulez la modifier. Pour supprimer une clé enregistrée, cochez Clear the saved value on save sous le champ, puis cliquez sur Save.

Webhook

Les commandes ne sont marquées comme payées que par les webhooks d'Adyen. Dans l'espace client (test et production), allez dans Developers > Webhooks et ajoutez un Standard webhook avec l'URL affichée dans Webhook URL dans cette section. Sous OpenCart 3, elle ressemble à https://your-store/index.php?route=extension/payment/wcp_adyen_gateway/webhook et, sous OpenCart 4, à https://your-store/index.php?route=extension/wcp_adyen_gateway/payment/wcp_adyen_gateway.webhook. Elle est construite à partir de l'adresse de la vitrine de votre installation OpenCart. Copiez l'URL exactement telle que les réglages l'affichent, car Adyen ne suit pas les redirections. Choisissez la méthode JSON, activez Generate HMAC key et copiez la clé dans Test HMAC key ou Live HMAC key.

L'environnement de chaque notification détermine la clé HMAC utilisée, et une notification ne s'applique qu'à un lien de paiement créé dans le même environnement et avec le même compte marchand. Une notification de test ne confirme jamais un paiement réel. Les webhooks sans signature valide sont rejetés avec le code HTTP 401, et Adyen les renvoie plus tard. Sans le webhook, aucune commande ne reçoit de statut.

L'extension gère ces événements (ils sont également listés dans cette section) :

Les autres événements sont ajoutés aux notes de la commande. Les notifications concernant une commande sans statut, autres qu'AUTHORISATION, sont ignorées. Les notifications qui ne concernent pas une commande de cette boutique, par exemple le bouton de test de l'espace client, sont acceptées et ignorées. Le webhook fonctionne aussi lorsque la boutique est en mode maintenance, car OpenCart laisse passer les requêtes des extensions de paiement. Sur OpenCart 4, l'extension ajoute pour cela une action de démarrage (startup action).

Commandes

OpenCart crée la commande à l'étape Confirm Order sans statut (une commande manquante). Elle ne reçoit un statut que lorsqu'Adyen confirme le paiement par le webhook AUTHORISATION signé et que le montant et la devise correspondent à la commande. Le retour du client ne modifie jamais la commande. Chacun des champs ci-dessous liste vos statuts de commande OpenCart.

Order status after payment : le statut défini par un webhook AUTHORISATION réussi et signé. Par défaut : En cours.

On hold (review) status : un écart de montant ou de devise, une capture échouée d'une commande payée, ou un paiement reçu après que le statut de la commande a été modifié (par exemple annulée). Une note explique la raison. Par défaut : En attente de paiement, car OpenCart ne dispose pas de statut On hold. Vous pouvez créer votre propre statut dans System > Localisation > Order Statuses et le sélectionner ici.

Cancelled status : défini lorsqu'Adyen annule le paiement de la commande (CANCELLATION). Par défaut : Annulée.

Refunded status : défini après le remboursement intégral du paiement depuis la page de la commande. Si Adyen signale ensuite l'échec de ce remboursement, la commande passe au statut d'examen avec une note. Par défaut : Remboursée.

Avancé

Debug log : écrit les appels à l'API et les événements des webhooks dans adyg_debug.log.php, dans le dossier des journaux d'OpenCart (storage/logs). Le fichier ne peut pas être ouvert depuis le web et, à 5 Mo, il est déplacé vers adyg_debug.old.log.php. Les erreurs sont toujours journalisées, même lorsque l'interrupteur est désactivé. Les journaux ne contiennent jamais de clés API ou HMAC, ni de données personnelles des acheteurs. Par défaut : désactivé.

Log : affiche la taille et les dernières entrées du journal. Cliquez sur Clear log pour le vider.

Delete data on uninstall : lorsqu'il est activé, la désinstallation de l'extension supprime les réglages de la passerelle et le journal. Les enregistrements de paiement Adyen (références PSP, événements de webhook, remboursements) sont toujours conservés, de sorte que les anciennes commandes restent remboursables. Par défaut : désactivé.

Import / Export

Export : Download JSON enregistre les réglages dans un fichier JSON. Les clés API et HMAC ne sont pas exportées.

Import : collez un JSON exporté précédemment et cliquez sur Import pour restaurer les réglages. Les clés enregistrées sont conservées.

Paiement

À l'étape Payment Method, le client choisit le mode de paiement (par défaut Adyen). À l'étape Confirm Order, le client voit votre description et la note You will be redirected to Adyen to complete the payment securely. OpenCart crée la commande à cette étape, toujours sans statut. Lorsque le client clique sur Confirm Order, l'extension crée un lien de paiement Adyen pour le total de la commande, dans la devise de la commande, et envoie le client vers la page de paiement d'Adyen. Là, le client paie avec n'importe quel moyen activé dans votre compte Adyen. L'adresse e-mail, le nom et le pays de facturation du client (ou le pays de la boutique), ainsi que la langue de la boutique, sont transmis à Adyen, et le paiement apparaît sous Order # suivi du numéro de commande.

Après le paiement, le client revient dans votre boutique. Ce retour ne règle pas la commande en soi : la commande n'est marquée comme payée que lorsqu'Adyen la confirme par le webhook AUTHORISATION signé et que le montant et la devise correspondent à la commande. La commande reçoit alors son statut de la manière standard d'OpenCart, avec les e-mails habituels de commande et la mise à jour du stock. Si le webhook est déjà arrivé, le client voit la page de confirmation de commande d'OpenCart avec Your payment with Adyen has been received. (ou Your payment with Adyen has been received and is being reviewed by the store. pour une commande en examen). Si Adyen a annulé le paiement auparavant, la page affiche Your Adyen payment was not completed. Please contact us about this order. Si le webhook n'est pas encore arrivé, une page Payment confirmation affiche Your payment is being confirmed by Adyen. Your order will be confirmed as soon as Adyen confirms the payment, and you will receive an e-mail. avec les boutons Check again et Back to checkout, pour un client qui n'a pas terminé le paiement.

Si le paiement est refusé, la commande reste sans statut et le client peut payer à nouveau avec le même lien ou revenir au paiement. Chaque nouvelle tentative (OpenCart 3 crée une nouvelle commande à chaque affichage de l'étape Confirm Order, OpenCart 4 met à jour la commande de la page de paiement) rend caducs les liens de paiement précédents de la commande et du panier, afin qu'ils ne puissent pas être payés non plus. Si la commande a déjà un statut, le client est dirigé vers la page de succès au lieu de lancer un nouveau paiement.

Sur OpenCart 4, le client choisit le mode de paiement avec le bouton Choose du bloc des modes de paiement, dans la fenêtre Payment method options, puis clique sur Confirm Order en bas de la page de paiement. L'adresse de paiement est facultative sur OpenCart 4 : sans elle, le nom du client est transmis comme nom du payeur et le pays de l'adresse de livraison (ou le pays de la boutique) comme pays. OpenCart 4 garde une seule commande pour le paiement et la met à jour : Back to checkout et un nouveau Confirm Order créent un nouveau lien de paiement pour la même commande et font expirer le précédent. Si cette commande a entre-temps été fermée sans paiement (par exemple parce qu'Adyen a annulé le paiement ou que vous avez annulé la commande), le client est renvoyé au paiement avec Your previous order was cancelled without a payment. Please confirm the order again to pay with a new order. au-dessus de la page, et le prochain Confirm Order paie une nouvelle commande. Si la commande de la page de paiement était déjà réglée pour un autre panier, le client est renvoyé au paiement et paie une nouvelle commande. Toute modification du panier, y compris une nouvelle quantité, compte comme un nouveau panier qui nécessite son propre paiement.

Si le lien de paiement ne peut pas être créé, le client reste à l'étape Confirm Order avec Payment could not be initiated. Please try again or choose another payment method. La raison est écrite dans le journal. Si les réglages sont incomplets, le message est Payment gateway is not configured properly. Please contact the store administrator.

L'extension ne propose 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, ni authentification de base pour les webhooks.

Commandes et remboursements

Statuts de commande

No status (missing order) : le client a été redirigé vers Adyen et n'a pas payé, le paiement a été refusé, ou Adyen n'a pas encore confirmé le paiement. Dans Sales > Orders, ces commandes ne s'affichent qu'avec le filtre Order Status réglé sur Missing Orders.

Order status after payment (default Processing) : le paiement a été autorisé. Une note indique le montant, la référence PSP et le mode de paiement.

On hold (review) status (default Pending) : Adyen a confirmé un montant ou une devise différent du total de la commande, une capture a échoué, un remboursement intégral a échoué, ou le paiement est arrivé après que le statut de la commande a été modifié, par exemple annulée. La note l'explique. Vérifiez le paiement dans l'espace client, puis traitez la commande ou remboursez le paiement. Un paiement correct pour une commande en examen après un écart la marque comme payée.

Cancelled status (default Canceled) : le paiement de cette commande a été annulé dans Adyen.

Refunded status (default Refunded) : le paiement a été intégralement remboursé par l'intermédiaire de l'extension. Ce statut est défini lorsque le remboursement est envoyé ; si Adyen signale ensuite l'échec de ce remboursement, la commande passe au statut d'examen.

Si un second paiement réussi arrive pour une commande déjà payée, par exemple via un ancien lien de paiement, la commande n'est pas modifiée. Une note vous demande de vérifier dans l'espace client s'il existe un débit en double et de le rembourser là-bas si nécessaire. Il en va de même pour un panier : dès qu'une commande du panier est payée, aucun nouveau lien de paiement n'est créé pour une autre commande de ce panier, et un paiement qui arrive encore pour une telle commande ne lui donne pas de statut ; la commande payée reçoit la note.

Sur OpenCart 4, une commande non payée issue du paiement peut recevoir le statut Voided, que OpenCart 4 définit lorsque le client revient à l'étape Confirm Order. L'extension traite cette commande comme une commande sans statut, et un paiement ultérieur la confirme toujours.

Les notes sont des entrées de l'History de la commande que le client ne voit pas.

Onglet VibeFox Adyen Gateway

Dans Sales > Orders, ouvrez une commande payée avec Adyen. En bas de la page de la commande, à côté de History et Additional, l'onglet VibeFox Adyen Gateway affiche la PSP reference avec l'étiquette Test mode pour les paiements de test, le Payment link, le Merchant account, le Status du paiement, les montants Paid / refunded, le formulaire de remboursement, l'historique des remboursements et les Adyen notes de la commande. L'onglet est affiché aux utilisateurs qui ont accès à l'extension.

Remboursements

Dans l'onglet VibeFox Adyen Gateway, saisissez le Amount (le montant non encore remboursé est prérempli), éventuellement une Reason (optional), puis cliquez sur Refund via Adyen. Confirmez la question Refund this amount through Adyen? This cannot be undone. Les remboursements totaux et partiels sont pris en charge. Vous devez avoir le droit de modifier l'extension (défini dans System > Users > User Groups). Les remboursements sont effectués pour le montant et dans la devise autorisés par Adyen ; ainsi, après un écart de montant ou de devise, vous pouvez rembourser jusqu'à ce que le client a réellement payé, et non le total de la commande. Le remboursement est envoyé à l'environnement et au compte marchand avec lesquels le paiement a été effectué, la clé API de cet environnement doit donc être renseignée. Une seule demande de remboursement par commande s'exécute à la fois. Si Adyen n'accepte pas la demande, l'onglet affiche l'erreur et aucun remboursement n'est enregistré. Les remboursements sont disponibles dès qu'Adyen a autorisé le paiement.

Adyen traite les remboursements de manière asynchrone : la demande est ajoutée à l'historique des remboursements et aux notes avec le statut received, et le résultat final arrive par le webhook REFUND ou REFUND_FAILED. Un remboursement échoué ne compte plus comme remboursé. Lorsque les remboursements envoyés atteignent le montant payé, la commande passe au Refunded status sans notifier le client et sans remettre les produits en stock, comme pour un changement de statut manuel. Un remboursement partiel ne modifie pas le statut. Avec une capture manuelle dans Adyen, seuls les paiements capturés peuvent être remboursés.

Les retours de produits dans Sales > Returns ne renvoient pas d'argent via Adyen. Les remboursements effectués dans l'espace client d'Adyen arrivent par webhook et sont ajoutés aux notes. Le statut de la commande n'est pas modifié automatiquement.

Clé de licence

L'extension fonctionne avec une clé de licence VibeFox obtenue sur vibefox.net. Le bloc de licence License — VibeFox Adyen Gateway est le premier bloc de Extensions > Extensions > Payments > VibeFox Adyen Gateway > Edit, au-dessus des réglages. Collez la clé dans License key et cliquez sur Activate. Ensuite, le bloc affiche la clé masquée, le statut (par exemple la date jusqu'à laquelle la licence est active et votre domaine) ainsi que les boutons Check now pour vérifier à nouveau le statut, Change key pour saisir une autre clé et Remove key pour supprimer la clé de cette boutique. En dessous figurent la ligne Product: opencart-payment-adyen et le lien Manage licenses and domains in your account, qui ouvre votre compte vibefox.net. Seuls les utilisateurs administrateurs disposant du droit Modify pour l'extension peuvent modifier la clé. Les textes du bloc suivent la langue de l'administration (l'anglais et le russe sont inclus).

Si la clé n'est pas acceptée, le bloc indique la raison, par exemple Key not found, This key belongs to another product, Domain limit reached ou License expired on suivi d'une date. Après un changement d'adresse de la boutique, ou après avoir libéré un emplacement de domaine dans votre compte, cliquez sur Check now. Si le serveur de licences est injoignable, l'extension continue de fonctionner avec le dernier statut connu.

Une clé fonctionne sur un seul domaine : l'adresse de la boutique issue de la configuration d'OpenCart. Supprimer la clé de la boutique ne libère pas son emplacement de domaine. Libérez l'emplacement dans votre compte vibefox.net.

Sans clé active, Adyen n'est pas proposé aux clients lors du paiement. Si un paiement est tout de même lancé, le client voit This payment method is not available. Please choose another one. Un utilisateur administrateur connecté à l'administration dans le même navigateur voit toujours le mode de paiement dans la boutique, marqué (unlicensed — visible to admins only), afin de pouvoir configurer et tester l'extension avant d'acheter une clé. Sur OpenCart 4, cet aperçu n'est pas disponible : la boutique ne voit pas la connexion à l'administration, donc sans clé active le mode de paiement est masqué pour tout le monde. Après avoir ouvert une fois la page Edit, un rappel apparaît sur le Dashboard de l'administration. Fermez-le avec × pour le masquer pendant 7 jours. Les commandes existantes ne sont pas affectées : les paiements déjà lancés sont toujours confirmés, et les remboursements fonctionnent.

Lorsqu'une licence expire, l'extension continue de fonctionner, mais les mises à jour et le support nécessitent un renouvellement. Le statut est vérifié à nouveau automatiquement lorsque vous ouvrez le Dashboard ou la page Edit de l'administration : une fois par jour pendant les 14 premiers jours après la saisie de la clé, puis une fois par semaine. Aucune tâche cron n'est nécessaire. La désinstallation de l'extension supprime toujours la clé de licence et le statut de la licence.

Dépannage

Adyen n'apparaît pas lors du paiement : vérifiez que la licence est active, que Enable/Disable est activé et que les réglages du mode actuel sont complets : Merchant account, la clé API et la clé HMAC de ce mode, et, en mode production, Live URL prefix. La page des réglages indique ce qui manque. Vérifiez aussi que l'adresse de paiement se trouve dans la Geo Zone sélectionnée et que la commande atteint le Total défini dans les réglages.

Le paiement a abouti, mais la commande reste sans statut : le webhook ne fonctionne pas. Dans l'espace client de l'environnement utilisé (test ou production), vérifiez que le webhook Standard existe, que son URL est exactement celle affichée dans Webhook URL et que la méthode est JSON. Vérifiez que la clé HMAC de ce webhook se trouve dans le champ correspondant (Test HMAC key ou Live HMAC key). Avec une clé HMAC invalide ou absente, l'extension répond avec le code HTTP 401 et Adyen renvoie la notification plus tard ; la commande reçoit donc automatiquement son statut une fois la clé corrigée. Le journal indique que la signature HMAC est invalide ou que la clé HMAC n'est pas configurée.

Le webhook répond [rejected] HMAC key not configured : la clé HMAC de l'environnement de la notification est vide. Collez-la dans les réglages.

Le webhook répond [rejected] invalid HMAC signature : la clé HMAC appartient à un autre webhook ou à un autre environnement. Si un élément d'un lot a une mauvaise signature, tout le lot est rejeté.

Le webhook répond [rejected] busy, retry later : la commande était traitée par une autre livraison au même moment, ou le traitement a échoué. Adyen renvoie automatiquement le webhook. La raison figure dans le journal.

L'URL du webhook affiche [rejected] POST required dans le navigateur : c'est normal. L'URL n'accepte que les notifications d'Adyen.

Avertissement sur la clé HMAC à l'enregistrement : le champ doit contenir la clé HMAC hexadécimale issue de l'espace client. La valeur précédente a été conservée.

Le client voit Payment could not be initiated : consultez le champ Log de la page de l'extension (les erreurs sont toujours journalisées). Vérifiez la clé API, le compte marchand et, en mode production, le préfixe d'URL de production.

Le client voit This payment method is not available. Please reload the checkout page. : la session de paiement ne correspond plus à la commande, ou le mode de paiement a été désactivé entre-temps. Le client recharge la page de paiement.

La commande est au statut d'examen après paiement : lisez les notes dans l'onglet VibeFox Adyen Gateway. Le montant ou la devise confirmés par Adyen ne correspondaient pas à la commande, une capture a échoué, ou le paiement est arrivé après que le statut de la commande a été modifié.

Aucun formulaire de remboursement dans l'onglet : l'onglet indique la raison : Adyen n'a pas encore autorisé le paiement, il est intégralement remboursé, votre groupe d'utilisateurs n'a pas le droit de modifier l'extension, ou les identifiants de l'environnement dans lequel le paiement a été effectué ne sont pas configurés.

Le remboursement échoue : l'onglet affiche le message d'Adyen. Avec une capture manuelle, seuls les paiements capturés peuvent être remboursés. Si un autre remboursement de la commande est en cours, patientez un instant puis réessayez.

Pour les développeurs : avant la création du lien de paiement, l'extension déclenche l'événement OpenCart adyg_payment_link_request avec les données de la requête et la commande.

Désinstallation

Allez dans Extensions > Extensions, choisissez le type Payments et cliquez sur Uninstall (le bouton rouge −) à côté de VibeFox Adyen Gateway. La clé de licence et le statut de licence de cette extension sont toujours supprimés. OpenCart supprime toujours ses propres réglages de l'extension : Enable/Disable, Sort Order, Geo Zone, Total et les statuts de commande de la section Orders, qui reviennent à leurs valeurs par défaut lors d'une réinstallation. L'événement OpenCart de l'extension est également supprimé (sur OpenCart 4, ses événements et son action de démarrage, qui laisse passer le webhook en mode maintenance). Si Delete data on uninstall est activé, les autres réglages de la passerelle (titre, description, mode test, compte marchand, clés, préfixe d'URL de production, journalisation) et le journal sont supprimés. S'il est désactivé, ils sont conservés pour une réinstallation ultérieure. Les enregistrements de paiement Adyen (références PSP, événements de webhook, remboursements) sont toujours conservés, de sorte que les commandes payées auparavant peuvent encore être remboursées après une réinstallation. Les commandes existantes conservent leurs notes de paiement.

Sur OpenCart 4, pour supprimer aussi les fichiers de l'extension, allez dans Extensions > Installer après la désinstallation, cliquez sur Uninstall (le bouton orange −) à côté de VibeFox Adyen Gateway dans la liste des extensions installées, puis sur Delete (le bouton rouge en forme de corbeille) pour supprimer le paquet téléchargé.

Adyen est une marque déposée de son propriétaire respectif. Cette extension n'est ni affiliée à Adyen ni approuvée par Adyen.