WooCommerce
Installez et configurez le plugin Cardencer Checkout pour WordPress et WooCommerce : cartes, Apple Pay, Google Pay, remboursements et synchronisation des commandes.
Cardencer Checkout est un plugin unique pour WordPress et WooCommerce. Il ajoute un formulaire de paiement intégré à votre page de commande (blocs de commande compris), accepte les cartes, Apple Pay et Google Pay, et synchronise les commandes WooCommerce grâce à des webhooks signés. Les remboursements et les captures manuelles s'effectuent depuis l'administration WordPress.
Prérequis#
- WordPress 4.0 ou version ultérieure (testé jusqu'à la 6.5)
- WooCommerce 4.0 ou version ultérieure (testé jusqu'à la 8.6)
- PHP 8.0 ou version ultérieure
- HTTPS activé sur votre boutique
1. Installez le plugin#
- Demandez au support Cardencer la dernière version du package Cardencer Checkout (
.zip). - Dans WordPress, rendez-vous dans Extensions → Ajouter → Téléverser une extension, choisissez le fichier et cliquez sur Installer maintenant.
- Cliquez sur Activer.
2. Récupérez vos clés#
Sur le dashboard, ouvrez API keys et copiez :
- votre clé API secrète (
snd_…pour les tests,prd_…en production), - votre clé publiable (
pk_snd_…oupk_prd_…), - votre ID de profil,
- votre clé de signature des webhooks.
3. Configurez la passerelle#
Rendez-vous dans WooCommerce → Réglages → Paiements → Cardencer et renseignez :
| Paramètre | Valeur |
|---|---|
| Enable/Disable | Coché. |
| API key | Votre clé secrète complète. Les valeurs masquées contenant ******** ne fonctionnent pas. La clé reste sur votre serveur et n'est jamais envoyée au navigateur. |
| Publishable key | Votre clé publiable. Associez une clé publiable de test à une clé secrète de test. |
| Business Profile ID | Votre ID de profil. |
| Webhook HMAC key | Votre clé de signature des webhooks. |
| Enable Webhook | Coché. |
| Capture Method | Automatic pour débiter lors de la commande, ou Manual pour autoriser puis capturer plus tard depuis l'écran de la commande. |
| Enable Saved Payment Methods | Permet aux clients connectés de payer avec une carte enregistrée. |
| Show Card Form Always | Ouvre le formulaire de carte par défaut. |
| Hold Order on Processing Payments | Maintient le stock réservé tant qu'un paiement est en cours de traitement. |
En production, laissez vides API base URL et SDK loader URL sous Advanced service endpoints. Pour vos tests en sandbox, définissez API base URL sur https://sandbox.cardencer.com.
Cliquez sur Enregistrer les modifications.
4. Enregistrez l'URL de webhook#
La page de réglages affiche l'URL de webhook du plugin sous Enable Webhook. Envoyez-la au support Cardencer en précisant sandbox ou production, afin qu'elle soit enregistrée sur votre profil d'entreprise. Sans elle, les commandes ne sont mises à jour que lorsque le client revient sur votre boutique.
Le plugin vérifie X-Webhook-Signature-512 à chaque envoi et rejette les requêtes non signées ou invalides. Les événements en double sont ignorés, commande par commande.
5. Testez un paiement#
- Avec vos clés sandbox, passez une commande sur votre boutique.
- Payez avec
4242 4242 4242 4242, n'importe quelle date future et n'importe quel CVC. - La commande passe à l'état En cours et le paiement apparaît sur le dashboard Cardencer.
Essayez 4000 0038 0000 0446 pour voir 3D Secure, et 4000 0000 0000 0002 pour un refus. Consultez Environnement de test et cartes de test.
Opérations courantes#
- Remboursements : ouvrez la commande, cliquez sur Rembourser, saisissez le montant et confirmez. Le remboursement est envoyé à Cardencer et la commande est mise à jour.
- Capture manuelle : avec Capture Method réglé sur Manual, capturez les commandes autorisées depuis l'écran de la commande dès l'expédition.
- Synchronisation : vous pouvez resynchroniser manuellement le statut de paiement d'une commande depuis l'écran de la commande.
- Apparence : ajustez l'objet appearance du formulaire de paiement et choisissez une disposition en onglets ou en accordéon dans les réglages du plugin. Consultez Personnalisation pour les variables disponibles.
Passez en production#
Remplacez les clés par votre clé secrète prd_, votre clé publiable pk_prd_ et votre clé de signature des webhooks de production, supprimez la surcharge d'API base URL et enregistrez votre URL de webhook pour la production. Consultez Passer en production.