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 | |
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 ( |
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 |
Apple Pay doesn't show | Domain not verified, Apple Pay disabled, or an unsupported device | See 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 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. 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.
Do I need to uninstall before updating? No. Upload the new zip and choose to replace the current one. See Updating versions.
Can I change how the payment form looks? Yes, using Custom Style in the settings. See Configure the plugin.
Where are the API errors explained? In the Errors page, and the FAQs page.