Nomba Payment Gateway for WooCommerce

Nomba simplifies the process for Nigerian businesses to securely accept payments from various channels, both locally and internationally. By integrating Nomba into your WooCommerce store website, you empower your customers to pay conveniently using a range of methods:

• Credit/Debit Cards: Visa, Mastercard, Verve, American Express
• Bank transfer
• QR code
• USSD
• And more options on the horizon including Apple and Google Pay!

Nomba Payment Gateway for WooCommerce plugin allows you to receive payment on your WooCommerce store via Nomba’s API.

Why Choose Nomba?

• Swift Setup: Begin receiving payments in as little as 10 minutes after signing up. Simply create an account and obtain your API keys
• Transparent Pricing: Enjoy straightforward rates of 1.4%, capped at N1,800 for local transactions, and 3.9% for international card payments.
• Hassle-Free Dispute Management: Access our Automated Dispute Manager at no additional cost.
• Comprehensive Analytics: Gain valuable insights through our intuitive dashboard.
• Responsive Support: Our empathetic customer service team is available 24/7 to assist you.
• Ongoing Enhancements: Benefit from free updates as we roll out new features and payment options.
• Robust APIs: Access clearly documented APIs to tailor your payment experiences to your specific needs.
• Volume Discount: Volume discounts available for merchants with 50m+ in monthly volumes

Note

This plugin is meant to be used by merchants in Nigeria.

Plugin Features

• Accept payment via Visa, Mastercard, Verve, American Express, Bank transfer, QR code & USSD
• Recurring payment using WooCommerce Subscriptions plugin
• Refund payments directly from the order details page

WooCommerce Subscriptions Integration

• If a customer pays for a subscription using a Mastercard, Visa, Verve card, their subscription will renew automatically throughout the duration of the subscription. If an automatic renewal fail their subscription will be put on-hold, and they will have to log in to their account to renew the subscription.

• For customers paying with USSD, Bank Transfer, QR code, their subscription can’t be renewed automatically, once a payment is due their subscription will be on-hold. The customer will have to log in to their account to manually renew their subscription.

• If a subscription has a free trial and no signup-fee, automatic renewal is not possible for the first payment because the initial order total will be 0, after the free trial the subscription will be put on-hold. The customer will have to log in to their account to renew their subscription. If a Mastercard, Visa, Verve is used to renew the subscription subsequent renewals will be automatic throughout the duration of the subscription.

Suggestions / Feature Request

Got an idea or a feature request? Feel free to reach out to us at integrations@nomba.com.

Let’s make payment processing simpler and more efficient together with Nomba!

• Go to WordPress Admin > Plugins > Add New from the left-hand menu
• In the search box type Nomba WooCommerce Payment Gateway
• Click on Install now when you see Nomba WooCommerce Payment Gateway to install the plugin
• After installation, activate the plugin.

Nomba Setup and Configuration

• Go to WooCommerce > Settings and click on the Payments tab
• You’ll see Nomba listed along with your other payment methods. Click to view the plugin settings page
• On the next screen, configure the plugin. There is a selection of options on the screen. Read what each one does below.

1. Enable/Disable – Check this checkbox to Enable Nomba on your store’s checkout
2. Title – This will represent Nomba on your list of Payment options during checkout. It guides users to know which option to select to pay with Nomba. Title is set to “Accept Secure Payment via Nomba” by default, but you can change it to suit your needs.
3. Description – This controls the message that appears under the payment fields on the checkout page. Use this space to give more details to customers about what Nomba is and what payment methods they can use with it.
4. Test Mode – Check this to enable test mode. When selected, the fields in step five will say “Test” instead of “Live.” Test mode enables you to test payments before going live. The orders process with test payment methods, no money is involved so there is no risk. You can uncheck this when your store is ready to accept real payments.
5. API Keys – The next six text boxes are for your Nomba API keys, which you can get from your Nomba merchant Dashboard.
6. Click on Save Changes to update the settings.

To account for poor network connections, which can sometimes affect order status updates after a transaction, we strongly recommend that you set a Webhook URL on your Nomba merchant dashboard. This way, whenever a transaction is complete on your store, we’ll send a notification to the Webhook URL, which will update the order and mark it as paid. You can set this up by using the URL in red at the top of the Settings page. Just copy the URL and save it as your webhook URL on your Nomba dashboard under Settings > Webhooks tab.

If you do not find Nomba on the Payment method options, please go through the settings again and ensure that:

• You’ve checked the “Enable/Disable” checkbox
• You’ve entered your API Keys in the appropriate field
• Your store currency is set to NGN
• You’ve clicked on Save Changes during setup

1. 

   Nomba displayed as a payment method on the WooCommerce payment methods page

2. 

   Nomba WooCommerce payment gateway settings page

1.0.7 – April 22, 2026

• Fix order wedging on crashed mid-update: callback now acquires the processing lock before checking order status, and uses the transaction ID as the completion signal so a subsequent request can complete an order whose prior request died after flipping status to “processing”
• Fix webhook giving up on HTTP 404 when fetching transaction details: the transaction fetch now retries on 404, treating it as a transient backend read-after-write lag rather than a permanent failure
• Add a short delay before the webhook fetches the transaction to reduce read-after-write races with the Nomba backend

1.0.6 – April 17, 2026

• Add comprehensive logging for webhook and redirect callback payment flows
• Add order notes indicating whether payment was confirmed via webhook or redirect callback
• Add retry logic with configurable attempts for transaction verification API calls
• Add atomic order processing lock to prevent race conditions from concurrent requests
• Add stale lock detection with 60-second TTL for automatic recovery
• Fix transaction lookup using proper query parameters instead of request body on GET requests
• Fix token cache expiration bug that could cache expired tokens indefinitely
• Fix wc_add_notice() call in webhook context where no customer session exists
• Fix WC()->cart->empty_cart() call in webhook context where no cart session exists
• Improve error handling with categorised HTTP status responses (retryable vs permanent failures)
• Improve webhook reliability by returning 400 on transient failures to trigger redelivery
• Reduce API timeout from 60s to 30s to prevent PHP execution timeouts
• Add 401 token refresh handling without consuming retry attempts
• WordPress 6.9 compatibility
• WooCommerce 10.7 compatibility

1.0.5 – November 8, 2025

• Add support for GBP & EUR payment
• Add options to pass order details to Nomba
• WooCommerce 10.3 compatibility

1.0.4 – September 18, 2025

• Update Nomba payment method image displayed on the checkout page
• Add support for partial refund from the order details page
• WooCommerce 10.2 compatibility

1.0.3 – September 15, 2025

• Refund order payments directly from the order details page

1.0.2 – March 3, 2025

• Add option to autocomplete order after successful payment

1.0.1 – January 3, 2025

• Add support for USD payment
• Pass X-Nomba-Integration header when creating a Nomba checkout order

1.0.0 – March 27, 2024

• First release