Skip to main content
This guide covers the most common issues you might encounter when using CeyPay and how to resolve them.

​
Installation Issues

Symptoms: After installation, CeyPay doesn’t appear in WooCommerce > Settings > Payments.Solutions:
  1. Ensure WooCommerce is installed and activated
  2. Check that CeyPay plugin is activated in Plugins > Installed Plugins
  3. Clear any caching plugins or server cache
  4. Verify PHP version is 7.4 or higher in Tools > Site Health
// Check PHP version
phpinfo(); // Should show PHP 7.4+
Symptoms: Error message when trying to activate the plugin.Common causes:
  • PHP version too low (requires 7.4+)
  • WooCommerce not active
  • File permissions issue
Solution: Check the error message for specifics. Ensure all requirements are met before activating.
Symptoms: Site crashes or behaves unexpectedly after installing CeyPay.Solution:
  1. Deactivate all plugins except WooCommerce and CeyPay
  2. Test if the issue persists
  3. Reactivate plugins one by one to identify the conflict
  4. Contact support with the conflicting plugin name

​
Checkout Issues

Symptoms: CeyPay doesn’t appear as a payment option on the checkout page.Possible causes:
  1. Gateway disabled - Enable it in WooCommerce > Settings > Payments
  2. Test Mode enabled - Only admins see CeyPay in test mode; log in as admin
  3. Missing credentials - Configure Merchant ID and Webhook Secret
  4. Currency not supported - Verify your store currency is supported
Quick check:
  • Look for “Action Needed” badge next to CeyPay in payment settings
  • Review the admin notice at the top of WordPress admin pages
Symptoms: Clicking “Place Order” doesn’t open the payment modal.Solutions:
  1. Check browser console for JavaScript errors (F12 > Console)
  2. Ensure jQuery is loaded (required by WooCommerce)
  3. Try a different browser or incognito mode
  4. Disable other JavaScript-heavy plugins temporarily
  5. Check if a page builder is interfering with checkout
Console command to verify:
// Check if CeyPay scripts are loaded
console.log(typeof ceypay_params);
Symptoms: Provider selection works, but no QR code appears.Causes:
  • API connection failure
  • Invalid Merchant ID
  • Server cannot make outbound HTTPS requests
Solutions:
  1. Verify your Merchant ID is correct
  2. Check if your server can reach external APIs
  3. Review WooCommerce logs for API errors
  4. Contact support if the issue persists
Symptoms: Error message about invalid parameters when generating QR code.Solution: This usually indicates missing order data. Ensure:
  • All required checkout fields are filled
  • The cart contains valid products
  • The currency is supported

​
Webhook Issues

Symptoms: Customer completes payment, but order status doesn’t update.Causes:
  1. Webhooks not reaching your server
  2. Signature verification failing
  3. Site not publicly accessible
Diagnostic steps:
  1. Check WooCommerce logs for webhook entries
  2. Verify your site is accessible from the internet
  3. Ensure SSL certificate is valid
  4. Confirm webhook secret matches exactly
Temporary workaround: The plugin includes status polling, so the customer should see success if they keep the modal open. The webhook will update the order for admin visibility.
Symptoms: Logs show “Webhook signature mismatch” errors.Solution:
  1. Copy the Webhook Secret directly from your CeyPay dashboard
  2. Paste it into CeyPay settings without any extra spaces
  3. Save settings and test again
The webhook secret is case-sensitive. Copy it exactly as shown.
Symptoms: No webhook entries in logs, even after successful test payments.Checklist:
  • Site has valid SSL certificate (HTTPS required)
  • Site is not on localhost (use ngrok for local testing)
  • Firewall allows incoming POST requests
  • .htaccess or server config doesn’t block the API endpoint
  • The webhook URL is correctly registered in CeyPay dashboard
Test your endpoint:
curl -X POST https://yoursite.com/?wc-api=WC_Gateway_CeyPay
# Should return 400 (Bad Request) - this means the endpoint is reachable

​
Order Issues

Symptoms: Multiple orders created for a single payment.Cause: Customer clicking “Place Order” multiple times.Solutions:
  1. The plugin should prevent this, but if it occurs:
  2. Check for JavaScript errors that might prevent modal from opening
  3. Ensure the checkout page doesn’t have duplicate form submissions
  4. Review any caching plugin settings
Symptoms: Order shows as Processing, but no payment in crypto wallet.Cause: This should only happen in Test Mode with simulated payments.Solution:
  1. Verify Test Mode is disabled for production
  2. Check that production Merchant ID is configured
  3. Review CeyPay dashboard for transaction records
  4. Contact CeyPay support with order details
Symptoms: The payment amount in the modal doesn’t match the order total.Cause: Currency conversion or rounding issues.Solution:
  1. Verify your store currency settings
  2. Check if any plugins modify order totals
  3. The USDT amount may differ due to exchange rates

​
WooCommerce Blocks Issues

Symptoms: CeyPay appears but doesn’t function correctly with the Checkout Block.Solutions:
  1. Ensure WooCommerce Blocks is up to date
  2. Check browser console for JavaScript errors
  3. Verify the Checkout Block is properly configured
  4. Try switching to classic checkout temporarily to isolate the issue

​
Mobile Issues

​
Debug Mode

For persistent issues, enable debug logging:
1

Enable Test Mode

Go to WooCommerce > Settings > Payments > CeyPay and enable Test Mode.
2

Reproduce the Issue

Attempt the action that’s causing problems.
3

Review Logs

Navigate to WooCommerce > Status > Logs and find the ceypay-* log file.
4

Analyze Entries

Look for error messages, failed API calls, or signature mismatches.

​
Getting Support

If you can’t resolve an issue using this guide:

Email Support

Contact our support team directly for personalized assistance.

GitHub Issues

Report bugs or request features on our GitHub repository.

​
Information to Include

When contacting support, please provide:
  • WordPress version
  • WooCommerce version
  • CeyPay plugin version
  • PHP version
  • Theme name and version
  • Relevant log entries
  • Steps to reproduce the issue
  • Screenshots if applicable
You can find version information at WooCommerce > Status > System Status.