Description
Bachs Payment Gateway for WooCommerce lets your store accept payments through Bachs, a payments platform for internet businesses across African markets.
Features
- Hosted checkout redirect or on-site popup — choose whether customers are redirected to the Bachs hosted checkout page or pay in a Bachs modal without leaving your store. No card data ever touches your server either way.
- Multiple payment methods — cards, bank transfer, mobile money, and crypto stablecoins (USDT, USDC), all handled on the Bachs checkout.
- Sell in USD or NGN, get paid across Africa — price your store in USD or NGN and, with Bachs Adaptive Pricing enabled, customers can pay in their own local currency (NGN, GHS, KES, UGX, TZS, XAF, XOF, ZMW, RWF and more). Your store can also be priced directly in GHS, KES, MWK, RWF, TZS, UGX, XAF, XOF or ZMW. Bachs settles to you in USD or NGN.
- Webhook-verified fulfilment — orders complete on the
collection.succeededevent, with signature verification, not on the browser redirect. - Failed, expired and short payments — failed payments mark the order failed, short payments put it on hold for you to review, and customers whose checkout expired can pay again or cancel from the order payment page.
- Refunds — issue a refund straight from the WooCommerce order screen.
- Sandbox mode — build and test against the Bachs sandbox before going live.
- WooCommerce Blocks — works with both the classic and block-based checkout.
- HPOS compatible — supports WooCommerce High-Performance Order Storage.
Requirements
- WordPress 6.2 or higher
- WooCommerce 8.0 or higher
- PHP 7.4 or higher
- An SSL certificate (required for live payments)
- A Bachs account — sign up at bachs.io
External services
This plugin connects to the Bachs API to create checkout sessions, verify payments, and process refunds. It is required for the plugin to function.
When a customer pays with Bachs, the plugin sends the following to Bachs (https://api.bachs.io, or https://sandbox-api.bachs.io in test mode):
- Order reference, order ID and order number
- Order total amount
- Currency
- Customer billing details (name, email address, and phone number, when provided)
In the WordPress admin, the plugin also requests the list of supported currencies from the same API. No customer or order data is sent with that request.
The customer then pays on the Bachs hosted checkout (https://checkout.bachs.io) — either by redirect, or, when the Popup checkout type is selected, in a modal opened by the Bachs checkout script (https://checkout.bachs.io/bachs.js) loaded on the order-pay page. Card and payment details are handled entirely by Bachs; this plugin never stores or processes card numbers or other sensitive payment data. Bachs also sends signed webhook notifications back to your site to confirm payment and refund status.
For details on how Bachs handles data, see:
- Bachs website: https://bachs.io
- Bachs documentation: https://docs.bachs.io
- Bachs Privacy Policy: https://bachs.io/privacy
- Bachs Buyer Terms: https://bachs.io/buyer-terms
Screenshots


Installation
Automatic Installation
- Log in to your WordPress Admin Dashboard.
- Navigate to Plugins > Add New.
- Search for “Bachs Payment Gateway for WooCommerce”.
- Click Install Now and then Activate.
Manual Installation
- Download the plugin .zip from the WordPress.org plugin repository.
- Upload the
bachs-payment-gateway-for-woocommercefolder to/wp-content/plugins/via FTP or your hosting control panel. - Go to Plugins > Installed Plugins and click Activate under Bachs Payment Gateway for WooCommerce.
- Navigate to WooCommerce > Settings > Payments to configure.
FAQ
-
Which currencies are supported?
-
We recommend setting your WooCommerce store currency to USD or NGN — these are the currencies Bachs settles in. Your customers are not limited to those, though: with Adaptive Pricing enabled in your Bachs dashboard, shoppers across Africa can pay in their own local currency (such as GHS, KES, UGX, TZS, XAF, XOF, ZMW and RWF), or with cards, bank transfer, mobile money, or crypto stablecoins (USDT, USDC), all on the Bachs checkout. Bachs converts and settles the funds to your balance in USD or NGN.
The plugin also accepts GHS, KES, MWK, RWF, TZS, UGX, XAF, XOF and ZMW as the store currency, and keeps this list up to date from Bachs. If your store currency isn’t supported, an admin notice tells you and Bachs is hidden at checkout. If your store currency differs from the currency your payments settle in, see the partial refunds question below.
-
Do I need to configure webhooks?
-
Yes. Fulfilment relies on webhooks. Add the Webhook URL from the plugin settings to your Bachs developer portal, subscribe to
collection.succeeded,collection.failed,collection.underpaid,checkout.expired,refund.paidandrefund.failed, and paste the signing secret into the plugin. -
Redirect or popup?
-
Under Checkout type you can choose Redirect (the customer is sent to the Bachs hosted checkout page) or Popup (the Bachs checkout opens in a modal on your store, so the customer never leaves your site). Both use the same secure Bachs checkout and are confirmed by the same webhook.
-
Why did my order not complete after payment?
-
Orders complete when Bachs delivers the signed
collection.succeededwebhook. Confirm your webhook URL and signing secret are set correctly, and that your site is reachable from the internet. -
Why is my order on hold?
-
The plugin puts a Bachs order on hold, with an order note explaining why, in two situations:
- The payment needs review. Every successful payment is checked against the order before the order is completed. The order is held when the customer paid less than the order total, the payment came from a checkout this order didn’t create, the order total changed after the customer started paying, Bachs accepted the payment on terms other than the exact amount, or the customer underpaid. Check the payment in your Bachs dashboard, then complete the order, collect the balance, or refund it.
- The customer paid but the webhook hasn’t arrived yet. When the customer returns to your store, and before WooCommerce cancels unpaid orders (the Hold stock setting), the plugin asks Bachs whether the checkout was paid. If it was, the order is held so it isn’t cancelled, and it completes automatically when the
collection.succeededwebhook arrives. If orders stay on hold for this reason, check your webhook URL and signing secret.
On-hold orders keep their stock reserved and are never cancelled automatically.
-
Can I refund a payment?
-
Yes, from the WooCommerce order screen. Note that Bachs allows a single refund per charge, so once a charge has been refunded (fully or partially) a further refund through Bachs is not possible.
-
Why can’t I make a partial refund from WooCommerce?
-
Bachs reads a partial refund amount in the currency the payment settled in, which can differ from your order currency. For example, an order priced in NGN may settle to your balance in USD if you don’t hold NGN. Sending the WooCommerce amount as-is would refund the wrong amount, so when a payment settled in a different currency from the order, the plugin blocks the partial refund and shows a message asking you to make it from your Bachs dashboard instead.
Full refunds always work from WooCommerce, because Bachs refunds the whole payment without needing an amount. Partial refunds work from WooCommerce when the payment settled in the order currency.
-
Does it support subscriptions?
-
Not in this version. This release covers one-time payments and refunds.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“Bachs Payment Gateway for WooCommerce” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “Bachs Payment Gateway for WooCommerce” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.0.0
- Initial release of the official Bachs plugin for WooCommerce.
