Aperçu

L’extension de paiement QuantaPay surWordPress.orgajoute une passerelle crypto non custodiale à WooCommerce (caisse classique, blocs, HPOS) et Easy Digital Downloads. Utilisez ce document pour conserver chaque étape au même endroit au lieu de passer d’une FAQ/fichier Readme à l’autre.

Exigences

• WordPress 5.8+ avec WooCommerce 6.0+ ou EDD 3.0+, PHP 7.4+ (8.x recommandé).

• Accès HTTPS sortant à cloud.quantapay.app pour l’API + la vérification du webhook.

• Espace de travail QuantaPay Cloud actif avec clé API et secret de webhook.

• Possibilité d’autoriser les requêtes vers https://yoursite.com/wp-json/quantapay/webhook via WAF/Cloudflare.

Installer l’extension

1) Téléchargez le dernier fichier zip depuis WordPress.org ou votre build interne.

2) Dans l’administration WordPress, allez dans Extensions → Ajouter une nouvelle → Téléverser une extension et téléversez quantapay-payment.zip.

3) Activez « QuantaPay Payment ». Un nouvel écran Réglages → QuantaPay apparaît pour les informations d’identification.

Configurer les informations d’identification et la caisse

• OuvrezRéglages → QuantaPayet collez la clé API Cloud + le secret de webhook, puis enregistrez. La page affiche l’URL du webhook généré (https://yourdomain.com/wp-json/quantapay/webhook).

• WooCommerce : allez dansWooCommerce → Réglages → Paiements → QuantaPay(ou Paiements → Gérer dans la nouvelle interface utilisateur) et activez « Activer ». Choisissez le titre/la description de la caisse et la devise par défaut.

• Configuration rapide : toujours sous Réglages → QuantaPay, vous pouvez synchroniser les adresses de portefeuille, la redirection de remerciement, la copie de caisse localisée et la préférence de journalisation sans modifier PHP.

• Easy Digital Downloads : activez la passerelle sousTéléchargements → Réglages → Passerelles de paiement → QuantaPaypour l’exposer sur les formulaires de caisse EDD.

Liste de contrôle du webhook et du pare-feu

1) Dans QuantaPay Cloud, allez dans Réglages → Webhooks et collez le point de terminaison WordPress affiché dans l’extension. Cliquez sur « Vérifier le secret » pour stocker la signature.

2) Si vous utilisez Cloudflare ou un autre WAF, créez une règle : Nom d’hôte est égal à yourdomain.com ET l’URI contient /wp-json/quantapay, action Autoriser/Ignorer. Vous pouvez également filtrer par l’agent utilisateur ou l’en-tête de signature QuantaPay-Webhook.

3) Empêchez le site de passer en mode « Je suis attaqué » pour ce point de terminaison afin que les rappels signés atteignent WordPress avant que l’extension ne les valide.

Tests et dépannage

• Passez une commande de test de 1 $ dans WooCommerce ou EDD et choisissez QuantaPay. Confirmez que la page hébergée affiche la même devise et le même montant.

• Dans QuantaPay Cloud, marquez la facture comme payée ou envoyez un véritable transfert crypto ; WordPress devrait faire passer la commande de En attente à En traitement/Terminée avec le hachage de la blockchain stocké dans les notes de commande.

• Si les commandes ne sont pas mises à jour, vérifiez la clé API Cloud/le secret de webhook, confirmez que Cloudflare autorise le point de terminaison et consultez wp-content/uploads/quantapay/quantapay-debug.log (n’activez la journalisation que pendant les tests ; les secrets sont expurgés).

• Utilisez le bouton « Tester l’API Cloud » dans Réglages → QuantaPay pour confirmer les informations d’identification et actualiser les instantanés du portefeuille sans créer de nouvelle commande.

Suppression ou réinstallation

La désactivation de l’extension conserve la configuration pour plus tard. Le choix de Supprimer supprime les options stockées et les préférences de journalisation, mais ne touche jamais aux commandes WooCommerce ou EDD. Effectuez toujours une sauvegarde avant de remplacer le connecteur en production.

Liens utiles

•Téléchargement/journal des modifications sur WordPress.org

•Tableau de bord QuantaPay Cloud

•Index des documents

• Assistance :[email protected]

Besoin d’aide ?

Besoin d’aide ? Envoyez un e-mail à[email protected]et mentionnez l’URL du site ainsi que l’ID de la commande.