VibeFox Redsys for OpenCart — Aide

Prérequis

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

PHP : 8.0 ou ultérieur.

Compte marchand Redsys : votre banque (l'acquéreur qui vous a fourni le TPV virtuel Redsys) vous fournit le code marchand (FUC), le numéro de terminal et l'accès à l'espace d'administration Redsys, où figure la clé secrète SHA-256 de chaque environnement. La clé de l'environnement de test est différente de la clé réelle. La notification en ligne (HTTP) doit être active pour votre terminal. Interrogez votre banque si vous n'êtes pas sûr.

Devise : l'une des devises prises en charge par l'extension (voir Configuration), et votre terminal Redsys doit être activé par la banque pour cette devise. La plupart des terminaux n'acceptent que l'EUR.

Boutique accessible : Redsys doit pouvoir joindre votre boutique depuis Internet, sans authentification ni blocage par un pare-feu, pour transmettre les notifications de paiement.

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_redsys_gateway-oc3-(version).ocmod.zip et le paquet OpenCart 4 wcp_redsys_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 choisissez le fichier wcp_redsys_gateway-oc3-(version).ocmod.zip. L'extension ne contient aucune modification OCMOD, la rubrique Extensions > Modifications n'a donc pas besoin d'être actualisée. Au lieu de l'installateur, vous pouvez aussi copier le contenu du dossier upload de ce paquet dans le dossier racine de votre boutique.

2. Allez dans Extensions > Extensions et choisissez le type Payments. Repérez VibeFox Redsys 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 code marchand, votre terminal et la clé secrète de chaque environnement (voir Configuration).

5. Activez Enable/Disable et cliquez sur Save. Effectuez un paiement de test avec Test Mode activé, puis désactivez Test Mode pour accepter de vrais paiements.

OpenCart 4

1. Dans l'administration, allez dans Extensions > Installer, cliquez sur Upload et choisissez le fichier wcp_redsys_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é de celui-ci.

3. Allez dans Extensions > Extensions et choisissez le type Payments. Repérez VibeFox Redsys Gateway, cliquez sur Install (le bouton vert +), puis sur Edit (le bouton crayon).

4. Saisissez la clé de licence et les données Redsys comme aux étapes 3 à 5 pour OpenCart 3. La page de réglages et ses champs sont les mêmes dans les deux versions. Seule l'URL de notification diffère (voir Notifications de paiement).

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 Redsys Gateway > Edit. Les sections sont listées à gauche ; le bouton Save situé sous la liste enregistre la page entière. Sans le droit de modifier l'extension, la page affiche les réglages mais ne peut pas les enregistrer.

Au-dessus des réglages, la page vous avertit lorsque le code marchand est absent ou ne comporte pas uniquement des chiffres, lorsqu'une clé secrète n'est pas une clé SHA-256 Redsys valide, lorsque la clé du mode actuel est vide (le mode de paiement est alors masqué à la caisse) et lorsque la devise par défaut de la boutique n'est pas prise en charge. Tant que le mode test est activé, elle affiche Test mode is active: payments go to the Redsys test environment (SIS-T), no real money is charged.

Lors de l'enregistrement, Title doit comporter de 1 à 128 caractères (Enter a title for the payment method (1 to 128 characters).), Sort Order doit être un nombre entier (les nombres négatifs sont acceptés), Total doit être un nombre égal ou supérieur à 0, et la zone géographique ainsi que chaque statut de commande doivent exister. Sinon, rien n'est enregistré.

Redsys

Enable/Disable : Enable Redsys Gateway active ou désactive le mode de paiement. Par défaut : désactivé.

Title : le nom du mode de paiement que voit le client à la caisse. C'est aussi le nom du mode de paiement enregistré dans la commande. Par défaut : Credit/Debit Card (Redsys). Obligatoire, jusqu'à 128 caractères.

Description : le texte affiché au client à l'étape Confirm Order, au-dessus du bouton de confirmation. Par défaut : Pay securely with your credit or debit card via Redsys.

Sort Order : la position de Redsys parmi les modes de paiement à la caisse. Laissez le champ vide ou saisissez un nombre entier.

Geo Zone : proposer Redsys 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 de la commande, dans la devise par défaut de la boutique, que la commande doit atteindre pour que Redsys soit proposé : un nombre égal ou supérieur à 0. Laissez le champ vide pour proposer Redsys quel que soit le montant.

Compte Redsys

Votre banque vous fournit le code marchand (FUC), le terminal et l'accès à l'espace d'administration Redsys, où figure la clé secrète SHA-256 de chaque environnement. La section contient un lien vers l'espace d'administration Redsys.

Merchant Code (FUC) : votre code marchand Redsys, jusqu'à 9 chiffres. Tout caractère qui n'est pas un chiffre est supprimé lors de l'enregistrement.

Terminal Number : le numéro de terminal attribué par votre banque, jusqu'à 3 chiffres. Par défaut : 1. Un champ vide est enregistré comme 1.

Secret Key (SHA-256) — live : la clé Base64 SHA-256 de l'environnement réel (production), généralement de 32 caractères. Elle est utilisée lorsque le mode test est désactivé.

Mode test (SIS-T)

L'environnement de test de Redsys possède sa propre clé secrète. La section affiche les données publiques de test de Redsys : code marchand 999008881, terminal 1, clé sq7HjrUOBfKmC576ILgskD5srU870gJ7, carte 4548 8100 0000 0003, expiration 12/49, CVV 123. Aucun argent réel n'est débité en mode test.

Test Mode : les paiements et les remboursements sont envoyés à l'environnement de test de Redsys (SIS-T) et signés avec la clé de test. Par défaut : activé. Désactivez-le pour accepter de vrais paiements. Lorsqu'il est activé, les clients voient TEST MODE: Redsys test environment, no real money is charged. à l'étape Confirm Order.

Secret Key (SHA-256) — test : la clé Base64 SHA-256 de l'environnement de test. Utilisez votre propre clé de test ou la clé publique de test indiquée ci-dessus.

Les clés enregistrées ne sont jamais réaffichées. Le champ reste vide et affiche Saved — leave empty to keep it. Saisissez une nouvelle valeur uniquement pour la modifier. Pour supprimer une clé enregistrée, cochez Clear saved secret on save sous le champ et cliquez sur Save.

Page de paiement et commandes

Commerce Name : le nom de la boutique affiché sur la page de paiement Redsys, de 25 caractères au maximum. Par défaut : le nom de votre boutique, tronqué à 25 caractères.

Order Status After Payment : le statut que reçoit une commande payée.

Les écarts de montant ou de devise, les paiements de test lorsque la passerelle est en mode production et les paiements de tentatives annulées reçoivent toujours le On hold (review) status.

OpenCart crée la commande à l'étape Confirm Order sans statut (une commande manquante). Elle ne reçoit un statut qu'après la notification signée de Redsys. Un paiement refusé ou annulé laisse la commande sans statut ; le client revient à la caisse, le panier étant conservé. Chaque champ ci-dessous liste vos statuts de commande OpenCart.

Processing status : utilisé lorsque Order Status After Payment vaut Processing. Par défaut : En cours.

Completed status : utilisé lorsque Order Status After Payment vaut Completed. Par défaut : Terminée.

On hold (review) status : pour les paiements qui nécessitent votre vérification (voir ci-dessus), ou pour chaque commande payée lorsque Order Status After Payment vaut On hold (review). Par défaut : En attente, car OpenCart n'a pas de statut En suspens ; une note sur la commande explique la raison. Vous pouvez créer votre propre statut dans System > Localisation > Order Statuses et le sélectionner ici.

Refunded status : défini lorsque le paiement Redsys est entièrement remboursé depuis la page de la commande. Par défaut : Remboursée.

Notifications de paiement

Notification URL : Redsys signale chaque paiement à cette adresse de votre boutique. Elle est affichée dans cette section. Sur OpenCart 3, elle ressemble à https://your-store/index.php?route=extension/payment/wcp_redsys_gateway/notify, et sur OpenCart 4 à https://your-store/index.php?route=extension/wcp_redsys_gateway/payment/wcp_redsys_gateway.notify. Elle est construite à partir de l'adresse de la vitrine de votre installation OpenCart. L'extension la transmet à Redsys avec chaque paiement ; vous n'avez donc rien à copier dans l'espace Redsys. La notification en ligne (HTTP) doit être active pour votre terminal. Interrogez votre banque si aucune commande n'est confirmée après un paiement réussi. Les notifications sans signature valide sont rejetées. Sans la notification, la commande ne reçoit jamais de statut.

Avancé

Debug log : écrit les détails des paiements, des notifications et des remboursements dans rdsg_debug.log.php, dans le dossier des journaux d'OpenCart (storage/logs). Le fichier ne peut pas être ouvert depuis le web ; à 5 Mo, il est déplacé vers une copie ancienne. Les erreurs sont toujours journalisées, même lorsque cette option est désactivée. Les clés, les signatures et les données de carte ne sont jamais journalisées. 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 : lorsqu'il est activé, la désinstallation de l'extension supprime les réglages de la passerelle et le journal. Les enregistrements de paiement Redsys des commandes (nécessaires aux remboursements) sont toujours conservés. Par défaut : désactivé.

Import / Export

Export : Download JSON enregistre les réglages dans un fichier JSON. Les clés secrètes 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 secrètes enregistrées sont conservées.

Devises prises en charge

EUR, USD, GBP, JPY, CHF, CAD, AUD, NZD, NOK, SEK, DKK, PLN, CZK, HUF, BGN, RON, ILS, INR, MYR, SGD, THB, SAR, ZAR, RUB, BRL, MXN, ARS, CLP, COP, PEN, CNY, TWD. Le mode de paiement est masqué lorsque la devise du client ne figure pas dans cette liste.

Paiement

À l'étape Payment Method, le client choisit le mode de paiement (par défaut Credit/Debit Card (Redsys)). À l'étape Confirm Order, le client voit votre description. OpenCart crée la commande à cette étape, toujours sans statut. Lorsque le client clique sur Confirm Order, l'extension prépare un formulaire de paiement signé, le client voit Redirecting to Redsys for payment. Please wait... et passe à la page de paiement Redsys de votre banque. Si le navigateur ne poursuit pas automatiquement, le client clique sur Pay via Redsys. 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 caisse.

Sur la page Redsys, le client paie par carte avec 3-D Secure, ou par Bizum ou tout autre moyen que votre banque a activé pour le terminal. La page utilise la langue du client (espagnol, anglais, catalan, français, allemand, italien, portugais et d'autres), ou l'anglais pour les autres langues. Le montant correspond au total de la commande dans les unités monétaires minimales de la devise de la commande, par exemple EUR 43,45 s'écrit 4345, et JPY ou CLP sont sans décimales. Le paiement est décrit comme Order suivi du numéro de commande et du nom de votre boutique.

Après le paiement, le client revient sur votre boutique. Le retour en lui-même ne marque rien comme payé. La commande n'est marquée payée que lorsque Redsys la confirme par la notification signée. Elle reçoit ensuite son statut de la manière habituelle d'OpenCart, avec les e-mails de commande habituels et la mise à jour du stock, et le client voit la page de confirmation de commande d'OpenCart avec Your payment with Redsys has been received. Si la commande a reçu le On hold (review) status, la page affiche Your payment with Redsys has been received and is being reviewed by the store. Si la notification n'est pas encore arrivée, une page Payment confirmation affiche Redsys is confirming your payment. If you completed the payment, your order will be confirmed in a few moments — please do not pay again. avec les boutons Check again et Back to checkout.

Si le client annule ou si le paiement est refusé, Redsys renvoie le client à la caisse avec The Redsys payment was not completed. You can try again or choose another payment method. Le panier est conservé et le client peut payer à nouveau. Chaque nouvelle tentative reçoit un nouveau numéro de commande Redsys, et un paiement effectué depuis l'une d'elles, par exemple depuis un second onglet du navigateur, est toujours reconnu. OpenCart 3 crée une nouvelle commande chaque fois que l'étape Confirm Order est affichée ; si une autre commande du même panier est déjà payée, le client accède directement à la page de confirmation, et un paiement tardif de l'autre commande n'est pas appliqué.

Sur OpenCart 4, le message concernant le paiement non abouti s'affiche au-dessus de la page de caisse. OpenCart 4 conserve une seule commande pour la caisse et la met à jour ; ainsi, après une annulation ou un paiement refusé, le client paie la même commande avec un nouveau numéro de commande Redsys. Si cette commande a été fermée entre-temps, le client est renvoyé à la caisse avec Your previous order was closed without a payment. Please confirm the order again to pay with a new order. ou, si elle comportait un paiement Redsys, avec Your order was cancelled or refunded by the store. Please confirm the order again to pay with a new order. Le prochain Confirm Order paie une nouvelle commande. Si la commande de la caisse est déjà payée mais que le panier a changé depuis, y compris une nouvelle quantité, le client est renvoyé à la caisse et le nouveau panier est payé avec une nouvelle commande.

Si le paiement ne peut pas être envoyé à Redsys, le client reste à l'étape Confirm Order avec un bref message : Redsys payments are not configured correctly. Please choose another payment method or contact us., un message indiquant que les paiements dans cette devise ne sont pas acceptés, ou The order total must be greater than zero.

La notification et le retour du client fonctionnent aussi lorsque la boutique est en mode maintenance : OpenCart 3 laisse passer les requêtes des extensions de paiement, et sur OpenCart 4 l'extension ajoute pour elles une action de démarrage.

L'extension ne gère que les paiements ponctuels, autorisés et capturés immédiatement sur la page Redsys. Elle ne propose ni formulaire de carte sur votre propre site (InSite ou iframe), ni cartes enregistrées, ni paiements en un clic ou tokenisation, ni abonnements ou paiements récurrents, ni pré-autorisation avec capture ultérieure, ni liens de paiement pour les commandes créées dans l'administration.

Commandes et remboursements

Statuts de commande

Aucun statut (commande manquante) : le client a été redirigé vers Redsys et n'a pas payé, le paiement a été refusé ou annulé, ou la notification Redsys n'est pas encore arrivée. Dans Sales > Orders, ces commandes ne s'affichent qu'avec le filtre Order Status réglé sur Missing Orders.

Processing, Completed ou On hold (review) : le paiement a été confirmé. Le statut dépend de Order Status After Payment. Une note indique le numéro de commande Redsys (Ds_Order), le code d'autorisation et le code de réponse, suivis de [TEST] pour les paiements de test.

On hold (review) après le paiement : Redsys a signalé un montant ou une devise différent du total de la commande, un paiement de test est arrivé alors que la passerelle était en mode production (aucun argent réel n'a été débité), ou le client a payé après avoir annulé ce paiement sur la page Redsys. La note l'explique. Vérifiez le paiement dans l'espace d'administration Redsys, puis traitez la commande ou remboursez le paiement.

Refunded status : le paiement a été entièrement remboursé par l'intermédiaire de l'extension.

Un paiement refusé ne modifie jamais une commande qui a déjà un statut. Pour les codes de réponse les plus courants, le journal et les notes donnent une raison brève, par exemple Insufficient funds, Card expired ou Cancelled by the customer. Si un second paiement, différent, arrive pour une commande ou un panier déjà payé, la commande n'est pas modifiée. Une note vous invite à rembourser le paiement en double dans l'espace d'administration Redsys. Si Redsys indique qu'un paiement est encore en cours, une note est ajoutée et la commande attend le résultat final.

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

Onglet VibeFox Redsys Gateway

Dans Sales > Orders, ouvrez une commande payée avec Redsys. En bas de la page de la commande, à côté de History et Additional, l'onglet VibeFox Redsys Gateway affiche le Redsys order number (Ds_Order), l'Authorisation code / response, l'Environment (production ou test) avec une étiquette Test mode, le Status du paiement, Paid / refunded, une indication de vérification pour les commandes en attente, le formulaire de remboursement, l'historique des remboursements, les Redsys notes de la commande et les Redsys order numbers issued for this cart. L'onglet est affiché aux utilisateurs ayant accès à l'extension.

Remboursements

Dans l'onglet, saisissez le Amount (le montant non encore remboursé est prérempli), éventuellement un Reason (optional), puis cliquez sur Refund via Redsys. Confirmez la question Refund this amount through Redsys? This cannot be undone. Les remboursements totaux et partiels sont pris en charge. Vous devez disposer du droit de modifier les commandes (Sales > Orders, défini dans System > Users > User Groups). Les remboursements sont effectués dans le montant et la devise débités par Redsys ; après un écart de montant ou de devise, vous pouvez donc rembourser jusqu'à ce que le client a réellement payé, et non le total de la commande. Le remboursement est envoyé via l'API REST de Redsys à l'environnement dans lequel le paiement a été effectué (test ou production), signé avec la clé de cet environnement, et la signature de la réponse est vérifiée. Si Redsys n'accepte pas le remboursement, l'onglet affiche l'erreur et aucun remboursement n'est enregistré. Un remboursement réussi est ajouté à l'historique des remboursements et aux notes, avec le numéro de commande Redsys et le motif. Un remboursement total place la commande 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.

Les retours de produits dans Sales > Returns ne renvoient pas d'argent via Redsys.

Les remboursements effectués dans l'espace d'administration Redsys ne sont pas enregistrés comme des remboursements de l'extension. Lorsque Redsys envoie une notification à ce sujet, une note est ajoutée à la commande. Le statut de la commande ne change pas automatiquement.

Clé de licence

L'extension fonctionne avec une clé de licence VibeFox obtenue sur vibefox.net. Le bloc de licence License — VibeFox Redsys Gateway est le premier bloc de Extensions > Extensions > Payments > VibeFox Redsys 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 retirer la clé de cette boutique. En dessous figurent la ligne Product: opencart-payment-redsys et le lien Manage licenses and domains in your account, qui ouvre votre compte vibefox.net. Seuls les utilisateurs administrateurs disposant du droit Modify sur 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. Retirer la clé de la boutique ne libère pas son emplacement de domaine. Libérez-le dans votre compte vibefox.net.

Sans clé active, Redsys n'est pas proposé aux clients à la caisse. 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 encore le mode de paiement dans la boutique, marqué (unlicensed — visible to admins only), afin que vous puissiez 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 l'assistance 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

Redsys n'apparaît pas à la caisse : vérifiez que la licence est active, que Enable/Disable est activé, que le code marchand et le terminal sont renseignés et que le mode actuel dispose d'une clé valide : Secret Key (SHA-256) — test en mode test, Secret Key (SHA-256) — live en mode production. Vérifiez que la devise du client figure dans la liste des devises prises en charge. La page des réglages affiche un avertissement pour chacun de ces problèmes. Vérifiez également 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 : la notification Redsys n'a pas atteint votre boutique. Demandez à votre banque de vérifier que la notification en ligne (HTTP) est active pour votre terminal. Vérifiez que l'adresse affichée sous Notification URL est joignable depuis Internet, sans authentification ni blocage par un pare-feu. Activez Debug log et consultez le champ Log sur la page de l'extension.

La notification répond Forbidden : la signature ne correspond pas à la clé secrète de l'environnement dans lequel le paiement a été lancé, ou le code marchand de la notification n'est pas le vôtre. Vérifiez que les clés secrètes et le code marchand des réglages sont ceux de votre terminal.

La notification répond Order not found : la notification était correctement signée, mais aucune commande de cette boutique n'utilise ce numéro de commande Redsys.

La notification répond Busy : le panier était en cours de traitement par une autre notification au même moment, ou le statut de la commande n'a pas pu être défini. Redsys réessaie la notification. Le journal indique la raison.

La notification répond Bad request : la requête ne contenait aucun paramètre Redsys valide, ou des paramètres mal formés. Elle ne provenait pas de Redsys au format attendu.

La commande est au statut « on hold » après le paiement : lisez les notes de l'onglet VibeFox Redsys Gateway (voir Statuts de commande), puis traitez la commande ou remboursez le paiement.

Les paiements de test ne confirment pas les commandes en mode production : un paiement de test ne règle jamais une commande tant que Test Mode est désactivé. La commande est alors mise en attente avec une note. Utilisez le mode test avec la clé de test pour les paiements de test.

Échec d'un remboursement : lisez l'erreur. Redsys refund: the merchant code or the TEST secret key is not configured. (ou LIVE) signifie que la clé de l'environnement du paiement est absente. Les codes d'erreur Redsys sont expliqués dans le message, par exemple SIS0057 (le montant dépasse ce qui reste du paiement), SIS0056 (paiement d'origine introuvable : autre environnement ou terminal), SIS0042 (erreur de signature : vérifiez la clé de cet environnement), SIS0026 (code marchand ou terminal inconnu) et SIS0027 (devise non configurée pour le terminal). Si Redsys est injoignable, le remboursement n'est pas effectué. Réessayez plus tard.

Aucun formulaire de remboursement dans l'onglet : l'onglet indique la raison, par exemple l'absence de paiement Redsys confirmé pour la commande, un remboursement total déjà effectué, ou l'absence de droit de modifier les commandes pour votre groupe d'utilisateurs.

Pour les développeurs : l'extension déclenche les événements OpenCart wcp_redsys_gateway/merchant_parameters (les paramètres du paiement et la commande) et wcp_redsys_gateway/currency_codes (la liste des devises prises en charge). N'ajoutez une devise que si votre banque l'a activée pour le terminal.

Désinstallation

Allez dans Extensions > Extensions, choisissez le type Payments et cliquez sur Uninstall (le bouton rouge −) à côté de VibeFox Redsys 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 quatre statuts de commande, 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 la notification et le retour du client en mode maintenance). Si Delete Data est activé, les autres réglages de la passerelle (titre, description, code marchand, terminal, clés, mode test, nom de la boutique, statut de commande après paiement, journalisation) ainsi que le journal sont supprimés. S'il est désactivé, ils sont conservés pour une réinstallation ultérieure. Les enregistrements de paiement et les remboursements Redsys 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 et cliquez sur Uninstall (le bouton orange −) à côté de VibeFox Redsys 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é.

Redsys est une marque de son propriétaire. Cette extension n'est ni affiliée à Redsys ni approuvée par Redsys.