WordPress / WooCommerce

Accept cryptocurrency payments on your WooCommerce store using the official QuantaPay Payment plugin.

Requirements

• WordPress 5.8+
• WooCommerce (any recent version)
• PHP 7.4+ (PHP 8.x recommended)
• A QuantaPay Cloud account (cloud.quantapay.app)

Installation

From WordPress Plugin Directory

1. Go to Plugins → Add New in your WordPress admin.
2. Search for "QuantaPay Payment".
3. Click Install Now, then Activate.

Manual Installation

1. Download the plugin from wordpress.org/plugins/quantapay-payment.
2. Upload the quantapay-payment folder to /wp-content/plugins/.
3. Activate the plugin in Plugins → Installed Plugins.

Configuration

Step 1: Get Your Credentials

From your QuantaPay Cloud dashboard:

1. API Key — Found in Settings → Account
2. Webhook Secret Key — Found in Settings → Payments → Webhook

Step 2: Enter Credentials in WordPress

1. Navigate to the QuantaPay menu in your WordPress sidebar.
2. Paste your Cloud API Key and Webhook Secret Key.
3. Save settings.

Step 3: Configure Webhook URL

1. The plugin generates a webhook URL: https://yoursite.com/wp-json/quantapay/webhook
2. Copy this URL and paste it into Cloud → Settings → Payments → Webhook URL.

Step 4: Enable the Gateway

Go to WooCommerce → Settings → Payments → QuantaPay and enable it.

WooCommerce Settings

The plugin adds settings directly in the WooCommerce Payments page:

Quick Config

The QuantaPay sidebar menu provides a Quick Configuration tab where you can manage:

• Wallet addresses
• Default currency
• Thank-you redirect URL
• Checkout copy/messaging

Changes made here sync with your QuantaPay Cloud settings.

Block Checkout Support

The plugin fully supports WooCommerce Block Checkout (the new React-based checkout). Both Classic and Block checkout share the same configuration and display the cryptocurrency icon strip (BTC, ETH, USDT, USDC, BNB).

Payment Flow

1. Customer selects "Pay with crypto" at checkout.
2. WooCommerce creates the order and calls the QuantaPay Checkout Session API.
3. Customer is redirected to the QuantaPay payment page.
4. Customer selects cryptocurrency, scans QR code, and sends payment.
5. After blockchain confirmation, QuantaPay sends a webhook to your WordPress site.
6. The plugin updates the WooCommerce order status to "Processing" or "Completed".
7. Customer is redirected to the WooCommerce thank-you page.

Dashboard Sync

From the QuantaPay admin page in WordPress, you can:

• View your wallet balances
• Browse the latest 100 transactions
• Check debug logs
• See underpayment and expired invoice notifications

Security

• Webhooks are verified using the shared secret key signature.
• Sensitive settings (API keys) are encrypted at rest.
• HMAC-SHA256 signatures protect checkout session creation from tampering.
• Debug logs automatically redact secrets.

Cloudflare / WAF Configuration

If your site is behind Cloudflare or another WAF, allow the webhook endpoint:

1. Create a Firewall/WAF rule matching URI contains /wp-json/quantapay.
2. Set the action to Allow or Bypass Security.
3. Ensure Security Level isn't set to "I'm Under Attack" for that URL.

Supported Languages

The plugin ships with translations for 9 languages:

• English, Chinese (Simplified), Spanish, Portuguese (Brazilian), Russian, French, Japanese, Korean, German

Pricing

QuantaPay charges a flat 0.8% per successful crypto payment. No monthly fees or withdrawal charges.