Troubleshooting Guide
Solutions to common issues, debug logging, and frequently asked questions.
Quick Diagnostics
Run through this checklist to identify common issues:
Common Issues
Payment method not showing at checkout
If PayCoinPro doesn't appear as a payment option:
- 1.Go to WooCommerce → Settings → Payments
- 2.Make sure PayCoinPro is toggled ON
- 3.Check that you've entered a valid API key
- 4.Clear any caching plugins (WP Super Cache, W3 Total Cache, etc.)
- 5.Test in an incognito browser window
Orders not updating after payment
If customers pay but orders stay in "Pending" status:
- 1.Verify your webhook URL is correct in PayCoinPro dashboard
- 2.Make sure the webhook secret matches exactly
- 3.Test webhook delivery using the "Send Test" button
- 4.Check for firewall rules blocking incoming POST requests
- 5.Review debug logs in WooCommerce → Status → Logs
Invalid API key error
If you see "Invalid API key" or authentication errors:
- 1.Copy the API key again from your PayCoinPro dashboard
- 2.Make sure there are no extra spaces before/after the key
- 3.Check that the key starts with
ck_ - 4.Try generating a new API key if the issue persists
Webhook signature verification failed
If webhooks are rejected with signature errors:
- 1.Copy the webhook secret from PayCoinPro dashboard
- 2.Paste it exactly into the plugin's Webhook Secret field
- 3.Secrets are case-sensitive - copy carefully
- 4.If issues persist, regenerate the webhook secret
Debug Logging
Enable Debug Mode
- 1Go to WooCommerce → Settings → Payments → PayCoinPro → Manage
- 2Check the Enable Debug Logging option
- 3Save changes
View Logs
- 1Go to WooCommerce → Status → Logs
- 2Select
paycoinpro-*from the dropdown - 3Click View to see log contents
Security: Disable debug logging in production. Logs may contain sensitive information.
Frequently Asked Questions
How long do customers have to complete payment?
By default, invoices expire after 60 minutes. You can customize this in the plugin settings under "Invoice Expiry Time". After expiry, customers need to create a new order to get a fresh payment address.
What happens if a customer underpays?
If a customer sends less than the expected amount, the order will be marked as "Underpaid" with a note showing the difference. You can configure how to handle underpayments in the plugin settings - either hold the order for manual review or automatically refund.
Which cryptocurrencies are supported?
PayCoinPro supports 24+ cryptocurrencies including Bitcoin (BTC), Ethereum (ETH), USDT (on multiple networks), USDC, BNB, Solana, Polygon MATIC, and more. Customers choose their preferred cryptocurrency at checkout.
How do I test the plugin without real payments?
Enable "Test Mode" in the plugin settings. This creates invoices without generating real blockchain addresses. You can simulate payment completion from your PayCoinPro dashboard to test the full checkout flow.
Can I use this with other WooCommerce plugins?
Yes! PayCoinPro is compatible with most WooCommerce extensions including subscriptions, memberships, and booking plugins. If you encounter compatibility issues, please contact our support team.
How are refunds handled?
Cryptocurrency refunds must be processed manually through your PayCoinPro dashboard. Initiate a refund from the order page, then send the refund amount to the customer's wallet address. WooCommerce will be updated once the refund is processed.
Is the plugin compatible with multisite?
Yes, the plugin works with WordPress Multisite. Each site needs its own API key configured. Network-wide activation is supported.
Still Need Help?
Can't find what you're looking for? Our support team is here to help you get up and running.