Mpesa Payment Gateway

Mpesa Payment Gateway Plugin for Botble CMS

Integrate Mpesa payment gateway into Botble CMS eCommerce systems with region-specific configurations for the Kenyan market.

Features

• Seamless Mpesa integration with transaction tracking
• Region-specific configurations for Kenyan counties
• Sandbox and Production environment support
• Multi-currency support (KES)
• Customer-friendly checkout experience

Installation

1. Download and extract the plugin
2. Copy to platform/plugins/mpesa directory
3. Admin Panel → Plugins → Activate "Mpesa Payment Gateway"
4. Admin Panel → Settings → Payment Gateways → Configure

Configuration

Basic Setup

Navigate to Payment Methods and configure:

• Business Shortcode: Your Mpesa business code
• Passkey: Mpesa API passkey
• Consumer Key & Secret: API credentials
• Payment Mode: Production/Sandbox

Region-Specific Settings

Configure unique Mpesa settings per region:

Supported regions: Nairobi City, Kajiado, Kirinyaga, Machakos, Nakuru, and more.

Customer Experience

1. Add products to cart
2. Fill shipping information
3. Select "Pay online via Mpesa"
4. Review order total (KES)
5. Complete payment via Mpesa redirect

Transaction Management

Monitor all transactions with:

• Real-time status tracking (Pending/Completed)
• Transaction details and amounts
• Customer information
• Payment dates and references

Requirements

• Botble CMS / Farmart Laravel eCommerce System
• Valid Mpesa Business Account
• Mpesa API credentials
• PHP 7.4+

Support

• Developer: Njovu Team
• Version: 0.1.0
• License: MIT

Quick Setup

# 1. Copy plugin files
cp -r mpesa-plugin platform/plugins/mpesa

# 2. Activate in admin panel
# 3. Configure Mpesa credentials
# 4. Set region-specific settings
# 5. Test with sandbox mode