Setting up BriizPay in WooCommerce
About ten minutes, most of it waiting for your business checks. You will not need to touch any code.
- 1
Create a BriizPay account
Sign up and complete the checks on your business. You need an approved company and a bank account on file before you can take a payment, so start here rather than with the plugin.
- 2
Install the plugin
Download the plugin, then in WordPress go to Plugins, Add New, Upload Plugin, choose the file and activate it.
- 3
Connect your shop in BriizPay
In BriizPay open Integrations, choose WooCommerce, and enter your shop's web address. It creates your API key and tells us where to send payment notifications.
- 4
Paste the two values into WooCommerce
In WordPress go to WooCommerce, Settings, Payments, BriizPay. Paste the API key into the field named API key, and the signing secret into Webhook signing secret. Tick Enable BriizPay and save.
- 5
Place one real order
Put something cheap in your basket and pay for it. The order should move to Processing on its own within a second or two of you approving the payment in your banking app.
The two secrets are shown once
We store them hashed, so nobody can show them to you again, including us. Copy both into WooCommerce before you leave the page. If you lose one, connect your shop again for a fresh pair and revoke the old key.
When something is not right
There are no payment methods available at checkout
The gateway hides itself rather than failing at the last step, and it does that in three cases: your store currency is not GBP, no API key is set, or the method is not enabled. BriizPay settles to a UK bank account, so a store priced in dollars or euros cannot use it.
The order stays on hold instead of processing
The plugin checks the amount it is told against your order total, and holds the order rather than marking it paid if they do not match. That should not happen, and a human looking at it is better than a wrong order marked paid. Check the order notes: they name both figures.
The customer paid but the order did not update
Open Integrations, WooCommerce in BriizPay and look at the recent notifications. It shows whether we tried and what your shop said back, which separates 'we never sent it' from 'your shop refused it'. We retry on a backoff, so a shop that was briefly down will catch up on its own.
It says the signature is invalid
The signing secret in WooCommerce does not match the one BriizPay is signing with. Connect your shop again in BriizPay to get a fresh pair, and paste both into the plugin. The secret is shown once and cannot be recovered afterwards.
My shop is on a local address or behind a login
We cannot send payment notifications to a site only you can reach, which includes anything on localhost or a staging site behind HTTP authentication. Use a publicly reachable https address.