WordPress / WooCommerce
Acceptez les paiements en cryptomonnaies sur votre boutique WooCommerce grâce au plugin officiel QuantaPay Payment.
Acceptez les paiements en cryptomonnaies sur votre boutique WooCommerce en utilisant l’extension officielle QuantaPay Payment.
Prérequis
- WordPress 5.8+
- WooCommerce (n’importe quelle version récente)
- PHP 7.4+ (PHP 8.x recommandé)
- Un compte QuantaPay Cloud (cloud.quantapay.app)
Installation
Depuis le répertoire d’extensions WordPress
- Allez dansExtensions → Ajouterdans votre administration WordPress.
- Recherchez« QuantaPay Payment ».
- Cliquez surInstaller maintenant, puis surActiver.
Installation manuelle
- Téléchargez l’extension depuiswordpress.org/plugins/quantapay-payment.
- Téléversez le dossier
quantapay-paymentvers/wp-content/plugins/. - Activez l’extension dansExtensions → Extensions installées.
Configuration
Étape 1 : Obtenir vos identifiants
Depuis votre tableau de bord QuantaPay Cloud :
- Clé API— Se trouve dansParamètres → Compte
- Clé secrète Webhook— Se trouve dansParamètres → Paiements → Webhook
Étape 2 : Entrer les identifiants dans WordPress
- Accédez au menuQuantaPaydans la barre latérale de votre WordPress.
- Collez votreClé API CloudetClé secrète Webhook.
- Enregistrer les paramètres.
Étape 3 : Configurer l'URL du Webhook
- Le plugin génère une URL de webhook :
https://yoursite.com/wp-json/quantapay/webhook - Copiez cette URL et collez-la dansCloud → Paramètres → Paiements → URL du Webhook.
Étape 4 : Activer la passerelle
Allez dansWooCommerce → Paramètres → Paiements → QuantaPayet activez-la.
Paramètres WooCommerce
Le plugin ajoute des paramètres directement dans la page Paiements de WooCommerce :
| Champ | Description | Par défaut |
|---|---|---|
| Activer/Désactiver | Active ou désactive QuantaPay. | Activé |
| Clé API Cloud | Votre clé API Cloud QuantaPay. | — |
| Clé secrète Webhook | Votre clé secrète Webhook QuantaPay. | — |
| Nom de l'option de paiement | Libellé affiché aux clients lors du paiement. | "Payer avec des cryptos" |
| Description de l'option de paiement | Texte d'aide sous le titre du paiement. | "BTC · ETH · USDT · USDC · BNB — plus de 30 autres cryptomonnaies." |
Configuration rapide
Le menuQuantaPayde la barre latérale fournit un onglet de configuration rapide où vous pouvez gérer :
- Adresses de portefeuille
- Devise par défaut
- URL de redirection de remerciement
- Copie/messages de paiement
Les modifications apportées ici sont synchronisées avec vos paramètres QuantaPay Cloud.
Prise en charge du paiement par blocs
Le plugin prend entièrement en charge le paiement par blocs WooCommerce (le nouveau paiement basé sur React). Les paiements classiques et par blocs partagent la même configuration et affichent la bande d'icônes de cryptomonnaies (BTC, ETH, USDT, USDC, BNB).
Flux de paiement
- Le client sélectionne "Payer avec des cryptos" lors du paiement.
- WooCommerce crée la commande et appelle l'API QuantaPay Checkout Session.
- Le client est redirigé vers la page de paiement QuantaPay.
- Le client sélectionne une cryptomonnaie, scanne le code QR et envoie le paiement.
- Après la confirmation de la blockchain, QuantaPay envoie un webhook à votre site WordPress.
- L'extension met à jour le statut de la commande WooCommerce à « En cours de traitement » ou « Terminée ».
- Le client est redirigé vers la page de remerciement WooCommerce.
Synchronisation du tableau de bord
Depuis la page d'administration QuantaPay dans WordPress, vous pouvez :
- Consulter les soldes de vos portefeuilles
- Parcourir les 100 dernières transactions
- Vérifier les journaux de débogage
- Voir les notifications de sous-paiement et de factures expirées
Sécurité
- Les webhooks sont vérifiés à l'aide de la signature de la clé secrète partagée.
- Les paramètres sensibles (clés API) sont chiffrés au repos.
- Les signatures HMAC-SHA256 protègent la création de session de paiement contre toute falsification.
- Les journaux de débogage masquent automatiquement les secrets.
Configuration Cloudflare / WAF
Si votre site se trouve derrière Cloudflare ou un autre WAF, autorisez le point de terminaison du webhook :
- Créez une règle de pare-feu/WAF correspondant à
L'URI contient /wp-json/quantapay. - Définissez l'action surAutoriserouContourner la sécurité.
- Assurez-vous que le niveau de sécurité n'est pas défini sur « Je suis sous attaque » pour cette URL.
Langues prises en charge
L'extension est livrée avec des traductions pour 9 langues :
- Anglais, chinois (simplifié), espagnol, portugais (brésilien), russe, français, japonais, coréen, allemand
Tarification
QuantaPay facture un forfait fixe de0,8 % par paiement crypto réussi. Pas de frais mensuels ni de frais de retrait.