CartModules: Pesapal Payment Gateway
Accept Pesapal Payments in Your CS-Cart Store — M-Pesa, Airtel Money, MTN, Visa, Mastercard & More
Integrate Pesapal — East Africa's leading online payment platform — directly into your CS-Cart or Multi-Vendor store. Accept payments via M-Pesa, Airtel Money, MTN Mobile Money, Visa, Mastercard, and bank transfers from customers across Kenya, Uganda, Tanzania, Rwanda, Malawi, Zimbabwe, and Zambia.
Key Features
- Multiple Payment Methods — M-Pesa, Airtel Money, MTN Mobile Money, Visa, Mastercard, bank transfers
- 7 Countries Supported — Kenya, Uganda, Tanzania, Rwanda, Malawi, Zimbabwe, Zambia
- 7 Currencies Supported — KES, UGX, TZS, RWF, MWK, ZMW, USD
- Pesapal API 3.0 — Latest API version with Bearer token authentication
- Hosted Payment Page — Customers pay on Pesapal's secure page (PCI SAQ A compliant)
- IPN Notifications — Real-time server-to-server payment status updates
- Sandbox/Production Toggle — Switch between test and live environments from the admin panel
- Configurable Order Statuses — Map Pesapal statuses (Completed, Failed, Reversed) to any CS-Cart order status
- Idempotent Callbacks — Duplicate callbacks and IPN notifications are safely ignored
- Secure by Design — SSL verification, sensitive data stripped from logs, parameterized queries
Supported Payment Methods
- M-Pesa — Kenya, Tanzania
- Airtel Money — Kenya, Uganda, Tanzania, Rwanda, Malawi, Zambia
- MTN Mobile Money — Uganda, Rwanda, Zambia
- Visa / Mastercard — All supported countries
- Bank Transfers — Select countries
Requirements
- CS-Cart or Multi-Vendor 4.x
- PHP 7.1 or higher
- Pesapal merchant account with API 3.0 credentials
- Store currency set to a supported Pesapal currency (KES, UGX, TZS, RWF, MWK, ZMW, or USD)
How It Works
- Customer selects Pesapal at checkout and clicks "Place Order"
- The addon authenticates with Pesapal and submits the order
- Customer is redirected to the Pesapal hosted payment page
- Customer selects their preferred payment method (M-Pesa, card, etc.) and completes payment
- Pesapal sends an IPN notification to your store and the customer is redirected back
- The addon verifies the payment status and updates the order
Installation
- Go to Add-ons > Manage add-ons, click Manual installation, and upload the addon zip
- Activate the addon and enter the license key
- Go to Administration > Payment methods and create a new payment method
- Select "Pesapal Payment Gateway" as the processor
- Enter your Consumer Key and Consumer Secret from the Pesapal merchant portal
- Register your IPN URL with Pesapal and enter the IPN ID
- Configure the default currency and order status mappings
- Save and test with sandbox mode before going live
Countries & Currencies
| Country | Currency |
|---|---|
| Kenya | KES (Kenyan Shilling) |
| Uganda | UGX (Ugandan Shilling) |
| Tanzania | TZS (Tanzanian Shilling) |
| Rwanda | RWF (Rwandan Franc) |
| Malawi | MWK (Malawian Kwacha) |
| Zimbabwe | USD (US Dollar) |
| Zambia | ZMW (Zambian Kwacha) |
