Kopo Kopo for WooCommerce helps your online sales grow by providing smooth, secure Lipa na M-PESA payments for your customers, while allowing you receive funds directly to your Kopo Kopo account.
Tens of thousands of Kenyan businesses trust Kopo Kopo to accept digital payments, manage outgoing payments and access credit.
Accept payments in real-time
- Let your customers pay securely using Lipa na M-PESA at checkout.
- Receive funds directly to your Kopo Kopo account in real time.
- Provide a seamless checkout experience.
- Ensure no payment is lost with optional manual fallback via Lipa na M-PESA till number or Paybill.
Manage your payments effortlessly
- Connect your WooCommerce store to your Kopo Kopo account with a few simple steps.
- Use K2 Connect API keys for secure and reliable transactions.
- Keep track of payments, orders and reports from your WooCommerce dashboard.
- Automatically update orders when manual payments are received using Kopo Kopo Webhooks.
Data retention
To preserve order history and payment integrity, uninstalling this plugin removes its settings but keeps order-related payment data. This allows existing orders to remain verifiable and enables recovery if the plugin is reinstalled.
Get started
New to Kopo Kopo? Open an account today and make it easy for your customers to pay you.
Already a Kopo Kopo customer? Simply install the plugin, connect your account and start receiving payments instantly.
We value your feedback
If you have a specific feature request, please
let us know so we can make the service perfect for you.
Requirements:
- WordPress Version 6.2 or newer (installed).
- WooCommerce Version 8.0 or newer (installed and activated).
- PHP Version 7.4 or newer.
- Kopo Kopo account.
Installation Instructions
- Log in to your WordPress admin dashboard.
- Navigate to Plugins > Add New.
- In the search bar, type Kopo Kopo for WooCommerce.
- Click Install Now and wait for the plugin to finish installing.
- After installation, click Activate Now to enable the plugin immediately.
Note: You can activate it later via Plugins > Installed Plugins.
Setup and configuration
Pretty Permalinks Required
This plugin requires Pretty Permalinks to be enabled.
The plugin creates custom payment URLs using WordPress rewrite rules. If Pretty Permalinks are disabled, these URLs will not work and may result in a 404 error.
To enable Pretty Permalinks:
- Go to WordPress Admin > Settings > Permalinks.
- Select "Post name" or any structure other than "Plain".
- Click Save Changes.
Follow these steps to connect the plugin to your Kopo Kopo account:
- Go to WooCommerce > Settings.
- Click the Payments tab.
- Locate Kopo Kopo for WooCommerce and click Manage.
- Configure the plugin settings as described below:
- Enable/Disable - Check this box to activate Kopo Kopo for WooCommerce on your online shop checkout page.
- Title - This appears as the payment option during checkout. The default title is Lipa na M-PESA. This cannot be changed.
- Description - This message appears under the payment fields to guide your customers. Default text: Click "Proceed to Lipa na M-PESA" below to pay with M-PESA. This cannot be changed.
STK Push settings
- Till number - Enter the Lipa na M-PESA number that will receive STK Push payments. This must be an online payment account in your Kopo Kopo dashboard under My Tills.
- Client ID - Enter your K2 Connect Client ID.
- Client secret - Enter your K2 Connect Client Secret.
- API key - Enter your K2 Connect API Key.
- Environment - Select the environment you want to use: Sandbox for testing or Production for live payments. Ensure your credentials match the selected environment to avoid errors.
Optional: Enable Kopo Kopo Branding
- Display Kopo Kopo Branding - Enables the display of a small “Powered by Kopo Kopo” notice on Lipa na M-PESA payment pages. This option is disabled by default and can be turned on or off at any time without affecting payment functionality.
Manual payment settings
- Enable/Disable Manual Payments - Use this option to provide a Lipa na M-PESA till number or Paybill details as a fallback to STK Push. After enabling, click Create Webhook Subscriptions at the bottom of the page.
- Manual Payment Method - Choose either Till or Paybill from the dropdown. If both are provided, the Till option will take priority.
- Till Number / Paybill Business Number & Paybill Account Number - Enter the account details for the manual fallback.
Webhooks
To automatically update orders when manual payments are enabled, the plugin uses Webhooks to notify your site when a payment is received.
- To have orders move to
Processing automatically after a manual payment, make sure you subscribe to the appropriate Webhooks in your Kopo Kopo App.
Troubleshooting
If Kopo Kopo for WooCommerce does not appear in the payment options:
1. Ensure the currency is set to Kenyan Shilling (KES). Check this under
Woocommerce >
Settings >
General
2. Check for any warnings or error messages at the top of the plugin settings page.
3. Confirm the following:
*
Enable/Disable checkbox is checked.
* Your
Till Number is correctly entered under STK Push settings.
* All
K2 Connect API credentials are entered correctly.
* You clicked
Save Changes during setup.