VibeFox CCAvenue for WooCommerce — Aide

Prérequis

WordPress: 5.8 ou ultérieur.

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

PHP: 8.0 ou ultérieur, avec l'extension OpenSSL (utilisée pour chiffrer la requête et déchiffrer la réponse).

Compte CCAvenue : vous avez besoin d'un compte marchand CCAvenue avec un Merchant ID, un code d'accès (Access Code) et une clé de chiffrement (Working Key). Le code d'accès et la clé de chiffrement sont émis pour un domaine de site web ; générez-les donc pour le domaine de cette boutique. CCAvenue utilise les mêmes identifiants pour l'environnement de test ; l'accès au test doit être activé pour votre compte par CCAvenue. L'extension utilise les points d'accès CCAvenue Inde.

Devise : la devise de la commande est transmise telle quelle à CCAvenue. Les comptes CCAvenue acceptent l'INR par défaut ; les autres devises nécessitent le traitement multidevise sur votre compte CCAvenue.

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_ccavenue_payment dans /wp-content/plugins/ par FTP.

2. Cliquez sur Activate.

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

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

5. Saisissez le Merchant ID, l'Access Code et la Working Key de votre espace CCAvenue, puis activez Enable/Disable.

6. Laissez Test mode activé pendant les tests, puis désactivez-le pour recevoir de vrais paiements.

Configuration

Tous les réglages se trouvent sur une seule page : WooCommerce > Settings > Payments > CCAvenue. Au-dessus des champs, la page vous avertit lorsque CCAvenue est activé mais que le Merchant ID, l'Access Code ou la Working Key manque (le moyen de paiement est alors masqué au paiement tant que les trois ne sont pas renseignés), affiche CCAvenue test mode is on: customers are sent to test.ccavenue.com and no real money is taken. tant que le mode test est activé, et vous rappelle le traitement multidevise lorsque la devise de la boutique n'est pas l'INR.

Général

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

Title: le nom du moyen de paiement que voit le client au paiement. Par défaut : CCAvenue.

Description: le texte affiché sous le moyen de paiement au paiement. Par défaut : Pay securely via Credit/Debit card, Net Banking, UPI or Wallet through CCAvenue.

Identifiants API

Connectez-vous à votre espace marchand CCAvenue (M.A.R.S.) et ouvrez Settings > API Keys. Générez le code d'accès et la clé de chiffrement pour le domaine de cette boutique. Les espaces dans les identifiants sont supprimés à l'enregistrement.

Merchant ID: votre Merchant ID CCAvenue, numérique. S'il contient autre chose que des chiffres, une erreur s'affiche à l'enregistrement et la valeur précédemment enregistrée est conservée.

Access Code: le code d'accès de ce site web.

Working Key: la clé de chiffrement (Working Key) de ce site web. Elle chiffre la requête de paiement et est le seul moyen de vérifier la réponse de CCAvenue : gardez-la secrète.

Test mode: Send customers to the CCAvenue test environment (test.ccavenue.com). CCAvenue utilise le même Merchant ID, Access Code et Working Key pour le test et la production ; l'accès au test doit être activé pour votre compte par CCAvenue. En mode test, le paiement affiche TEST MODE: no real transactions will be processed. Par défaut : activé. Désactivez-le pour les paiements réels.

URL de retour

CCAvenue renvoie le client à l'adresse affichée dans cette section. Elle ressemble à https://your-site/wc-api/ccavenue_p_callback/. L'extension transmet cette URL avec chaque paiement ; il n'y a donc rien à configurer dans CCAvenue. Elle doit appartenir au domaine enregistré auprès de CCAvenue.

Avancé

Debug log: Log CCAvenue events écrit les numéros de commande, les références CCAvenue et les statuts dans WooCommerce > Status > Logs, source wcp_ccavenue_payment. Les clés, les données de carte et les adresses ne sont pas journalisées. Par défaut : désactivé.

Delete data on uninstall: Remove the plugin settings, logs and CCAvenue order references when the plugin is deleted. La désactivation de l'extension ne supprime jamais rien. Par défaut : désactivé.

Paiement

Le client choisit le moyen de paiement (par défaut CCAvenue) et passe sa commande. La page Pay for order affiche Thank you for your order. You are being redirected to CCAvenue to complete the payment. et envoie le client vers la page de paiement CCAvenue. Sans JavaScript, le client clique sur Pay via CCAvenue ou Cancel order. Chaque tentative reçoit une nouvelle référence de commande CCAvenue. Le total et la devise de la commande, les coordonnées de facturation et de livraison ainsi que la clé de commande sont transmis dans la requête chiffrée. Les noms et adresses sont nettoyés pour ne garder que les caractères et longueurs acceptés par CCAvenue ; le pays et la région sont transmis sous forme de noms, et le téléphone sous forme de chiffres.

Après le paiement, CCAvenue renvoie le client avec une réponse chiffrée. La commande n'est marquée payée qu'après confirmation de CCAvenue : la réponse doit se déchiffrer avec votre clé de chiffrement (Working Key), appartenir à cette commande et porter le même montant et la même devise que la commande. Le client arrive ensuite sur la page de confirmation de commande.

Si le paiement échoue, le client revient au paiement avec Payment was not completed. Please try again or choose a different payment method. Si le client annule sur la page CCAvenue, le message est Payment was cancelled. You may try again. Si la réponse ne peut pas être vérifiée, le message est We could not confirm the payment result. If your account was charged, please contact us before paying again. Le client peut payer à nouveau une commande non payée, par exemple depuis la page Pay for order. Si le paiement a été lancé depuis la page Pay for order et que le panier est vide, WooCommerce affiche le message sur la page du panier ; une commande échouée peut être payée à nouveau depuis My account > Orders.

Le moyen 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). Les textes destinés aux clients sont traduits en hindi.

Le résultat n'est lu que lors du retour du client depuis CCAvenue : il n'y a ni notifications serveur à serveur, ni requêtes de statut. Si le client ferme le navigateur avant de revenir, la commande reste « En attente de paiement ». L'extension ne gère pas les remboursements depuis WooCommerce, ni les cartes enregistrées, abonnements ou paiements récurrents, ni iframe ou formulaire de carte sur le site, et ne prend pas en charge CCAvenue UAE ni d'autres plateformes régionales.

Commandes

Statuts de commande

Pending payment: le client a été envoyé vers CCAvenue et n'est pas encore revenu. Si le client ne revient pas, vérifiez le paiement dans l'espace CCAvenue.

Processing: le paiement a été confirmé (les commandes ne contenant que des produits virtuels téléchargeables passent à « Terminée », comportement par défaut de WooCommerce). La note de commande indique la référence bancaire, l'identifiant de suivi CCAvenue et le mode de paiement. L'identifiant de transaction de la commande est l'identifiant de suivi CCAvenue.

On hold, amount/currency mismatch: CCAvenue a confirmé un paiement dont le montant ou la devise diffère de la commande, par exemple parce que la commande a été modifiée après le début du paiement par le client, ou parce qu'une offre de réduction CCAvenue a été appliquée. La note indique le montant reçu et le montant attendu. Vérifiez le paiement dans l'espace CCAvenue, puis terminez ou remboursez la commande.

On hold, awaiting bank confirmation: CCAvenue a signalé le paiement comme « Awaited ». La commande n'est jamais marquée comme échouée tant que l'argent peut encore être capturé. Vérifiez-le dans l'espace CCAvenue avant de traiter la commande, puis modifiez le statut manuellement. Une réponse ultérieure avec le même identifiant de suivi est toujours appliquée.

On hold, payment for a cancelled order: le client a payé après l'annulation de la commande. Vérifiez le stock, puis traitez la commande ou remboursez-la.

Cancelled: le client a interrompu le paiement sur la page CCAvenue.

Failed: le paiement a échoué, ou CCAvenue a renvoyé Invalid, Timeout ou un autre statut non réussi. La note indique le message de CCAvenue. Un échec tardif ne modifie jamais une commande payée.

Si un autre paiement réussi arrive pour une commande déjà payée (par exemple depuis deux onglets du navigateur), la commande n'est plus modifiée. Une note vous invite à rembourser le doublon dans l'espace CCAvenue.

Remboursements : les remboursements depuis WooCommerce ne sont pas pris en charge. Remboursez le paiement dans l'espace CCAvenue, puis enregistrez-le 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 > CCAvenue. 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 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, CCAvenue n'est pas affiché aux clients au 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 connectés de la boutique voient toujours le moyen de paiement, marqué (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 Extensions et sur les pages WooCommerce. Les commandes existantes ne sont pas affectées : les clients revenant 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 vérifié à nouveau automatiquement en arrière-plan.

Dépannage

CCAvenue n'apparaît pas au paiement : vérifiez que la licence est active, que Enable/Disable est activé et que les trois identifiants sont renseignés : Merchant ID, Access Code et Working Key. La page des réglages affiche un avertissement lorsqu'un élément manque.

Le paiement a été effectué, mais la commande reste « En attente de paiement » : le client n'est pas revenu de CCAvenue vers votre boutique, par exemple parce qu'il a fermé le navigateur. L'extension n'utilise pas de notifications serveur à serveur. Vérifiez le paiement dans l'espace CCAvenue et mettez la commande à jour manuellement.

Chaque paiement se termine par We could not confirm the payment result : la réponse ne peut pas être déchiffrée. La Working Key est incorrecte, appartient à un autre domaine ou a été copiée avec des caractères en trop. Générez les clés pour le domaine de cette boutique et saisissez-les à nouveau. Activez Debug log et consultez WooCommerce > Status > Logs, source wcp_ccavenue_payment.

CCAvenue affiche une erreur avant la page de paiement : vérifiez que l'Access Code et la Working Key ont été générés pour ce domaine, que l'URL de retour appartient au domaine enregistré auprès de CCAvenue et, en mode test, que CCAvenue a activé l'accès au test pour votre compte. Pour une devise autre que l'INR, le traitement multidevise doit être activé sur votre compte CCAvenue.

Le client voit This payment method is temporarily unavailable : l'un des identifiants manque.

Le client voit Payment gateway error: encryption failed : la requête n'a pas pu être chiffrée. Vérifiez que l'extension OpenSSL de PHP est installée.

Order is On hold after payment: lisez la note de commande. Le montant ou la devise payé était différent de la commande, le paiement attend la confirmation de la banque, ou la commande avait été annulée. Vérifiez le paiement dans l'espace CCAvenue, puis traitez la commande ou remboursez le paiement.

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

Pour les développeurs, le fichier readme indique le filtre ccavenue_p_request_params (modifie les données envoyées à CCAvenue, par exemple merchant_param2 à merchant_param5 ou promo_code ; ne modifiez pas amount, currency, order_id ou merchant_param1) et le filtre ccavenue_p_icon pour l'icône du paiement.

Désinstallation

La désactivation de l'extension conserve toutes les données. Pour la supprimer, désactivez-la puis supprimez-la sur 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, les journaux et les références CCAvenue enregistrées sur les commandes 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.

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