On this page, we address common troubleshooting steps for issues related to the WooCommerce payment gateway plugin. Our WooCommerce payment gateway plugin is rigorously tested to ensure seamless automatic order processing after setup. However, conflicts with other plugins or misconfigured settings may cause issues. This guide will help you resolve them. If needed, our support team is available to assist you for free.
Payment Gateway Activated but Not Visible on Checkout Page
By default, WooCommerce enables blocks on new installations, which can hide or disrupt payment methods, displaying the error message: “There are no payment methods available. This may be an error on our side. Please contact us if you need any help placing your order.”
Follow these steps to fix this issue by disabling blocks.
Paid Orders Not Marked as Paid (IPN Issue)
While our payment gateway plugin is designed to automatically mark orders as paid after payment, conflicts with poorly coded plugins or misconfigurations may result in orders remaining in a “pending” state. This process is called Instant Payment Notification (IPN).
Each order includes a unique, password-protected callback URL. This URL ensures that only our system can mark orders as paid. If this process fails, follow these steps:
- Navigate to wp-admin >> WooCommerce >> Orders.
- Open an order to review custom meta fields. You’ll find important information such as tracking addresses and callback URLs.
- Use the encrypted tracking address to verify payments through our Payment Tracking Tool.
- Analyze the callback URL to identify site issues preventing automated status updates.
Investigating the Callback URL
Paste the callback URL in your browser and observe its behavior. The most common issue is CAPTCHA prompts, which block our bot from confirming payments.
Fixing CAPTCHA Blocking IPN
If CAPTCHA appears, you need to either whitelist our IP address or disable CAPTCHA for callback URLs. CAPTCHA prompts often stem from firewall plugins or Cloudflare settings. To fix this in Cloudflare, configure page rules to bypass CAPTCHA for callback URLs:
Resolving Invalid Nonce Errors
If CAPTCHA is not the issue, and callback URLs still fail, check for “invalid nonce” errors. This may occur due to corrupted nonce values caused by other plugins or caching issues.
While nonce ensures security, you can disable it to bypass validation for troubleshooting. To do so:
Disabling Nonce Verification
Edit the relevant provider file in wp-content/plugins/instant-payment-gateway/includes to remove nonce verification lines:
Invoice Failure Errors
If you encounter an error like “Invoice failed, please select another payment provider or contact support”, it may be due to:
- The order amount being less than the minimum allowed by the provider.
- An unsupported store currency for the selected provider.
Other Common Errors
Errors related to invalid wallet addresses or leaving the wallet address field empty may include:
- “Payment could not be processed due to incorrect payout wallet settings, please contact website admin.”
- “Payment could not be processed, please try again (wallet address error).”
Ensure your USDC (Polygon) wallet address is correctly configured in the admin settings. For unresolved issues, contact our support team.