Skip to main content
The Pesaswap WooCommerce plugin adds Pesaswap as a payment method at your WooCommerce checkout, so your customers can pay with M-Pesa and Airtel Money. No developer required — install the plugin, paste in your credentials, and mobile money appears at checkout.

​
Before you start

  • A Pesaswap account with a business profile.
  • A WordPress site running WordPress 5.6+ and WooCommerce 4.0+.
  • Admin access to that WordPress site.

​
Set up the plugin

1

Download the plugin

In the Pesaswap dashboard, go to Integrations → WooCommerce and download the plugin .zip (version 1.7.0).
2

Install and enable it on your store

These steps happen in your own WordPress admin, not in the Pesaswap dashboard.
  1. Go to Plugins → Add New → Upload Plugin, choose the .zip you downloaded, then click Install and Activate.
  2. Go to WooCommerce → Settings → Payments, tick Enable for Pesaswap, and save.
3

Add your credentials

Copy these from the Pesaswap dashboard into the plugin’s settings screen:
Secret API keys are shown only once — at the moment you create them. If you don’t have one saved, create a new key under Developers → API keys and copy it straight into the plugin.
4

Point callbacks at your store

The plugin’s settings screen shows a webhook URL for your store. In the Pesaswap dashboard, go to Settings → Business Profiles and set that URL as your webhook URL. This is how Pesaswap tells your store that a payment succeeded.
Without this step, payments will succeed but your WooCommerce orders will stay marked unpaid.
The plugin authenticates these callbacks with a few extra settings — a Consumer Key (your Merchant ID), a Callback API Key, and the callback values configured on your business profile. If you are not sure which format your account uses, leave them blank and the plugin uses its default.

​
How it works

A customer checks out on your store and chooses Pesaswap. They receive a mobile-money prompt — M-Pesa or Airtel Money — and approve it on their phone. Pesaswap then sends a callback to your webhook URL, and the WooCommerce order is marked paid.

​
Troubleshooting

Your callback/webhook URL is not configured. Complete step 4 — set the plugin’s webhook URL under Settings → Business Profiles.
The plugin is installed but not enabled. Go to WooCommerce → Settings → Payments and tick Enable for Pesaswap.