VibeFox Nets Nexi for WooCommerce — Aide
Prérequis
WordPress : 6.0 ou ultérieur.
WooCommerce : 7.0 ou ultérieur, installé et activé. Le plugin refuse de s'activer sans lui.
PHP : 8.0 ou ultérieur.
Compte Nets : vous avez besoin des clés secrètes de votre compte Nets Easy (test et production). Seules les clés secrètes sont utilisées. Les clés de checkout ne sont pas nécessaires, car les clients paient sur la page de paiement hébergée de Nets.
Devises et modes de paiement : le plugin ne restreint ni les devises ni les pays. Utilisez les devises activées sur votre compte Nets ; une devise non prise en charge est signalée par Nets lors de la création du paiement. Les modes de paiement affichés au client dépendent de votre contrat Nets, du pays et de la devise.
HTTPS pour les webhooks : Nets n'appelle que des adresses HTTPS publiques d'au plus 256 caractères sans « & ». Votre site doit donc utiliser HTTPS et des permaliens lisibles pour recevoir les webhooks. Sur les autres sites, le paiement est tout de même confirmé lorsque le client revient dans la boutique, ou via l'action de commande.
Clé de licence VibeFox : achetée sur vibefox.net. Une clé fonctionne sur un seul domaine.
Installation
1. Dans WordPress, rendez-vous dans Plugins > Add New > Upload Plugin, choisissez le fichier ZIP du plugin et cliquez sur Install Now. Vous pouvez aussi envoyer le dossier wcp_nets_nexi_gateway dans /wp-content/plugins/ par FTP.
2. Cliquez sur Activate.
3. Ouvrez les réglages : WooCommerce > Settings > Payments > Nets Nexi (Nordics) > Manage, ou cliquez sur Settings sous le nom du plugin sur la page Plugins.
4. Saisissez votre clé de licence VibeFox dans le bloc de licence en haut de la page, puis cliquez sur Activate.
5. Copiez la clé secrète de test depuis le portail de test Nets Easy et collez-la dans Test Secret Key (voir Configuration).
6. Activez Enable/Disable, laissez Test Mode activé et passez une commande de test. Saisissez ensuite la clé secrète de production et décochez Test Mode.
Configuration
Tous les réglages se trouvent sur une seule page : WooCommerce > Settings > Payments > Nets Nexi (Nordics). Au-dessus des champs, la page vous avertit lorsque la clé secrète du mode sélectionné est absente (le mode de paiement est alors masqué lors du paiement), et affiche Nets Nexi is in test mode: payments go to the Nets test environment and no real money is charged. tant que le mode test est activé. Dans la liste des modes de paiement, Nets Nexi est signalé comme nécessitant une configuration tant que le mode sélectionné ne dispose pas d'une clé secrète.
Général
Enable/Disable : Enable Nets Nexi Gateway active ou désactive le mode de paiement. Par défaut : désactivé.
Title : le titre du mode de paiement affiché aux clients lors du paiement. Par défaut : Nets Easy.
Description : la description du mode de paiement affichée aux clients lors du paiement. Par défaut : Pay securely with Nets Easy.
Clés API
Copiez les clés secrètes depuis le portail Nets Easy, rubrique Company > Integration : le portail de test (test.portal.dibspayment.eu) pour la clé de test et le portail de production (portal.dibspayment.eu) pour la clé de production. Les clés de checkout ne sont pas nécessaires.
Test Mode : Enable test mode. Le mode test utilise test.api.dibspayment.eu avec la clé secrète de test ; le mode production utilise api.dibspayment.eu avec la clé secrète de production. Les remboursements et les captures d'une commande utilisent toujours l'environnement dans lequel elle a été payée. Par défaut : activé.
Test Secret Key : votre clé secrète d'API pour l'environnement de test Nets.
Live Secret Key : votre clé secrète d'API pour l'environnement de production Nets.
Paiement
Les notifications Nets (webhooks) sont enregistrées automatiquement à chaque paiement. Il n'y a rien à configurer dans le portail Nets. Cette section affiche l'URL du webhook. Elle ressemble à https://your-site/wc-api/nng_nets_nexi/. Si l'URL n'est pas une adresse HTTPS publique, la section vous avertit que le site ne reçoit pas de webhooks ; les paiements sont alors confirmés lorsque le client revient dans la boutique ou via l'action de commande Nets: check payment status and capture. Les événements suivants sont enregistrés :
Chaque webhook doit contenir le secret aléatoire que le plugin a créé pour la commande. Les webhooks sans le bon secret sont rejetés. Le webhook indique seulement au plugin quel paiement a changé : le paiement lui-même est toujours relu depuis l'API Nets avec votre clé secrète.
Order Status After Payment : le statut de la commande une fois que Nets a confirmé et débité le paiement. Le statut est appliqué immédiatement, de sorte que le client ne reçoit qu'un seul e-mail.
Avancé
Debug log : Enable debug logging journalise les appels à l'API et les changements de statut des paiements dans WooCommerce > Status > Logs, source wcp_nets_nexi_gateway. Les erreurs sont toujours journalisées. Les clés et les données clients ne sont pas journalisées. Par défaut : désactivé.
Delete Data on Uninstall : Delete the plugin settings and logs when the plugin is deleted. Désactiver le plugin ne supprime jamais rien. Les données de paiement enregistrées sur les commandes sont toujours conservées. Par défaut : désactivé.
Paiement
Le client choisit le mode de paiement (par défaut Nets Easy) et passe la commande. Le plugin crée un paiement Nets avec les lignes de commande, la livraison et les frais dans la devise de la commande, puis envoie le client vers la page de paiement hébergée de Nets. L'adresse e-mail, le nom, l'adresse et le numéro de téléphone du client sont transmis à Nets lorsque Nets accepte leur format ; votre page de conditions générales est liée sur la page Nets. En mode test, le paiement affiche Test mode: no real money will be charged.
Le client paie puis revient sur la page de confirmation de commande de votre boutique. La commande n'est marquée payée qu'après confirmation par Nets : le plugin relit le paiement depuis l'API Nets, compare le montant et la devise réservés à la commande, débite la réservation, et ne termine la commande qu'ensuite. Cela se produit par le webhook, au retour du client sur la page de confirmation de commande, ou via l'action de commande Nets: check payment status and capture.
Si le client annule sur la page Nets, il revient au paiement ou à la page Pay for order avec le message The Nets payment was cancelled. You can try again or choose another payment method. Un client peut payer à nouveau une commande non payée. Le plugin vérifie d'abord le paiement précédent ; s'il est déjà payé, la commande est confirmée. Sinon, la session Nets précédente est fermée avant qu'une nouvelle ne commence. Si un paiement de la commande est retenu pour votre examen, le client voit A payment for this order is already being reviewed by the shop. Please contact us instead of paying again.
Si Nets ne peut pas démarrer le paiement, le client voit un court message, par exemple Nets could not start the payment with the details of this order. Please check your address and phone number, or choose another payment method. ou The payment service could not be reached. Please try again in a moment. Les détails sont inscrits dans le journal.
Le mode de paiement fonctionne avec le paiement classique, avec le bloc Paiement et sur la page Pay for order. Il est compatible avec WooCommerce High-Performance Order Storage (HPOS).
Le plugin n'utilise que la page de paiement hébergée. Il ne propose ni checkout Nets intégré à la page, ni abonnements ou paiements récurrents, ni cartes enregistrées, ni frais de facturation, ni mode autorisation seule, ni captures partielles par expédition.
Commandes et remboursements
Statuts de commande
Pending payment : le client a été envoyé vers Nets et n'a pas encore payé. La note de commande indique l'identifiant du paiement Nets, le montant et l'environnement.
Processing or Completed : Nets a confirmé et débité le paiement. Le statut suit Order Status After Payment. La note de commande indique l'identifiant du paiement, celui du débit et le mode de paiement. L'identifiant de transaction est l'identifiant du paiement Nets.
On hold : le montant ou la devise chez Nets diffère de la commande (non capturé), la capture a été refusée, ou le client a payé après l'annulation de la commande (réservé, non capturé). La note de commande l'explique. Après examen de la commande, capturez avec l'action Nets: check payment status and capture, ou annulez la réservation dans le portail Nets.
Cancelled : la réservation du dernier paiement de la commande a été annulée, par exemple dans le portail Nets.
Les webhooks répétés et les rechargements ne débitent jamais deux fois et n'ajoutent ni notes, ni décréments de stock, ni e-mails en double ; une commande payée, remboursée ou annulée après paiement n'est jamais rouverte. Si un ancien lien de paiement est terminé pour une commande déjà payée, la seconde réservation est libérée automatiquement ; si elle a déjà été débitée, une note vous demande de la rembourser dans le portail Nets.
Action de commande
Pour les commandes non payées dotées d'un paiement Nets, la liste des actions de commande contient Nets: check payment status and capture. Elle relit le paiement depuis Nets et capture une réservation correspondante. Si rien ne change, une note explique pourquoi, par exemple que le client n'a pas encore terminé le paiement.
Remboursements
Ouvrez la commande, cliquez sur Refund, saisissez le montant et cliquez sur Refund via Nets Easy (le bouton reprend le titre du mode de paiement). Les remboursements totaux et partiels sont pris en charge une fois le paiement débité ; un paiement seulement réservé peut être annulé dans le portail Nets. Le remboursement porte sur le débit de la commande, dans l'environnement où elle a été payée. Si Nets n'accepte pas le remboursement, WooCommerce affiche l'erreur et aucun remboursement n'est enregistré. Un remboursement réussi est ajouté aux notes de commande avec l'identifiant de remboursement Nets.
Les remboursements effectués directement dans le portail Nets ne deviennent pas des remboursements WooCommerce. Si nécessaire, créez un remboursement manuel dans WooCommerce sans utiliser Refund via Nets Easy.
Clé de licence
Le plugin fonctionne avec une clé de licence VibeFox obtenue sur vibefox.net. Le bloc de licence se trouve en haut de WooCommerce > Settings > Payments > Nets Nexi (Nordics). Saisissez la clé dans License key et cliquez sur Activate. Le bloc affiche le statut, par exemple la date jusqu'à laquelle la licence est active, ainsi que votre domaine. Utilisez Check now pour vérifier à nouveau le statut, Change key pour saisir une autre clé et Remove key pour la retirer de ce site. Le lien Manage licenses and domains in your account ouvre votre compte vibefox.net.
Une clé fonctionne sur un seul domaine. Retirer la clé d'un site ne libère pas son emplacement de domaine. Libérez-le dans votre compte vibefox.net.
Sans clé active, Nets Nexi 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. Les gestionnaires de la boutique connectés voient toujours le mode de paiement, marqué (unlicensed — visible to admins only), afin que vous puissiez configurer et tester le plugin avant d'acheter une clé. Un rappel apparaît sur la page Plugins et sur les pages WooCommerce. 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, le plugin continue de fonctionner, mais les mises à jour et l'assistance nécessitent un renouvellement. Le statut est vérifié à nouveau automatiquement en arrière-plan.
Dépannage
Nets Nexi n'apparaît pas lors du paiement : vérifiez que la licence est active, que Enable/Disable est activé et que le mode sélectionné dispose d'une clé secrète : Test Secret Key en mode test, Live Secret Key en mode production. La page des réglages affiche un avertissement lorsque la clé est absente.
Le paiement a été effectué, mais la commande reste en Pending payment : le webhook n'a pas atteint votre boutique. Vérifiez que le site utilise HTTPS et des permaliens lisibles, afin que l'URL du webhook de la section Payment soit une adresse HTTPS publique sans « & », et que la clé secrète de l'environnement du paiement est renseignée. Utilisez ensuite l'action de commande Nets: check payment status and capture. La commande est aussi confirmée lorsque le client revient sur la page de confirmation de commande.
Webhook answers Unauthorized : le webhook ne contenait pas le secret de cette commande. Les webhooks ne sont acceptés qu'avec le secret enregistré lors du paiement.
Webhook answers Busy, retry later, Payment lookup failed ou Payment not reserved yet : une autre requête était en train de mettre la commande à jour, l'API Nets était injoignable, ou la réservation n'était pas encore visible. Nets renvoie le webhook automatiquement.
Le client voit une erreur lors de la passation de la commande : activez le Debug log et consultez WooCommerce > Status > Logs, source wcp_nets_nexi_gateway. This payment method is temporarily unavailable. Please choose another payment method. indique en général une clé secrète erronée ou absente. Une devise refusée est signalée par Nets dans le journal.
Order is On hold after payment : lisez la note de commande. Si la capture a été refusée, réessayez avec l'action de commande Nets: check payment status and capture ou débitez-la dans le portail Nets. Si le montant ou la devise diffère, vérifiez le paiement dans le portail Nets. Si le client a payé après l'annulation, examinez la commande, puis capturez ou annulez la réservation.
Refund via Nets Easy est absent ou échoue : les remboursements ne sont possibles qu'après le débit du paiement. Vérifiez dans la note de commande que le débit a eu lieu. Un remboursement utilise la clé secrète de l'environnement dans lequel la commande a été payée ; cette clé doit donc être renseignée.
The license block shows an error : suivez le message affiché dans le bloc. Par exemple, si la clé est déjà utilisée sur un autre domaine, libérez un emplacement dans votre compte vibefox.net et cliquez sur Check now. Si l'adresse du site a changé, cliquez sur Check now pour activer la clé pour le nouveau domaine. Si le serveur de licences est injoignable, le plugin continue de fonctionner avec le dernier statut connu.
Désinstallation
Désactiver le plugin conserve toutes les données. Pour le supprimer, désactivez-le puis supprimez-le sur la page Plugins. La clé de licence et le statut de licence de ce plugin sont toujours supprimés. Les réglages de la passerelle et les journaux ne sont supprimés que si Delete Data on Uninstall était activé. Sinon, ils sont conservés pour une future réinstallation. Les commandes existantes conservent leurs notes de paiement et leurs identifiants de transaction.
Nets, Nets Easy et Nexi sont des marques de leurs propriétaires respectifs. Ce plugin n'est affilié ni à Nets ni à Nexi, et n'est approuvé par aucune des deux sociétés.