VibeFox Cardcom for WooCommerce — Aide
Prérequis
WordPress: 6.0 ou ultérieur.
WooCommerce: 8.0 ou ultérieur, installé et activé. L'extension refuse de s'activer sans lui.
PHP: 8.0 ou ultérieur.
HTTPS: votre site doit être accessible depuis Internet en HTTPS, afin que Cardcom puisse envoyer la notification de paiement.
Devise : la devise de la commande doit être ILS, USD, EUR ou GBP. Pour toute autre devise, le moyen de paiement est masqué au paiement.
Compte Cardcom : pour les paiements réels, vous avez besoin d'un compte marchand Cardcom avec un numéro de terminal, un nom d'utilisateur API et un mot de passe API. Les paiements n'ont besoin que du numéro de terminal et du nom d'utilisateur API. Le mot de passe API ne sert qu'aux remboursements depuis WooCommerce. Le mode test fonctionne sans compte Cardcom.
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_cardcom_payment_gateway dans /wp-content/plugins/ par FTP.
2. Cliquez sur Activate.
3. Ouvrez les réglages : WooCommerce > Settings > Payments > Cardcom > 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. Activez Enable/Disable, laissez Test Mode activé et passez une commande de test avec la carte 4580 0000 0000 0000, une date d'expiration future quelconque, CVV 123.
6. Pour les paiements réels, décochez Test Mode et saisissez le Terminal Number, l'API Username et l'API Password que vous avez reçus de Cardcom.
Configuration
Tous les réglages se trouvent sur une seule page : WooCommerce > Settings > Payments > Cardcom. Au-dessus des champs, la page affiche Test mode is on. tant que le mode test est activé. En mode production, elle vous avertit si le numéro de terminal ou le nom d'utilisateur API manque (Cardcom est alors masqué au paiement) et vous rappelle que, sans mot de passe API, les remboursements depuis WooCommerce sont impossibles. Elle vous avertit également lorsque la devise de la boutique n'est pas prise en charge. Si vous enregistrez le mode production sans numéro de terminal ni nom d'utilisateur API, un message d'erreur indique que le moyen de paiement reste masqué au paiement tant qu'ils ne sont pas saisis.
Général
Enable/Disable: Enable Cardcom 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 : Credit Card (Cardcom).
Description: le texte affiché sous le moyen de paiement au paiement. Par défaut : Pay securely with your credit card via Cardcom.
Mode test
Le mode test utilise le terminal de test public de Cardcom 1000 (utilisateur API CardTest1994). Aucun argent réel n'est débité et aucun compte Cardcom n'est nécessaire. Carte de test : 4580 0000 0000 0000, une date d'expiration future quelconque, CVV 123. En mode test, le paiement affiche aussi une ligne rappelant cette carte de test.
Test Mode: Enable test mode (terminal 1000, no real money). Par défaut : activé. Décochez-le pour accepter de vrais paiements avec les identifiants de production ci-dessous. Les remboursements sont toujours envoyés avec les identifiants du mode dans lequel la commande a été payée.
Identifiants de production
Le numéro de terminal, le nom d'utilisateur API et le mot de passe API vous sont fournis par Cardcom avec votre compte marchand : dans l'espace Cardcom, sous les réglages API, ou auprès du support Cardcom. Ces champs ne servent qu'en mode production.
Terminal Number: votre numéro de terminal Cardcom. Il ne doit contenir que des chiffres. Si vous saisissez autre chose, une erreur s'affiche et la valeur précédente est conservée.
API Username: votre nom d'utilisateur API Cardcom (ApiName) pour ce terminal. Les espaces sont supprimés à l'enregistrement.
API Password: votre mot de passe API Cardcom. Il n'est nécessaire que pour les remboursements depuis WooCommerce et est enregistré tel que saisi.
Page de paiement
Cardcom envoie les notifications de paiement (IndicatorUrl) à l'adresse affichée dans cette section. Elle ressemble à https://your-site/wc-api/cardcom_p_callback/. Cette adresse est transmise automatiquement à Cardcom avec chaque paiement, avec le numéro de commande ; il n'y a donc rien à configurer dans Cardcom. Elle doit être accessible depuis Internet.
Operation: ce que fait Cardcom sur la page de paiement.
Max Installments: le nombre maximal de paiements en plusieurs fois que le client peut choisir sur la page Cardcom, de 1 à 36. 1 signifie pas de paiement en plusieurs fois. Par défaut : 1.
Success Order Status: le statut de commande après un paiement confirmé. Le statut est défini immédiatement, sans second changement de statut.
Avancé
Debug log: Log API requests and notifications écrit dans WooCommerce > Status > Logs, source wcp_cardcom_payment_gateway. Les erreurs sont toujours journalisées. Les identifiants, les jetons de carte et les données du titulaire de la carte ne sont jamais écrits. Par défaut : désactivé.
Delete on Uninstall: Delete all plugin data when uninstalling. Lorsqu'elle est activée, la suppression de l'extension supprime définitivement les réglages, les données Cardcom enregistrées sur les commandes et les journaux. Les commandes elles-mêmes sont conservées. Par défaut : désactivé.
Paiement
Le client choisit le moyen de paiement (par défaut Credit Card (Cardcom)) et passe sa commande. L'extension crée une page de paiement Cardcom pour le total de la commande dans la devise de la commande et y envoie le client. La page s'ouvre en hébreu lorsque la langue du site est l'hébreu, sinon en anglais. Les articles de la commande sont transmis à Cardcom sous forme de nom de produit. Le client saisit les coordonnées de sa carte et, si les paiements en plusieurs fois sont autorisés, choisit le nombre de paiements.
Après le paiement, le client revient sur la page de confirmation de commande de votre boutique. La commande n'est marquée payée qu'après confirmation de Cardcom. Cardcom appelle l'adresse de notification, et l'extension ne retient de cet appel que le code de la page de paiement. Elle vérifie que ce code a été émis par votre boutique pour cette commande, puis interroge Cardcom côté serveur pour obtenir le résultat réel. Si la notification arrive en retard, la même vérification est effectuée lorsque le client arrive sur la page de confirmation de commande.
Si le paiement n'est pas finalisé, Cardcom renvoie le client au paiement (ou à la page Pay for order), qui affiche The card payment was not completed. Please try again or choose a different payment method. Un refus de paiement confirmé par Cardcom fait passer la commande à « Échec ». Le client peut payer à nouveau une commande non payée, par exemple depuis la page Pay for order. Un paiement effectué sur une ancienne page de paiement de la même commande est toujours reconnu. Si le client a changé de moyen de paiement mais a payé sur la page Cardcom, le paiement est enregistré et le moyen de paiement est remis sur Cardcom.
Si Cardcom ne parvient pas à ouvrir la page de paiement, le client voit un court message, par exemple Could not connect to Cardcom. Please try again in a moment. ou indiquant que Cardcom n'a pas pu ouvrir la page de paiement, avec le code Cardcom, et peut choisir un autre moyen de paiement.
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).
L'extension ne prend les paiements par carte que sur la page Cardcom. Elle ne gère ni cartes enregistrées ni paiements en un clic, ni abonnements, ne débite pas les jetons enregistrés, n'a pas de réglages de facturation ou de reçu Cardcom, ni Bit, Apple Pay, Google Pay ou PayPal via Cardcom, ni mode iframe, ni transactions avec capture différée. Les pages de paiement abandonnées ne sont pas vérifiées automatiquement.
Commandes et remboursements
Statuts de commande
Pending payment: le client a été envoyé vers Cardcom et n'a pas encore payé, ou Cardcom n'a pas encore confirmé le paiement.
Processing, Completed or On Hold: le paiement a été confirmé. Le statut suit Success Order Status. La note de commande indique la transaction Cardcom et, lorsque Cardcom les transmet, les quatre derniers chiffres de la carte, le numéro de facture et le nombre de paiements. Les paiements de test sont marqués Test mode — no real money was charged. L'identifiant de transaction de la commande est le numéro d'opération Cardcom (deal number).
On hold after payment: Cardcom a confirmé un paiement qui ne correspond pas à la commande, par exemple parce que le total de la commande a été modifié après l'ouverture de la page de paiement, ou parce qu'un autre montant ou une autre devise a été débité. La note de commande l'explique. Comparez le paiement dans l'espace Cardcom avec la commande, puis traitez la commande ou remboursez le paiement.
Failed: Cardcom a refusé le paiement. La note de commande indique le code de réponse Cardcom. Un refus sur une ancienne page de paiement ne fait pas échouer une nouvelle tentative, et un refus tardif ne modifie jamais une commande payée.
Si un second paiement réussi arrive pour une commande déjà payée (par exemple si le client a payé dans deux onglets du navigateur), la commande n'est plus modifiée. Une note vous avertit que le client a pu être débité deux fois et vous invite à le rembourser dans l'espace Cardcom.
Remboursements
Ouvrez la commande, cliquez sur Refund, saisissez le montant et cliquez sur Refund via Credit Card (Cardcom) (le bouton affiche le titre du moyen de paiement). Les remboursements totaux et partiels sont pris en charge, et plusieurs remboursements partiels peuvent être effectués pour une même commande. Le remboursement est envoyé avec les identifiants du mode dans lequel la commande a été payée : les commandes de test sont remboursées sur le terminal de test Cardcom même après le passage en mode production, et les commandes réelles utilisent toujours vos identifiants de production. Les remboursements réels nécessitent l'API Username et l'API Password. Si Cardcom 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 la transaction de remboursement Cardcom et le motif.
Les remboursements effectués dans l'espace Cardcom ne sont pas signalés à la boutique. Si nécessaire, créez un remboursement manuel dans WooCommerce, sans passer par Refund via du moyen de paiement.
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 > Cardcom. 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, Cardcom 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 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 en arrière-plan.
Dépannage
Cardcom n'apparaît pas au paiement : vérifiez que la licence est active, que Enable/Disable est activé et que la devise de la commande est ILS, USD, EUR ou GBP. En mode production, vérifiez que Terminal Number et API Username sont renseignés. 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 » : Cardcom n'a pas pu joindre votre site, par exemple à cause du mode maintenance, d'un pare-feu, d'une protection par mot de passe ou d'un site de développement local. L'adresse de notification doit être accessible depuis Internet en HTTPS. La commande est aussi confirmée lorsque le client revient sur la page de confirmation de commande. Activez Debug log et consultez WooCommerce > Status > Logs, source wcp_cardcom_payment_gateway.
La notification répond Missing or invalid lowprofilecode ou Unknown lowprofilecode for this order : l'appel ne contenait pas de code de page de paiement émis par votre boutique pour cette commande. La commande n'est pas modifiée.
La notification répond Gateway not configured ou Indicator check failed : les identifiants du mode dans lequel la page de paiement a été créée sont manquants, ou Cardcom n'a pas pu être joint pour la vérification. La commande n'est pas modifiée et est vérifiée à nouveau lorsque le client revient dans la boutique.
La notification répond ReturnValue mismatch ou Terminal mismatch : Cardcom a signalé un paiement pour une autre commande ou un autre terminal. La commande n'est pas modifiée. Vérifiez que Terminal Number correspond au terminal de votre compte.
Le client voit Payment error: this currency is not supported by Cardcom. : la devise de la commande n'est pas ILS, USD, EUR ou GBP.
Le client voit Card payment is temporarily unavailable. Please choose another payment method. : le mode production est activé, mais le numéro de terminal ou le nom d'utilisateur API manque.
Le client voit une erreur lors de la validation de la commande : ouvrez les notes de commande ou activez Debug log et consultez le journal. Les problèmes de connexion et les codes d'erreur Cardcom y sont enregistrés.
La commande est « En attente » après le paiement : lisez la note de commande. Le montant ou la devise payé était différent de la commande. Traitez la commande ou remboursez le paiement.
Le remboursement échoue avec API username and API password are required for refunds : saisissez l'API Password (et l'API Username) dans les réglages, puis réessayez.
Le remboursement échoue avec Could not connect to Cardcom : vérifiez l'espace Cardcom avant de réessayer, car le remboursement a peut-être été effectué ou non.
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 cardcom_p_supported_currencies, qui permet d'étendre la liste des devises (n'ajoutez que les devises activées sur votre terminal Cardcom).
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 données Cardcom enregistrées sur les commandes et les journaux ne sont supprimés que si Delete 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.
Cardcom est une marque de son propriétaire respectif. Cette extension n'est ni affiliée à Cardcom ni approuvée par Cardcom.