VibeFox CorvusPay for PrestaShop — Aide

Prérequis

PrestaShop : 8.0 à 9.x.

PHP : 8.0 ou ultérieur. Le module refuse de s'installer sur les versions antérieures de PHP.

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 du panier, le mode de paiement est masqué à l'étape de paiement. Les montants sont envoyés avec 2 décimales ; un total comportant davantage de décimales (par exemple dans une boutique aux prix 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 à chaque boutique, séparément pour la boutique de test et celle de production ; ils sont affichés dans le CorvusPay Merchant Center. Les Success URL et Cancel URL du module 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 le back-office, allez dans Modules > Module Manager et cliquez sur Upload a module. Choisissez le fichier ZIP du module.

2. Une fois le téléversement terminé, cliquez sur Configure, ou retrouvez plus tard VibeFox CorvusPay Gateway dans la liste des modules et cliquez sur Configure.

3. Saisissez votre clé de licence VibeFox dans License key du bloc de licence en haut de la page Configure, puis cliquez sur Activate (voir Clé de licence).

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

5. Activez Enable/Disable et cliquez sur Save. Passez une commande de test, puis désactivez Test Mode pour passer en production.

À l'installation, le module crée le statut de commande CorvusPay payment on hold. PrestaShop associe un nouveau module de paiement aux devises, groupes de clients et pays actifs à ce moment-là. Vous pouvez modifier cela dans Payment > Preferences ; un pays que vous activez plus tard doit y être coché pour le module.

Configuration

Tous les réglages se trouvent sur la page du module : Modules > Module Manager > VibeFox CorvusPay Gateway > Configure. Chaque section possède son propre bouton Save, qui enregistre toute la page. Au-dessus des champs, la page affiche Le mode test est activé. Les paiements sont envoyés à l'environnement de test de CorvusPay : aucun argent réel n'est prélevé. tant que le mode test est activé, et vous avertit lorsque la passerelle est activée mais que le Store ID ou la Secret Key du mode en cours est vide (le mode de paiement est alors masqué à l'étape de paiement tant qu'ils ne sont pas renseignés), ainsi que lorsque la devise par défaut de votre boutique n'est pas prise en charge par CorvusPay.

CorvusPay

Enable/Disable: Enable CorvusPay 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 à l'étape de paiement. C'est aussi le nom du mode de paiement enregistré dans la commande. Par défaut : Credit/Debit Card (CorvusPay).

Description: le texte affiché sous le mode de paiement à l'étape de paiement. Par défaut : Pay securely with your credit or debit card via CorvusPay. En mode test, (Mode test — aucun paiement réel n'est prélevé.) lui 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 affichés dans le CorvusPay Merchant Center.

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é. Désactivez-le pour accepter de vrais paiements sur wallet.corvuspay.com.

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.

Clear saved secrets: cochez Test Secret Key ou Live Secret Key, puis cliquez sur Save pour la supprimer.

Le Store ID ne doit contenir que des chiffres. Si vous saisissez autre chose, la page affiche … ne doit contenir que des chiffres : la valeur précédente a été conservée. et les autres champs sont tout de même enregistrés. Les Secret Key enregistrées ne sont jamais réaffichées : le champ reste vide et affiche Enregistrée : laissez vide pour la conserver. Ne saisissez une nouvelle valeur que pour la modifier. Un paiement est toujours vérifié avec la Secret Key de la boutique dans laquelle il a été lancé ; gardez donc la clé de test renseignée tant que des paiements de test peuvent encore revenir.

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 pour celle de production. CorvusPay y renvoie le client après le paiement. Copiez-les exactement comme la page les affiche ; avec des URL conviviales, elles ressemblent aux exemples ci-dessous, éventuellement avec un code de langue comme /en/.

Paiement

Transaction Type: le mode de débit de la carte.

Payment Page Language: la langue de la page de paiement CorvusPay. Site language (par défaut) utilise la langue actuelle de votre boutique lorsque CorvusPay la prend en charge, sinon l'anglais. Vous pouvez aussi choisir Hrvatski, English, Deutsch, Italiano, Srpski ou Slovenščina.

Order Status After Payment: le statut de commande après un paiement Sale réussi. La commande est créée directement dans ce statut.

Avancé

Logging: écrit des informations de débogage dans logs/corvuspay_p_debug.log.php, dans le dossier du module. Ce fichier ne peut pas être ouvert depuis le web. Les erreurs sont toujours journalisées, même lorsque cette option est désactivée ; les secrets, les signatures et les données clients ne le sont jamais. 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'elle est activée, la désinstallation du module supprime les réglages du module et les fichiers journaux. Les commandes, les données de transaction CorvusPay et le statut de commande sont toujours conservés. Par défaut : désactivé.

Tunnel de commande

À l'étape de paiement, le client choisit le mode de paiement (par défaut Credit/Debit Card (CorvusPay)) et confirme. La page suivante affiche Redirection vers CorvusPay pour le paiement. Veuillez patienter... et envoie le formulaire signé à la page de paiement CorvusPay. Si la redirection ne démarre pas, le client clique sur Pay via CorvusPay ; Back to checkout revient au tunnel de commande. Sont envoyés le total du panier, la devise, une courte description (numéro de panier et nom de la boutique) ainsi que les données de l'adresse de facturation et l'adresse e-mail (pour préremplir la page de paiement). Aucune commande n'existe encore à ce stade. Le même numéro de commande CorvusPay est réutilisé tant que le montant, la devise, le mode et le type de transaction ne changent pas, et CorvusPay n'accepte pas de second paiement pour celui-ci.

Après le paiement, CorvusPay renvoie le client vers la Success URL. La commande n'est marquée payée qu'après confirmation de CorvusPay : le numéro de commande CorvusPay doit avoir été émis par cette boutique, la signature doit correspondre à la Secret Key de la boutique dans laquelle le paiement a été lancé, et le montant et la devise doivent correspondre au panier. La commande est alors créée et le client voit la page de confirmation standard avec Votre paiement CorvusPay a bien été reçu. Pour Authorize only, la page affiche Votre paiement CorvusPay a été autorisé. Le montant sera débité lorsque la boutique traitera votre commande. et, pour une commande en attente, Votre paiement a bien été reçu et est en cours de vérification par la boutique.

Si la commande ne peut pas être créée à ce moment (par exemple, parce qu'une autre requête confirme le même panier), le client voit Votre paiement est en cours de confirmation avec un bouton Check again, qui mène à la confirmation de commande dès que la commande existe. Si la requête vers la Success URL ne peut pas être vérifiée, le client voit Paiement non confirmé et Nous n'avons pas pu confirmer ce paiement CorvusPay. Si votre carte a été débitée, veuillez contacter la boutique — ne payez pas à nouveau. Rien n'est modifié. La Success URL fonctionne même lorsque la boutique est en mode maintenance.

Si le client annule sur la page de CorvusPay, il revient au tunnel de commande avec son panier intact et Le paiement CorvusPay a été annulé et la commande n'a pas été payée. Votre panier est toujours là : vous pouvez réessayer ou choisir un autre mode de paiement.

Si le paiement ne peut pas démarrer, le client reste au tunnel de commande avec un bref message : CorvusPay n'est pas configuré. Veuillez choisir un autre mode de paiement., CorvusPay n'accepte pas les paiements en … ou Ce montant de commande ne peut pas être payé via CorvusPay (il doit être supérieur à zéro, avec au plus 2 décimales). Veuillez choisir un autre mode de paiement.

La commande n'est confirmée que lorsque CorvusPay renvoie 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é, aucune commande n'est créée. Le module ne propose pas de remboursements, captures ni annulations depuis PrestaShop (l'API serveur de CorvusPay exige un certificat client), ni cartes enregistrées, abonnements, paiements échelonnés ou formulaire de carte sur le site.

Commandes

Statuts de commande

Aucune commande pour l'instant : le client a été envoyé vers CorvusPay et n'est pas revenu avec un paiement confirmé. Seul le panier existe. Si le client a payé sans revenir, vérifiez le paiement dans le CorvusPay Merchant Center et créez la commande manuellement.

Payment accepted, Delivered ou CorvusPay payment on hold: le paiement Sale a été confirmé. Le statut suit Order Status After Payment. Le paiement est enregistré avec l'identifiant de transaction CorvusPay ou, si CorvusPay n'en envoie pas, avec le numéro de commande CorvusPay, grâce auquel le paiement peut être retrouvé dans le Merchant Center. Une note privée de la commande indique le numéro de commande CorvusPay, le code d'autorisation et le type de carte.

CorvusPay payment on hold, authorized: Authorize only est sélectionné. Capturez le paiement dans le CorvusPay Merchant Center, puis passez la commande en Payment accepted.

CorvusPay payment on hold, amount/currency mismatch: le montant ou la devise payé ne correspond pas au panier, par exemple parce que le panier a été modifié dans un autre onglet. Le paiement est enregistré avec le montant réellement payé lorsqu'il est dans la devise de la commande. Ne l'expédiez pas avant d'avoir vérifié le paiement dans le CorvusPay Merchant Center.

CorvusPay payment on hold, payment after cancel: un paiement réussi est arrivé pour une tentative de paiement que le client avait annulée. Traitez la commande ou remboursez le paiement dans le CorvusPay Merchant Center.

Si un autre paiement réussi, différent, arrive pour un panier qui a déjà une commande, la commande n'est pas modifiée. Une note vous invite à vérifier le CorvusPay Merchant Center et à rembourser le paiement en double si nécessaire.

Bloc de paiement CorvusPay

La page de la commande affiche un bloc CorvusPay payment avec le numéro de commande CorvusPay, le statut de la tentative de paiement, le type de transaction (Sale ou Authorize only), le montant (et le montant reçu, si CorvusPay l'a signalé), le code d'autorisation, la transaction et le type de carte. Les paiements de test sont marqués Test.

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

Clé de licence

Le module fonctionne avec une clé de licence VibeFox obtenue sur vibefox.net. Le bloc de licence License — VibeFox CorvusPay Gateway est le premier bloc de Modules > Module Manager > VibeFox CorvusPay Gateway > Configure, au-dessus des réglages. Saisissez 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: presta-payment-corvuspay et le lien Gérer les licences et les domaines dans votre compte, qui ouvre votre compte vibefox.net. Seuls les employés disposant de l'autorisation Configure pour le module peuvent modifier la clé. Les textes du bloc suivent la langue du back office (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, le module continue de fonctionner avec le dernier statut connu.

Une clé fonctionne sur un seul domaine : le domaine de la boutique principale, y compris dans une configuration multiboutique. 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, CorvusPay n'est pas affiché aux clients au moment du paiement. Si un paiement est tout de même lancé, le client voit Ce mode de paiement n'est pas disponible. Veuillez en choisir un autre. La vitrine de PrestaShop ne sait pas que vous êtes connecté au back office, donc le mode de paiement est aussi masqué pour vous : vous pouvez configurer le module avant d'acheter une clé, mais pas le tester au paiement. Un rappel apparaît dans Modules > Module Manager, dans l'onglet Alerts. Les commandes existantes ne sont pas affectées : les paiements déjà commencés sont toujours confirmés lorsque le client revient de CorvusPay.

Lorsqu'une licence expire, le module continue de fonctionner, mais les mises à jour et le support nécessitent un renouvellement. Le statut est vérifié à nouveau automatiquement pendant que vous travaillez dans le back office : 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 ou la réinitialisation du module supprime toujours la clé de licence et le statut de licence.

Dépannage

CorvusPay n'apparaît pas au moment du paiement : vérifiez que la licence est active, que Enable/Disable est activé, que le Store ID et la Secret Key du mode en cours 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 du panier est prise en charge par CorvusPay. Dans Payment > Preferences, vérifiez que le module est autorisé pour la devise du panier, le pays du client et le groupe du client.

Le paiement a abouti, mais aucune commande n'a été créée : la Success URL n'est probablement pas saisie dans le CorvusPay Merchant Center, ou la Secret Key de PrestaShop ne correspond pas à la boutique. Recherchez INVALID signature dans le champ Log de la page du module (les erreurs sont toujours journalisées). Aucune commande n'est créée non plus si le client a fermé le navigateur avant de revenir ; vérifiez alors le paiement dans le Merchant Center et créez la commande manuellement.

Le client voit Paiement non confirmé : la requête vers la Success URL a été rejetée : des champs obligatoires manquaient, le numéro de commande CorvusPay n'a pas été émis par cette boutique, la Secret Key de cette boutique est vide ou la signature ne correspondait pas. Rien n'est modifié. Le journal indique la raison.

Le client voit Votre paiement est en cours de confirmation depuis longtemps : la commande n'a pas pu être créée, par exemple parce que le module était désactivé ou que le panier n'est plus valide. Le journal indique la raison ; vérifiez le paiement dans le Merchant Center.

Le client voit Ce montant de commande ne peut pas être payé via CorvusPay : le total est nul ou comporte plus de 2 décimales.

Le client voit CorvusPay n'est pas configuré ou CorvusPay n'accepte pas les paiements en … : le Store ID ou la Secret Key du mode en cours est absent, ou la devise du panier n'est pas prise en charge.

La commande est en CorvusPay payment on hold : lisez les notes privées de la commande. Authorize only est sélectionné, le montant ou la devise payé ne correspondait pas au panier, le paiement est arrivé après l'annulation du client, ou Order Status After Payment est réglé sur le statut en attente.

Désinstallation

Allez dans Modules > Module Manager, ouvrez le menu à côté de VibeFox CorvusPay Gateway et choisissez Uninstall. La clé de licence et le statut de licence de ce module sont toujours supprimés. Si Delete Data est activé, les réglages du module et les fichiers journaux sont supprimés. S'il est désactivé, tous les réglages sont conservés pour une réinstallation ultérieure. Les données de transaction CorvusPay et le statut de commande CorvusPay payment on hold sont toujours conservés, de sorte que le bloc CorvusPay des anciennes commandes réapparaît après une réinstallation. Les commandes existantes conservent leurs notes de paiement et leurs identifiants de transaction.

CorvusPay est une marque commerciale de son propriétaire respectif. Ce module n'est ni affilié à CorvusPay ni approuvé par CorvusPay.