---
title: "Troubleshooting WooCommerce"
slug: "troubleshooting-woocommerce"
updated: 2026-10-23T14:01:51Z
published: 2026-10-23T14:01:51Z
canonical: "api-docs.blinkpayment.co.uk/troubleshooting-woocommerce"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://api-docs.blinkpayment.co.uk/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting WooCommerce

Most problems come from keys in the wrong mode, a payment method that isn't enabled on the Blink account, or a cache or firewall getting in the way. Check those first, then update to the latest plugin version.

### Common problems

| What you see | Likely cause | What to do |
| --- | --- | --- |
| Blink doesn't appear at checkout | Gateway not enabled, or keys missing | Tick **Enable Blink Gateway**, save your keys, and check Test Mode matches the keys you entered |
| The Payment Methods list is empty | Keys not saved, or the wrong keys for the mode | Save valid keys for the mode you are in; the list comes from your Blink account |
| A method is ticked but doesn't show | Method not enabled on your Blink account | Contact [integrationsupport@blinkpayment.co.uk](mailto:integrationsupport@blinkpayment.co.uk) |
| Authentication or key errors | Live keys in test fields, or the reverse | Check keys against **Enable Test Mode** |
| Card fields are blank, don't reload, or the layout looks broken | Theme or plugin conflict, or an old plugin version | Update the plugin, clear caches, and try **Hosted** under Integration Type |
| 3D Secure page shows an old or blank page | Page caching | The plugin sends no-cache headers for its challenge page (`/blink-3ds-challenge/`). Exclude that address from page caching and CDN rules |
| Order stays on Pending payment after payment | Blink's notification can't reach your store | Allow messages from Blink through your firewall, caching and security plugins. If you’re not sure how, ask your host or developer, or email [integrationsupport@blinkpayment.co.uk](mailto:integrationsupport@blinkpayment.co.uk) |
| Apple Pay doesn't show | Domain not verified, Apple Pay disabled, or an unsupported device | See Set up [Apple Pay](/v1/docs/payment-methods#set-up-apple-pay) |
| No Refund option on a pre-authorised order | The payment hasn't been captured yet | Capture it first, then refund |
| A capture note says the outcome is unknown | Blink hasn't confirmed the capture yet | Wait for confirmation and check the Blink Portal before trying again. Contact support if it doesn't resolve |
| Duplicate order emails | Old plugin version | Update to the latest plugin version |

### Get help

Email [integrationsupport@blinkpayment.co.uk](mailto:integrationsupport@blinkpayment.co.uk) and include:

- Your plugin, WooCommerce, WordPress and PHP versions
- The WooCommerce order number and the Blink transaction ID
- The date and time of the payment
- A screenshot of the error, and your Blink settings with keys hidden
- The debug log: turn on **Debug mode** under Advanced in the Blink settings, repeat the problem, then use the download link in the settings (logs are kept under `Uploads/blink-logs`). Switch Debug mode off afterwards.

You can also see open issues and report bugs on the [plugin's GitHub page](https://github.com/Blink-Payment/Blink-WooCommerce-v2/issues). Never post your keys publicly.

### FAQ

**How do I check which version I have?** Go to Plugins in WordPress; the version is shown under the plugin name.

**Can I use the plugin on a sandbox account?** Yes. Enter sandbox keys in the test fields and tick **Enable Test Mode**. See [Test before going live](/v1/docs/test-your-integration).

**Do I need to uninstall before updating?** No. Upload the new zip and choose to replace the current one. See [Updating versions](/v1/docs/updating-versions).

**Can I change how the payment form looks?** Yes, using **Custom Style** in the settings. See [Configure the plugin](/v1/docs/woocommerce-configuration).

**Where are the API errors explained?** In the [Errors](https://api-docs.blinkpayment.co.uk/docs/errors) page, and the [FAQs](https://api-docs.blinkpayment.co.uk/docs/faqs) page.