Knowledgebase

Overview

The cwhost M-Pesa WHMCS Plugin enables hosting companies and service providers to accept M-Pesa STK Push payments directly within WHMCS invoices.

Key Features

• ✔ STK Push for WHMCS invoices

• ✔ Automatic invoice payment confirmation

• ✔ License verification support

• ✔ Manual payment fallback (Paybill)

• ✔ Compatible with WHMCS 8.x+

Requirements

• WHMCS installed

• Safaricom Daraja API credentials

• Valid plugin license from cwhost.cloud

• SSL-enabled domain

Installation Steps

1. Download the cwhost M-Pesa WHMCS Plugin.

2. Upload plugin files to:

    

   /modules/gateways/

3. Log in to WHMCS Admin.

4. Navigate to System Settings → Payment Gateways.

5. Activate M-Pesa STK Push.

6. Enter Daraja credentials and license key.

7. Save changes.

How It Works

1. Client views invoice in WHMCS.

2. Selects Pay with M-Pesa.

3. Enters phone number.

4. Receives STK prompt.

5. Invoice is marked Paid automatically.

Manual Payment Option

If STK Push fails, clients can pay manually:

• Paybill: Provided by merchant

• Account Number: Invoice Number

• Amount: Invoice Total

Client clicks Confirm Payment after completion.

Troubleshooting

• Confirm callback URL is accessible

• Ensure invoice status is Unpaid

• Verify Daraja credentials are correct

• Check WHMCS activity logs for errors