Errors and Solutions

This guide contains the most common errors when using the WPify Woo GoPay plugin and steps to resolve them.

Payment Errors

Order stays in "Pending payment" after successful payment in GoPay

Cause: The payment notification from GoPay did not reach your website, or the notification was received but the order status update failed.

Solution:

1. Check that your website is publicly accessible (not behind a password or IP restriction)
2. Check the logs at WPify → WPify Logs for the wpify-woo-gopay plugin — look for notification entries and possible errors
3. Verify that no security plugin or firewall is blocking requests to /wp-json/wpify-woo/v1/gopay
4. If using a caching plugin, make sure it does not cache REST API endpoints
5. Try visiting the order detail page — the plugin checks payment status when the order is viewed

Payment methods are empty in gateway settings

Cause: The plugin could not retrieve available payment instruments from the GoPay API.

Solution:

1. Check that your API credentials (Go ID, Client ID, Client Secret) are correct
2. Verify the environment setting (Test/Live) matches your credentials
3. Save the settings again — the plugin fetches available methods on save
4. Check the logs for API communication errors
5. Ensure your GoPay merchant account is active and properly configured

Payment page shows an error or does not load

Cause: Invalid API credentials or wrong environment setting.

Solution:

1. Verify the Go ID, Client ID, and Client Secret in WPify → WPify Woo GoPay
2. Make sure you are using the correct credentials for the selected environment (Test vs. Live)
3. Check that your GoPay account is active
4. Review the logs for API error responses

Configuration Errors

GoPay gateway does not appear in WooCommerce Payments

Cause: The plugin is not activated or the license is not valid.

Solution:

1. Go to Plugins and verify that WPify Woo GoPay is activated
2. Go to WPify → WPify Woo GoPay and check the license status
3. Make sure you have entered the API credentials (Go ID, Client ID, Client Secret)
4. Go to WooCommerce → Settings → Payments and enable the GoPay gateway

Recurring payment fails

Cause: Your GoPay merchant account is not configured for recurring (on-demand) payments, or the initial payment was not set up for recurrence.

Solution:

1. Contact GoPay support to verify that recurring payments are enabled on your merchant account
2. Make sure Enable recurring payments is checked in the gateway settings
3. Verify that the WooCommerce Subscriptions plugin is active
4. Check that the initial subscription order was paid successfully via GoPay
5. Review the logs for error messages from GoPay API

Refund fails

Cause: The order does not have a valid GoPay transaction ID, or the payment state does not allow refunds.

Solution:

1. Verify that the order has a _gopay_id meta value — open the order and check the metadata
2. Ensure the payment was completed successfully before attempting a refund
3. Check if the refund amount does not exceed the original payment amount
4. Review the logs for specific error messages from GoPay
5. Try performing the refund directly in the GoPay administration panel

Apple Pay not showing at checkout

Cause: Apple Pay is only available on supported Apple devices (iPhone, iPad, Mac with Touch ID/Face ID) using the Safari browser.

Solution:

1. Verify you are testing on a compatible Apple device with Safari
2. Make sure Apple Pay is set up on the device (at least one card added to Wallet)
3. Check that the GoPay – Apple Pay gateway is enabled in WooCommerce → Settings → Payments
4. Apple Pay may not be available in the test/sandbox environment — verify with GoPay support

Frequently Asked Questions (FAQ)

What payment methods does GoPay support?

GoPay supports a wide range of payment methods including credit/debit cards (Visa, Mastercard), bank transfers, Apple Pay, Google Pay, PayPal, Bitcoin, GoPay account, Click to Pay, mPayment (mobile payment), Premium SMS, and Paysafecard. Available methods depend on your GoPay merchant account configuration.

Can I use the main GoPay gateway and individual channel gateways together?

Yes, you can enable the main GoPay gateway (which shows all selected methods on one GoPay payment page) alongside individual gateways like GoPay – Credit Card or GoPay – Apple Pay. Customers will see each enabled gateway as a separate option at checkout. Make sure you don’t enable the same payment method in both the main gateway and an individual channel to avoid confusion.

How do I test payments without processing real transactions?

Set the Environment to Test in WPify → WPify Woo GoPay and use the test credentials from your GoPay sandbox account (available at gw.sandbox.gopay.com). Test payments behave like real ones but no money is actually transferred.

Does the plugin support recurring payments?

Yes, the plugin supports recurring payments through WooCommerce Subscriptions. Enable the Enable recurring payments option in the gateway settings. Your GoPay merchant account must also be configured to support on-demand (recurring) payments — contact GoPay support to enable this feature on your account.