Deal of the day!

FREE WOOCOMMERCE-MPESA CHECKOUT PLUGIN

Your guide to getting started, accepting M-Pesa payments and managing your merchant wallet.

Download Universal M-Pesa Plugin

Download the plugin and follow the steps below to get started.

1. Welcome to Marketplace Universal M-Pesa

Universal M-Pesa helps businesses and online stores accept M-Pesa payments and manage their payment collections from one convenient place.

With Universal M-Pesa, you can:

Accept M-Pesa payments Receive customer payments directly through your website.
Manage your wallet View your available balance and payment collections.
Track transactions Review payment references, amounts and M-Pesa receipts.
Request withdrawals Submit withdrawal requests to your registered M-Pesa number.

2. What You Need Before Installation

  • A Marketplace website.
  • Administrator access to your website.
  • A working business email address and phone number.
  • An active HTTPS website (secure website address).
  • WooCommerce, if you intend to accept payments through an online store.

3. Install the Plugin

  1. Download the Universal M-Pesa plugin using the button above.
  2. Log in to your Marketplace dashboard.
  3. Go to Plugins → Add New Plugin.
  4. Select Upload Plugin.
  5. Choose the downloaded ZIP file.
  6. Click Install Now.
  7. After installation, click Activate Plugin.
Once activated, a new Universal M-Pesa menu appears in your Marketplace dashboard.

4. Navigate the Plugin

All Universal M-Pesa functions are grouped under one dedicated menu. You do not need to search through the general Marketplace Settings menu.

Universal M-Pesa — Opens your wallet dashboard.
My M-Pesa Wallet — View balances, collections and withdrawals.
Connection Settings — Configure your website connection.
Apply for API Key — Register your business and website.

5. Register Your Business

Before accepting payments, your website must be registered and approved.

Step 1: Open the application page

Go to Universal M-Pesa → Apply for API Key.

Step 2: Complete your business details

Provide the following information:

  • Business or store name.
  • Contact person’s name.
  • Business email address.
  • Phone number.
  • Website address.
  • Business description (optional).

Some details may already be filled in using your website information. Review them and correct anything that is inaccurate.

Step 3: Submit your application

Click Submit Application and wait for your application to be reviewed.

Once approved, your website will receive its unique API key through the email address provided in your application.

6. Connect Your Website

After receiving your API key, configure your website connection.

  1. Open Universal M-Pesa → Connection Settings.
  2. Enter the official platform URL supplied during onboarding.
  3. Enter the API key issued to your business.
  4. Click Save Connection.
Protect your API key. Do not share it with other people. The API key field is hidden for security. When updating your settings, leave it blank if you want to retain your existing key.

7. Access Your Merchant Wallet

Your wallet is available directly inside your Marketplace dashboard. Open Universal M-Pesa → My M-Pesa Wallet.

Your wallet provides the following information:

Available Wallet Balance The amount currently available in your merchant wallet.
Successful Collections The total value and number of confirmed customer payments.
Gateway Fees Fees associated with successful payment collections.
Net Wallet Credits Verified amounts credited to your wallet.
Pending Withdrawals Amounts awaiting withdrawal processing.
Payment Activity Recent transactions, references and M-Pesa receipts.

8. Request a Withdrawal

You can request a withdrawal from your wallet directly to an M-Pesa phone number.

  1. Open My M-Pesa Wallet.
  2. Scroll to Request a Withdrawal.
  3. Enter the amount you wish to withdraw.
  4. Enter the destination M-Pesa phone number.
  5. Review the displayed minimum and fee information.
  6. Click Submit Withdrawal Request.

Your request will appear in the withdrawal history. Requests are subject to approval and processing.

Important: Submitting a withdrawal request does not mean that the money has already been sent. Funds are reserved while a request is pending or approved. The actual payout is processed separately.

9. Accept M-Pesa Payments with WooCommerce

If you operate an online store, you can enable Universal M-Pesa as a WooCommerce payment method.

Enable the payment method

  1. Make sure WooCommerce is installed and activated.
  2. Go to WooCommerce → Settings → Payments.
  3. Find Universal M-Pesa.
  4. Open its settings and enable the payment method.
  5. Set the customer-facing title, such as M-Pesa.
  6. Save your changes.

Universal M-Pesa currently supports KES orders with whole-shilling totals.

What your customers experience

  1. The customer adds products to the cart and proceeds to checkout.
  2. The customer selects M-Pesa as the payment method.
  3. The customer enters their M-Pesa phone number.
  4. An STK Push prompt is sent to the customer’s phone.
  5. The customer enters their M-Pesa PIN to authorise payment.
  6. The checkout page displays the payment confirmation status.
  7. Once payment is confirmed, the WooCommerce order is updated.
Customers should approve the payment prompt and wait for confirmation. They should not repeat a payment while an earlier transaction is still pending or awaiting verification.

10. Optional Payment Shortcodes

For websites that need a standalone payment form, the plugin also provides shortcodes.

Basic payment form

[universal_mpesa_checkout]

Payment form with a preset amount and reference

[universal_mpesa_checkout amount="250" reference="Invoice 123" button="Pay now"]

Payment status display

[universal_mpesa_payment_status]

To use a shortcode, copy it into the content of a Marketplace page or post.

11. Frequently Asked Questions

My wallet is not loading. What should I do?

Check that your plugin is activated, your website connection details are correct and your application has been approved. Revisit Connection Settings if necessary.

I have submitted an application. What happens next?

Your application will be reviewed. Once approved, your API key will be sent to the email address you provided.

My payment is still pending. Should I try again?

No. First verify the status of the earlier transaction. Do not make a second payment until the first one has been checked.

My withdrawal has not arrived. What should I do?

Check the withdrawal history in your wallet. A request must be approved and processed before the payout reaches your phone.

Can I use the wallet without WooCommerce?

Yes. The merchant wallet and account connection functions do not require WooCommerce. WooCommerce is needed for the online store payment gateway.

12. Keep Your Account Secure

  • Never share your API key or Marketplace administrator password.
  • Keep your website and plugins updated.
  • Use a secure HTTPS website.
  • Only give trusted people access to your website administration.
  • Verify payment and withdrawal statuses before taking action.
  • Contact support if you suspect unauthorised access to your account.