How to Setup the Hubtel WordPress Plugin for Businesses: A Step-by-Step Guide

If you’re a business owner using Hubtel to process payments and you want to integrate this capability into your WordPress website, you’re in the right place. Although Hubtel does not currently offer an official WordPress plugin, there’s a third-party solution available that can help you accept payments seamlessly on your site.

In this article, I’ll walk you through the entire setup process for the Payments for Hubtel WordPress plugin, enabling your customers to pay via mobile money, cards, and other methods directly from your website. Follow these simple steps to get started!

1. Confirm You Have a Hubtel Business Account

Before integrating Hubtel into your WordPress site, you must have a Hubtel business account.

• Visit Hubtel’s website and log in to your business account.
• Navigate to the Money section in your dashboard — keep this page handy as you’ll need to retrieve important information from here during setup.

If you don’t already have a business account, you will need to register one on Hubtel.

2. Access Your WordPress Admin Dashboard

Next, log in to the backend of your WordPress website:

• Go to your WordPress admin panel by visiting yourwebsite.com/wp-admin.
• Enter your credentials to access the dashboard where you manage your site’s content and plugins.

3. Install the “Payments for Hubtel” Plugin

Since Hubtel doesn’t provide an official WordPress plugin, you will use the Payments for Hubtel plugin developed by Kwame Twum, which integrates Hubtel payment gateways into WordPress.

Here’s how to install it:

• From the WordPress dashboard, navigate to Plugins > Add New.
• In the search bar, type Payments for Hubtel and press enter.
• Locate the plugin by Kwame Twum in the search results.
• Click Install Now and wait for the installation to complete.
• After installation, click Activate to enable the plugin on your site.

4. Configure the Plugin Settings

Once activated, you need to configure the plugin with your Hubtel business details.

• Go to Plugins > Installed Plugins.
• Find Payments for Hubtel and click on Settings.

In the settings page:

• Enable the plugin by toggling it on.
• Add a Title that will appear to customers during checkout (e.g., “Pay with Hubtel”).
• Write a Description to explain the payment method or give any instructions customers might need.

5. Set User Type as “Merchant”

For the plugin to correctly link to your business account, ensure the User Type is set to Merchant. This indicates the account used is a merchant account authorized to receive payments.

6. Retrieve and Enter Your Merchant Account Number

The plugin requires your Merchant Account Number to direct payments correctly.

• Return to your Hubtel business account dashboard (the Money section).
• Look for an account labeled POS OS Account Sales or something similar related to sales.
• Copy this account number.

Back in the WordPress plugin settings, paste this merchant account number in the designated field.

7. Generate and Add Your API Credentials

For your WordPress site to communicate securely with Hubtel’s payment platform, you’ll need your API ID and API Key:

• In your Hubtel business account, go to Manage Business.
• Click on API Keys.
• If you don’t already have API credentials, click Add New to generate a new API key.
• Copy the API ID and paste it into the plugin’s API ID field.
• Copy the API Key and paste it into the API Key field in the plugin.

Save your settings after adding these credentials.

8. Activate the Plugin with a License Key

To fully activate the plugin and unlock its functionality, you need an activation code purchased from the plugin developer.

• Scroll to the bottom of the plugin settings page where you’ll find Activation Instructions.
• Click on the provided link to open the activation form.
• Fill in your name and other details.
• Crucially, enter your correct website URL — the license is tied to your domain, so accuracy here is vital.
• Complete the payment to purchase your license.
• You will receive an SMS containing an activation code.
• Copy this code.
• Return to the plugin settings in WordPress and paste the code into the activation field.
• Save the settings, and you should see the plugin marked as Activated.

9. Test the Payment Experience on Your Website

With everything set up, it’s time to ensure payments work smoothly for your customers.

• Visit your website’s store or product page.
• Add a product to your cart (you can use a test product if available).
• Proceed to checkout.
• You should see payment options that include Hubtel mobile money, cards, and other methods.
• When you place the order, you will be redirected to Hubtel’s secure payment gateway.
• Complete the payment using your preferred method.

This confirms your integration is working correctly.

Additional Tips for a Smooth Integration

• Keep your API credentials secure — do not share them with unauthorized persons.
• If you change your website domain or URL, remember you’ll need a new activation license key.
• Regularly update the plugin when updates are available to maintain security and compatibility.
• If possible, set up a staging environment to test the plugin before deploying it on a live site.
• Reach out to the plugin developer or support community if you encounter any issues: support@geniustechhub.com

Conclusion

Setting up the Hubtel payment system on your WordPress website is straightforward using the Payments for Hubtel plugin. By following the steps outlined here—from installing the plugin, configuring your merchant account and API credentials, to activating the license key—you can start accepting payments securely and efficiently on your site.

This integration not only improves your customer’s checkout experience but also enhances your ability to manage payments directly from your WordPress store.

If you have any questions or run into challenges during setup, feel free to leave a comment or seek help from the plugin developer.