Overview

The QuantaPay Payment plugin on WordPress.org adds a non-custodial crypto gateway to WooCommerce (classic checkout, Blocks, HPOS) and Easy Digital Downloads. Use this doc to keep every step in one place instead of jumping between FAQ/Readme files.

Requirements

• WordPress 5.8+ with WooCommerce 6.0+ or EDD 3.0+, PHP 7.4+ (8.x recommended).

• Outbound HTTPS access to cloud.quantapay.app for API + Webhook verification.

• Active QuantaPay Cloud workspace with API Key and Webhook Secret.

• Ability to allow requests to https://yoursite.com/wp-json/quantapay/webhook through WAF/Cloudflare.

Install the Plugin

1) Download the latest zip from WordPress.org or your internal build.

2) In WordPress admin go to Plugins → Add New → Upload Plugin and upload quantapay-payment.zip.

3) Activate “QuantaPay Payment.” A new Settings → QuantaPay screen appears for credentials.

Configure Credentials and Checkout

• Open Settings → QuantaPay and paste the Cloud API Key + Webhook Secret, then save. The page shows the generated Webhook URL (https://yourdomain.com/wp-json/quantapay/webhook).

• WooCommerce: go to WooCommerce → Settings → Payments → QuantaPay (or Payments → Manage in the new UI) and toggle “Enable.” Choose the checkout title/description and the default currency.

• Quick Config: still under Settings → QuantaPay you can sync wallet addresses, thank-you redirect, localized checkout copy, and logging preference without editing PHP.

• Easy Digital Downloads: enable the gateway under Downloads → Settings → Payment Gateways → QuantaPay to expose it on EDD checkout forms.

Webhook and Firewall Checklist

1) In QuantaPay Cloud go to Settings → Webhooks and paste the WordPress endpoint shown in the plugin. Click “Verify Secret” to store the signature.

2) If you run Cloudflare or another WAF, create a rule: Hostname equals yourdomain.com AND URI contains /wp-json/quantapay, action Allow/Bypass. Optionally filter by the QuantaPay-Webhook user agent or signature header.

3) Keep the site out of “I’m Under Attack” mode for that endpoint so signed callbacks reach WordPress before the plugin validates them.

Testing and Troubleshooting

• Place a $1 test order in WooCommerce or EDD and choose QuantaPay. Confirm the hosted page displays the same currency and amount.

• In QuantaPay Cloud, mark the invoice as paid or send a real crypto transfer; WordPress should move the order from Pending to Processing/Completed with the blockchain hash stored in order notes.

• If orders do not update, check the Cloud API Key/Webhook Secret, confirm Cloudflare allows the endpoint, and review wp-content/uploads/quantapay/quantapay-debug.log (only enable logging while testing; secrets are redacted).

• Use the “Test Cloud API” button inside Settings → QuantaPay to confirm credentials and refresh wallet snapshots without creating a new order.

Removal or Re-install

Deactivating the plugin keeps configuration for later. Choosing Delete removes stored options and logging preferences but never touches WooCommerce or EDD orders. Always back up before replacing the connector in production.

Helpful Links

• Download / changelog on WordPress.org

• QuantaPay Cloud dashboard

• Docs index

• Support: [email protected]

Need assistance?

Need help? Email [email protected] and mention the site URL plus order ID.