Universal M-Pesa Merchant Guide
Your guide to getting started, accepting M-Pesa payments and managing your merchant wallet.
Download Universal M-Pesa PluginDownload 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:
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
- Download the Universal M-Pesa plugin using the button above.
- Log in to your Marketplace dashboard.
- Go to Plugins → Add New Plugin.
- Select Upload Plugin.
- Choose the downloaded ZIP file.
- Click Install Now.
- After installation, click Activate Plugin.
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.
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.
- Open Universal M-Pesa → Connection Settings.
- Enter the official platform URL supplied during onboarding.
- Enter the API key issued to your business.
- Click Save Connection.
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:
8. Request a Withdrawal
You can request a withdrawal from your wallet directly to an M-Pesa phone number.
- Open My M-Pesa Wallet.
- Scroll to Request a Withdrawal.
- Enter the amount you wish to withdraw.
- Enter the destination M-Pesa phone number.
- Review the displayed minimum and fee information.
- Click Submit Withdrawal Request.
Your request will appear in the withdrawal history. Requests are subject to approval and processing.
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
- Make sure WooCommerce is installed and activated.
- Go to WooCommerce → Settings → Payments.
- Find Universal M-Pesa.
- Open its settings and enable the payment method.
- Set the customer-facing title, such as M-Pesa.
- Save your changes.
Universal M-Pesa currently supports KES orders with whole-shilling totals.
What your customers experience
- The customer adds products to the cart and proceeds to checkout.
- The customer selects M-Pesa as the payment method.
- The customer enters their M-Pesa phone number.
- An STK Push prompt is sent to the customer’s phone.
- The customer enters their M-Pesa PIN to authorise payment.
- The checkout page displays the payment confirmation status.
- Once payment is confirmed, the WooCommerce order is updated.
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.

Others
Bakery
