Frequently asked questions

Everything about Paddle for WooCommerce — setup, pricing, webhooks, security.

General

What is the Paddle for WooCommerce plugin? +

PimiPay is a WooCommerce Paddle plugin that integrates Paddle Billing with your store. It handles product synchronization, overlay checkout, real-time webhooks, and automatic order management — so you can accept payments worldwide with minimal setup.

Do I need a Paddle account? +

Yes, you need an active Paddle Billing account. You can sign up for free at paddle.com. The plugin works with both sandbox (staging) and production environments for easy testing before going live.

What are the system requirements? +

- PHP 7.4 or higher - WordPress 6.9 or higher - WooCommerce 10.6 or higher - An active Paddle Billing account - SSL certificate (HTTPS required for webhooks)

Is it compatible with WooCommerce HPOS? +

Yes. The plugin fully supports WooCommerce High-Performance Order Storage (HPOS), which is the modern order storage architecture. Your store is future-proof whether you use HPOS or the legacy post-based order storage.

Can I use it alongside other payment gateways? +

Yes. PimiPay for Paddle registers as a standard WooCommerce payment gateway. Customers can choose between Paddle and any other active gateways (Stripe, PayPal, etc.) at checkout.

Products & Checkout

Does this work with variable products? +

Yes. The plugin fully supports both simple and variable products. Each variation is synced as a separate price in Paddle, allowing customers to purchase any variation through the checkout modal.

How does the product sync work? +

Go to your WooCommerce Products page in WordPress Admin, hover over any product, and click "Sync with Paddle". The plugin creates the product and all its variations in Paddle automatically, storing the Paddle IDs as product meta for future reference.

Can I sync products in bulk? +

You can sync products one at a time from the products list page using the "Sync with Paddle" action link. Each sync creates or updates the product and all its variations in Paddle.

How does the checkout work? +

When a customer places an order and selects Paddle as the payment method, they are redirected to the order confirmation page where a Paddle overlay checkout modal appears automatically. The modal is pre-filled with the customer's email and name. After successful payment, the order status is updated via webhooks.

What payment methods does Paddle support? +

Paddle supports credit and debit cards, PayPal, Apple Pay, Google Pay, wire transfers, and many local payment methods depending on the customer's region. PimiPay inherits all payment methods available in your Paddle account — no extra configuration needed.

Does Paddle handle sales tax? +

Yes. Paddle acts as a Merchant of Record (MoR), which means they handle sales tax, VAT, and GST calculations and remittance automatically in supported regions. You don't need to worry about tax compliance — Paddle takes care of it.

Does it support subscriptions? +

Subscription support through Paddle Billing is on the roadmap and planned for a future release. Currently the plugin handles one-time payments. Stay tuned for updates.

What is cart recovery? +

Cart recovery handles Paddle's recovery email links. If a customer abandons checkout, Paddle can send a recovery email. When the customer clicks the link, they are brought back to their pending order on your site where they can complete the payment.

Webhooks & Security

Are webhooks required? +

Webhooks are highly recommended for automatic order status updates. Without webhooks, orders can still be verified on the thank you page, but you won't get real-time updates for refunds, cancellations, or other payment events. The plugin makes webhook setup easy.

How are webhooks verified? +

All incoming webhook notifications from Paddle are verified using HMAC SHA256 signature verification. The plugin checks the signature header against your webhook secret to ensure the notification is authentic and hasn't been tampered with.

Is my data secure? +

Security is a top priority. Webhook notifications are verified with HMAC SHA256 signatures. All transactions are validated server-side before order completion — the plugin checks that payment amounts match order totals and verifies transaction status. API keys are stored securely in WordPress options.

What happens if a webhook fails? +

Paddle automatically retries failed webhook deliveries. The plugin logs all webhook events when debug logging is enabled, making it easy to diagnose issues from the WooCommerce Status page.

How does transaction validation work? +

After a customer completes payment, the plugin verifies the transaction server-side with the Paddle API. It checks that the transaction status is valid, the payment amount matches the order total, and the custom data (order ID) matches. Only after all checks pass is the order marked as completed.

Setup & Configuration

How do I install the plugin? +

Download the plugin zip file, upload it via WordPress Admin (Plugins → Add New → Upload), or extract it to wp-content/plugins/. Activate the plugin from the Plugins page.

What Paddle credentials do I need? +

You need three things from your Paddle dashboard: - API Key — For server-side API calls (product sync, transaction verification) - Client Token — For the frontend checkout overlay - Webhook Secret — For verifying webhook signatures You can configure separate credentials for sandbox and production environments.

Can I test before going live? +

Yes. The plugin supports separate staging (sandbox) and production configurations. Enter your Paddle sandbox credentials, test the full checkout flow with test card numbers, and switch to production when you're ready. No code changes needed.

How do I enable debug logging? +

Enable the "Debug Log" option in the plugin's WooCommerce payment gateway settings. Logs are written to the standard WooCommerce log and can be viewed from WooCommerce → Status → Logs. Disable logging in production for optimal performance.

Pricing & Licensing

How much does the plugin cost? +

Single Site — $59/year (1 domain). Includes every feature, premium email support, and 1 year of updates.

Are there any additional fees? +

The plugin license is the only cost from PimiPay. Paddle charges its own transaction fees (typically 5% + $0.50 per transaction) which are separate from the plugin license. Check Paddle's pricing page for current rates.

What happens after purchase? +

You receive a download link and license key via email. Download the plugin zip, install it on your WordPress site, and activate your license in the plugin settings. Your license key enables automatic updates for 1 year.

What happens when my license expires? +

The plugin continues to work indefinitely after your license expires. You just won't receive new updates or support until you renew. Renewal is at the same rate.

Can I use this on multiple sites? +

The Single Site license is valid for one domain. If you need licenses for additional sites, purchase a separate license for each. Contact support@pimipay.com for volume pricing.

Do you offer refunds? +

Yes, we offer a 30-day money-back guarantee. If you're not satisfied for any reason, contact us at support@pimipay.com within 30 days of purchase for a full refund.

Is there a free trial? +

There is no free trial at this time. You can review the full feature set on the homepage before purchasing. We offer a 30-day money-back guarantee if you're not satisfied.

Support & Updates

How do I get support? +

All license holders get access to premium email support at support@pimipay.com. We typically respond within 24 hours on business days.

How do automatic updates work? +

The plugin integrates with the WordPress update system. When a new version is available, you'll see a notification in your WordPress admin and can update with one click — just like any other plugin. An active license key is required to receive updates.

Where can I find the documentation? +

Documentation is available at pimipay.com/docs. It covers installation, configuration, product sync, webhooks, and troubleshooting.

Where can I see the changelog? +

The full changelog is available at pimipay.com/changelog. Each release includes details about new features, improvements, and bug fixes.