Knowledgebase

Overview

The cwhost M-Pesa WooCommerce Plugin allows online stores to accept Safaricom M-Pesa STK Push payments directly on checkout. Customers receive a payment prompt on their phone and complete payment instantly.

Key Features

• ✔ STK Push (Lipa na M-Pesa Online)

• ✔ Automatic order confirmation

• ✔ Real-time payment status updates

• ✔ Secure Daraja API integration

• ✔ Works with both test and live credentials

• ✔ Optimized for Kenyan businesses

Requirements

• WordPress + WooCommerce installed

• Safaricom Daraja API credentials

• SSL certificate (HTTPS enabled)

• PHP 7.4 or higher

Installation Steps

1. Log in to your WordPress admin dashboard.

2. Go to Plugins → Add New → Upload Plugin.

3. Upload the cwhost M-Pesa WooCommerce Plugin ZIP file.

4. Click Install then Activate.

5. Navigate to WooCommerce → Settings → Payments.

6. Enable M-Pesa (STK Push).

7. Enter your Daraja API credentials.

8. Save changes.

How It Works

1. Customer places an order.

2. Enters their M-Pesa phone number at checkout.

3. Receives an STK prompt on their phone.

4. Enters M-Pesa PIN.

5. Order status updates automatically to Processing / Completed.

Troubleshooting

• Ensure phone numbers start with 07XXXXXXXX

• Confirm site is served over HTTPS

• Verify callback URL is publicly accessible