VibeFox CorvusPay for WooCommerce — Aide

Prérequis

WordPress: 6.0 ou ultérieur.

WooCommerce: 7.0 ou ultérieur, installé et actif. L'extension refuse de s'activer sans lui.

PHP: 8.0 ou ultérieur.

Devise : AUD, BAM, BHD, CAD, CHF, CZK, DKK, EUR, GBP, HRK, HUF, ISK, MKD, NOK, PLN, RON, RSD, RUB, SEK ou USD. Dans toute autre devise, le moyen de paiement est masqué lors du paiement. Les montants sont envoyés avec 2 décimales ; un total comportant plus de décimales (par exemple dans une boutique en BHD à 3 décimales) est refusé au lieu d'être arrondi.

Compte CorvusPay : vous avez besoin d'un compte marchand CorvusPay. CorvusPay attribue un Store ID et une Secret Key pour chaque boutique, séparément pour la boutique de test et celle de production ; ils sont affichés dans le CorvusPay Merchant Center. La Success URL et la Cancel URL de l'extension doivent y être saisies (voir Configuration).

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

Installation

1. Dans WordPress, allez dans Plugins > Add New > Upload Plugin, choisissez le fichier ZIP de l'extension et cliquez sur Install Now. Vous pouvez aussi téléverser le dossier wcp_corvuspay_gateway dans /wp-content/plugins/ par FTP.

2. Cliquez sur Activate.

3. Ouvrez les réglages : WooCommerce > Settings > Payments > CorvusPay > Manage, ou cliquez sur Settings sous le nom de l'extension dans la page Plugins.

4. Saisissez votre clé de licence VibeFox dans le bloc de licence en haut de la page et cliquez sur Activate.

5. Saisissez le Store ID et la Secret Key de votre boutique de test CorvusPay (et de la boutique de production pour les paiements réels). Copiez la Success URL et la Cancel URL affichées sur la page de réglages dans le CorvusPay Merchant Center, pour la boutique de test et celle de production.

6. Activez Enable/Disable, passez une commande de test, puis décochez Test Mode pour passer en production.

Configuration

Tous les réglages se trouvent sur une seule page : WooCommerce > Settings > Payments > CorvusPay. Au-dessus des champs, la page affiche Test mode is on. tant que le mode test est actif, et vous avertit lorsque la passerelle est activée mais que le Store ID ou la Secret Key du mode actuel est vide (elle est alors masquée lors du paiement tant qu'ils ne sont pas renseignés) et lorsque la devise de la boutique n'est pas prise en charge par CorvusPay.

Général

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

Title: le nom du moyen de paiement que les clients voient lors du paiement. Par défaut : Credit/Debit Card (CorvusPay).

Description: le texte affiché sous le moyen de paiement lors du paiement. Par défaut : Pay securely with your credit or debit card via CorvusPay. En mode test, (Test mode — no real payment is taken.) y est ajouté.

Identifiants de la boutique

Le Store ID et la Secret Key sont attribués par CorvusPay pour chaque boutique (test et production séparément) et sont affichés dans le CorvusPay Merchant Center.

Test Mode: Enable test mode utilise l'environnement de test de CorvusPay (wallet.test.corvuspay.com) ainsi que le Store ID et la Secret Key de test. Par défaut : activé.

Test Store ID: le Store ID numérique de votre boutique de test CorvusPay.

Test Secret Key: la Secret Key de votre boutique de test CorvusPay, utilisée pour les signatures HMAC-SHA256.

Live Store ID: le Store ID numérique de votre boutique de production CorvusPay.

Live Secret Key: la Secret Key de votre boutique de production CorvusPay, utilisée pour les signatures HMAC-SHA256.

Un Store ID ne doit contenir que des chiffres. Si vous saisissez autre chose, une erreur s'affiche et la valeur précédente est conservée. Un paiement est toujours vérifié avec la Secret Key de la boutique dans laquelle il a été effectué ; gardez donc la clé de test renseignée tant que des commandes de test sont encore ouvertes.

Success URL et Cancel URL

Copiez les deux adresses affichées dans cette section dans le CorvusPay Merchant Center, pour la boutique de test et celle de production. CorvusPay y ramène le client après le paiement.

Success URL: ressemble à https://your-site/wc-api/corvuspay_payment_success/. CorvusPay signe cette requête ; la commande n'est marquée payée qu'après vérification de la signature.

Cancel URL: ressemble à https://your-site/wc-api/corvuspay_payment_cancel/. CorvusPay ne la signe pas, elle ne peut donc annuler qu'une commande impayée dotée d'un numéro de commande CorvusPay émis par cette boutique.

Paiement

Transaction Type: la manière dont la carte est débitée.

Sale (capture immediately): la carte est débitée immédiatement (par défaut).

Authorize only (capture in Merchant Center): le montant est seulement réservé. La commande est mise en attente ; vous capturez (finalisez) le paiement dans le CorvusPay Merchant Center, puis passez la commande à En cours.

Payment Page Language: la langue de la page de paiement de CorvusPay. Site language (par défaut) utilise la langue actuelle de votre site lorsque CorvusPay la prend en charge, sinon l'anglais. Vous pouvez aussi choisir le croate, l'anglais, l'allemand, l'italien, le serbe ou le slovène.

Order Status After Payment: le statut de la commande après un paiement Sale réussi. Le statut est défini immédiatement, sans second changement de statut.

Processing (WooCommerce default): par défaut.

Completed: chaque commande payée passe à Terminée.

On Hold: chaque commande payée attend votre vérification manuelle.

Avancé

Logging: Enable debug logging écrit dans WooCommerce > Status > Logs, source wcp_corvuspay_gateway. Les erreurs sont toujours consignées ; les secrets et les données clients, jamais. Par défaut : désactivé.

Delete Data: Delete the plugin settings and log files when the plugin is deleted (uninstalled). La désactivation ne supprime jamais rien. Les données de paiement enregistrées sur les commandes sont toujours conservées. Par défaut : désactivé.

Paiement (checkout)

Le client choisit le moyen de paiement (par défaut Credit/Debit Card (CorvusPay)) et passe la commande. La commande reste En attente de paiement, et la page Pay for order affiche Redirecting to CorvusPay for payment. Please wait... et envoie le formulaire signé à la page de paiement de CorvusPay. Si la redirection ne démarre pas, le client clique sur Pay via CorvusPay. Le total de la commande, la devise, une courte description du panier et les informations de facturation (pour préremplir la page de paiement) sont transmis. Le même numéro de commande CorvusPay est réutilisé tant que le montant ne change pas, et CorvusPay n'accepte pas de second paiement pour lui.

Après le paiement, CorvusPay ramène le client vers la Success URL. La commande n'est marquée payée qu'une fois que CorvusPay l'a confirmé : le numéro de commande CorvusPay doit avoir été émis pour cette commande, la signature doit correspondre à la Secret Key de la boutique dans laquelle le paiement a été effectué, et le montant et la devise doivent correspondre à la commande. Le client arrive ensuite sur la page de commande reçue. Le stock est réduit lorsque le paiement est confirmé, et le panier est vidé sur la page de commande reçue.

Si le client annule sur la page de CorvusPay, la commande impayée est annulée et le client revient au paiement avec son panier intact et le message The CorvusPay payment was cancelled and the order was not paid. Your cart is still here — you can try again or choose another payment method. Si le paiement a été lancé depuis la page Pay for order et que le panier est vide, WooCommerce affiche The CorvusPay payment was cancelled and the order was not paid. sur la page du panier. Si la requête vers la Success URL ne peut pas être vérifiée, le client voit We could not confirm this CorvusPay payment. If your card was charged, please contact the shop — do not pay again. et la commande n'est pas modifiée.

Le moyen de paiement fonctionne avec le paiement classique, le bloc Paiement et la page Pay for order. Il est compatible avec le High-Performance Order Storage (HPOS) de WooCommerce. Les textes sont traduits en croate.

La commande n'est confirmée que lorsque CorvusPay ramène le client vers la Success URL ; il n'y a pas de notifications de serveur à serveur. Si le client ferme le navigateur juste après avoir payé, la commande reste En attente de paiement. L'extension ne propose pas de remboursements, de captures ni d'annulations depuis WooCommerce (l'API serveur de CorvusPay exige un certificat client), ni cartes enregistrées, abonnements, paiements échelonnés, IBAN / PIS ou CorvusWallet.

Commandes

Statuts des commandes

Pending payment: le client a été redirigé vers CorvusPay et n'est pas encore revenu. Si le client a payé mais n'est pas revenu, vérifiez le paiement dans le CorvusPay Merchant Center et terminez la commande manuellement.

Processing, Completed ou On Hold: le paiement Sale a été confirmé. Le statut suit Order Status After Payment. La note de commande indique le numéro de commande CorvusPay, le code d'autorisation et le type de carte. L'ID de transaction de la commande est l'ID de transaction CorvusPay ou, si CorvusPay n'en envoie pas, le numéro de commande CorvusPay, avec lequel le paiement peut être retrouvé dans le Merchant Center.

On hold, autorisée : Authorize only est sélectionné. Capturez le paiement dans le CorvusPay Merchant Center, puis passez la commande à En cours.

On hold, écart de montant/devise : le montant ou la devise payés ne correspondent pas à la commande. N'expédiez pas avant d'avoir vérifié le paiement dans le CorvusPay Merchant Center.

On hold, paiement pour une commande annulée : un paiement réussi est arrivé après l'annulation de la commande, par exemple à cause du délai d'expiration des commandes impayées. Honorez la commande ou remboursez le paiement dans le CorvusPay Merchant Center.

Cancelled: le client a annulé le paiement sur la page de CorvusPay.

Si un autre paiement réussi, différent, arrive pour une commande déjà payée ou clôturée, la commande n'est pas modifiée. Une note vous demande de vérifier le CorvusPay Merchant Center et de rembourser le paiement en double si nécessaire.

Remboursements : les remboursements, captures et annulations depuis WooCommerce ne sont pas pris en charge. Effectuez-les dans le CorvusPay Merchant Center et enregistrez le remboursement manuellement dans WooCommerce.

Clé de licence

L'extension fonctionne avec une clé de licence VibeFox obtenue sur vibefox.net. Le bloc de licence se trouve en haut de WooCommerce > Settings > Payments > CorvusPay. Collez la clé dans License key et cliquez sur Activate. Le bloc affiche le statut, par exemple la date jusqu'à laquelle la licence est active et votre domaine. Utilisez Check now pour revérifier 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 l'emplacement de son domaine. Libérez l'emplacement dans votre compte vibefox.net.

Sans clé active, CorvusPay 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 moyen de paiement, signalé par (unlicensed — visible to admins only), afin que vous puissiez configurer et tester l'extension 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 clients qui reviennent de paiements déjà lancés sont toujours traités.

Lorsqu'une licence expire, l'extension continue de fonctionner, mais les mises à jour et l'assistance nécessitent un renouvellement. Le statut est revérifié automatiquement en arrière-plan.

Dépannage

CorvusPay n'apparaît pas lors du paiement : vérifiez que la licence est active, que Enable/Disable est activé, que le Store ID et la Secret Key du mode actuel sont renseignés (Test Store ID et Test Secret Key en mode test, Live Store ID et Live Secret Key en mode production) et que la devise de la boutique est prise en charge par CorvusPay. La page de réglages affiche un avertissement dans chaque cas.

Le paiement est passé, mais la commande reste En attente de paiement : la Success URL n'est probablement pas saisie dans le CorvusPay Merchant Center, ou la Secret Key dans WooCommerce ne correspond pas à la boutique. Activez Logging et cherchez INVALID signature dans WooCommerce > Status > Logs, source wcp_corvuspay_gateway. La commande reste aussi en attente si le client a fermé le navigateur avant de revenir ; vérifiez alors le paiement dans le Merchant Center et terminez la commande manuellement.

Le client voit We could not confirm this CorvusPay payment : la requête vers la Success URL a été rejetée : des champs obligatoires manquaient, le numéro de commande CorvusPay n'avait pas été émis pour la commande, la Secret Key de cette boutique est vide ou la signature ne correspondait pas. La commande n'est pas modifiée. Le journal indique la raison.

Le client voit This order total cannot be paid via CorvusPay : le total est nul ou comporte plus de 2 décimales.

Le client voit CorvusPay is not configured ou CorvusPay does not accept payments in … : le Store ID ou la Secret Key du mode actuel est manquant, ou la devise de la commande n'est pas prise en charge.

La commande est On hold : lisez la note de commande. Authorize only est sélectionné, le montant ou la devise payés ne correspondaient pas à la commande, ou le paiement est arrivé après l'annulation de la commande.

Le bloc de licence affiche une erreur : suivez le message du 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, l'extension continue de fonctionner avec le dernier statut connu.

Désinstallation

Désactiver l'extension conserve toutes les données. Pour la supprimer, désactivez-la puis supprimez-la depuis la page Plugins. La clé de licence et le statut de licence de cette extension sont toujours supprimés. Les réglages de la passerelle et les fichiers journaux ne sont supprimés que si Delete Data était activé. Sinon, ils sont conservés pour une réinstallation ultérieure. Les données de paiement enregistrées sur les commandes sont toujours conservées. Les commandes existantes conservent leurs notes de paiement et leurs ID de transaction.

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