Title: Bachs Payment Gateway for WooCommerce
Author: bachs
Published: <strong>November 16, 2026</strong>
Last modified: November 16, 2026

---

Search plugins

![](https://ps.w.org/bachs-payment-gateway-for-woocommerce/assets/banner-772x250.
png?rev=3805272)

![](https://ps.w.org/bachs-payment-gateway-for-woocommerce/assets/icon-256x256.png?
rev=3805272)

# Bachs Payment Gateway for WooCommerce

 By [bachs](https://profiles.wordpress.org/bachs/)

[Download](https://downloads.wordpress.org/plugin/bachs-payment-gateway-for-woocommerce.1.0.0.zip)

 * [Details](https://wordpress.org/plugins/bachs-payment-gateway-for-woocommerce/#description)
 * [Reviews](https://wordpress.org/plugins/bachs-payment-gateway-for-woocommerce/#reviews)
 *  [Installation](https://wordpress.org/plugins/bachs-payment-gateway-for-woocommerce/#installation)
 * [Development](https://wordpress.org/plugins/bachs-payment-gateway-for-woocommerce/#developers)

 [Support](https://wordpress.org/support/plugin/bachs-payment-gateway-for-woocommerce/)

## Description

Bachs Payment Gateway for WooCommerce lets your store accept payments through [Bachs](https://bachs.io/),
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.succeeded`
   event, 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](https://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

[⌊Bachs gateway settings in WooCommerce: checkout type, sandbox and live API keys,
and the webhook URL.⌉⌊Bachs gateway settings in WooCommerce: checkout type, sandbox
and live API keys, and the webhook URL.⌉[

Bachs gateway settings in WooCommerce: checkout type, sandbox and live API keys,
and the webhook URL.

[⌊Bachs shown as a payment option on the WooCommerce checkout.⌉⌊Bachs shown as a
payment option on the WooCommerce checkout.⌉[

Bachs shown as a payment option on the WooCommerce checkout.

## Installation

#### Automatic Installation

 1. Log in to your WordPress Admin Dashboard.
 2. Navigate to **Plugins > Add New**.
 3. Search for “Bachs Payment Gateway for WooCommerce”.
 4. Click **Install Now** and then **Activate**.

#### Manual Installation

 1. Download the plugin .zip from the [WordPress.org plugin repository](https://wordpress.org/plugins/bachs-payment-gateway-for-woocommerce/).
 2. Upload the `bachs-payment-gateway-for-woocommerce` folder to `/wp-content/plugins/`
    via FTP or your hosting control panel.
 3. Go to **Plugins > Installed Plugins** and click **Activate** under Bachs Payment
    Gateway for WooCommerce.
 4. 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.paid` and `refund.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.succeeded` webhook. 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.
   succeeded` webhook 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.

Contributors

 *   [ bachs ](https://profiles.wordpress.org/bachs/)
 *   [ Isaac Auta ](https://profiles.wordpress.org/isaacshed/)
 *   [ Daniel Ayoola ](https://profiles.wordpress.org/geekydaniel/)

[Translate “Bachs Payment Gateway for WooCommerce” into your language.](https://translate.wordpress.org/projects/wp-plugins/bachs-payment-gateway-for-woocommerce)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/bachs-payment-gateway-for-woocommerce/),
check out the [SVN repository](https://plugins.svn.wordpress.org/bachs-payment-gateway-for-woocommerce/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/bachs-payment-gateway-for-woocommerce/)
by [RSS](https://plugins.trac.wordpress.org/log/bachs-payment-gateway-for-woocommerce/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 1.0.0

 * Initial release of the official Bachs plugin for WooCommerce.

## Meta

 *  Version **1.0.0**
 *  Last updated **19 hours ago**
 *  Active installations **Fewer than 10**
 *  WordPress version ** 6.2 or higher **
 *  Tested up to **7.1.4**
 *  PHP version ** 7.4 or higher **
 * Tags
 * [africa](https://wordpress.org/plugins/tags/africa/)[bachs](https://wordpress.org/plugins/tags/bachs/)
   [payment gateway](https://wordpress.org/plugins/tags/payment-gateway/)[payments](https://wordpress.org/plugins/tags/payments/)
   [woocommerce](https://wordpress.org/plugins/tags/woocommerce/)
 *  [Advanced View](https://wordpress.org/plugins/bachs-payment-gateway-for-woocommerce/advanced/)

## Ratings

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/bachs-payment-gateway-for-woocommerce/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/bachs-payment-gateway-for-woocommerce/reviews/)

## Contributors

 *   [ bachs ](https://profiles.wordpress.org/bachs/)
 *   [ Isaac Auta ](https://profiles.wordpress.org/isaacshed/)
 *   [ Daniel Ayoola ](https://profiles.wordpress.org/geekydaniel/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/bachs-payment-gateway-for-woocommerce/)