Skip to main content

Notch Pay WooCommerce Plugin

The Notch Pay WooCommerce plugin allows you to accept payments on your WooCommerce store using various payment methods including Mobile Money and Bank Transfers.

Installation

1

Download the Plugin

Download the Notch Pay WooCommerce plugin from the WordPress Plugin Directory or directly from your WordPress admin dashboard.
2

Install the Plugin

  1. Log in to your WordPress admin dashboard
  2. Go to Plugins > Add New
  3. Click Upload Plugin and select the downloaded zip file
  4. Click Install Now
  5. After installation, click Activate Plugin
3

Configure the Plugin

  1. Go to WooCommerce > Settings > Payments
  2. Find “Notch Pay” in the list of payment gateways
  3. Click Set up or toggle the switch to enable it
  4. Configure the gateway settings

Configuration

Notch Pay WooCommerce Settings

General Settings

Payment Options

Order Management

Checkout Experience

The plugin adds Notch Pay as a payment option at checkout:
Notch Pay Checkout Experience

Payment Flow

1

Customer Selects Notch Pay

At checkout, the customer selects Notch Pay as their payment method.
2

Customer Completes Order

The customer fills in their billing and shipping information and clicks “Place Order”.
3

Redirect to Payment Page

The customer is redirected to the Notch Pay checkout page to complete the payment.
4

Customer Selects Payment Method

On the Notch Pay checkout page, the customer selects their preferred payment method (Mobile Money, Bank Transfer, etc.).
5

Customer Completes Payment

The customer completes the payment using their selected method.
6

Redirect Back to Store

After payment, the customer is redirected back to your store’s thank you page.

Webhooks

The plugin automatically sets up a webhook endpoint to receive notifications from Notch Pay:
https://your-store.com/wc-api/notchpay
Make sure to add this URL to your webhook endpoints in the Notch Pay dashboard.

Webhook Events

The plugin listens for the following webhook events:

payment.complete

Triggered when a payment is completed. The plugin updates the corresponding order status.

payment.failed

Triggered when a payment fails. The plugin updates the order status to “Failed”.

payment.canceled

Triggered when a payment is canceled. The plugin updates the order status to “Cancelled”.

payment.refunded

Triggered when a payment is refunded. The plugin updates the order status and creates a refund in WooCommerce.

Refunds

The plugin supports refunds directly from the WooCommerce order page:
1

Go to the Order

Navigate to WooCommerce > Orders and click on the order you want to refund.
2

Initiate Refund

Click the “Refund” button at the top of the order page.
3

Enter Refund Details

Enter the amount to refund and any refund reason.
4

Process Refund

Check the “Refund via Notch Pay” checkbox and click “Refund”.
Refunds are only available for orders paid with Notch Pay and require the Private Key to be configured.

Subscriptions

The plugin integrates with WooCommerce Subscriptions to support recurring payments:
Recurring payments are currently not supported. Mobile Money and other payment methods can only be used for initial subscription payments.

Subscription Settings

Currency Conversion

The plugin supports automatic currency conversion if your store currency is different from the currencies supported by Notch Pay:

Customization

Custom CSS

You can customize the appearance of the Notch Pay checkout button by adding custom CSS to your theme:
/* Customize the Notch Pay checkout button */
.payment_method_notchpay label img {
    max-height: 40px;
}

.payment_box.payment_method_notchpay {
    background-color: #f9f9f9 !important;
}

Hooks and Filters

The plugin provides hooks and filters for developers to extend its functionality:
// Modify payment parameters before creating a payment
add_filter('wc_notchpay_payment_params', function($params, $order) {
    // Add custom metadata
    $params['metadata']['custom_field'] = 'custom_value';

    return $params;
}, 10, 2);

// Do something after a successful payment
add_action('wc_notchpay_payment_complete', function($order, $payment) {
    // Send a custom email
    $mailer = WC()->mailer();
    $mailer->emails['WC_Email_Customer_Processing_Order']->trigger($order->get_id());
}, 10, 2);

Multi-Currency Support

The plugin integrates with popular multi-currency plugins:

WPML

If you’re using WPML with the WooCommerce Multilingual module, the plugin will automatically use the correct currency based on the customer’s selected language.

Currency Switcher for WooCommerce

The plugin integrates with the Currency Switcher for WooCommerce plugin to support multiple currencies.

Troubleshooting

If the Notch Pay payment gateway is not showing at checkout:
  1. Check that the plugin is activated
  2. Verify that the gateway is enabled in WooCommerce settings
  3. Check if there are any currency restrictions (Notch Pay supports XAF, NGN, USD, etc.)
  4. Ensure that your customer’s billing country is supported by Notch Pay
If payments are not being processed:
  1. Verify that your API keys are correct
  2. Check that you’re using the right keys for test/live mode
  3. Check the Notch Pay dashboard for any failed payments
  4. Ensure your server can make outgoing HTTP requests
If webhooks are not being received:
  1. Verify that the webhook URL is correctly added in the Notch Pay dashboard
  2. Check that your webhook secret is correct
  3. Ensure your server is accessible from the internet
  4. Check your server logs for any errors
  5. Try enabling WooCommerce logging (WooCommerce > Status > Logs)
If order statuses are not updating after payment:
  1. Check that webhooks are properly configured
  2. Verify that the order exists in your WooCommerce store
  3. Check if there are any conflicts with other plugins that might be modifying order statuses
  4. Enable WooCommerce logging and check the logs for any errors

Frequently Asked Questions

The plugin supports all payment methods available on Notch Pay, including:
  • Mobile Money (MTN, Orange, Airtel, etc.)
  • Bank Transfers
  • USSD
  • QR Code
The available methods depend on your Notch Pay account and the countries you operate in.
Notch Pay primarily supports:
  • XAF (Central African CFA Franc)
  • NGN (Nigerian Naira)
  • USD (United States Dollar)
If your store uses a different currency, you can enable currency conversion in the plugin settings.
Yes, you can enable test mode in the plugin settings. In test mode, the plugin will use your test API keys and process test payments.
Yes, the plugin integrates with WooCommerce Subscriptions to support initial subscription payments. However, recurring payments are currently not supported.
Yes, you can enable multiple payment methods in the plugin settings. Customers will be able to choose their preferred payment method at the Notch Pay checkout page.
I