VibeFox Pesapal for WooCommerce

Overview

Pesapal Pay Gateway adds Pesapal payments to WooCommerce. It connects to the Pesapal API 3.0. After placing the order, the customer is sent to the Pesapal payment page and pays with M-Pesa, Airtel Money, MTN, card, bank or another method Pesapal offers in the customer's country. Card data never touches your site.

It suits stores in Kenya, Uganda, Tanzania, Rwanda, Zambia, Malawi and Zimbabwe that sell in KES, UGX, TZS, ZMW, RWF or USD and have a Pesapal merchant account. Only the consumer key and secret are needed. The plugin has no refunds from the WooCommerce order screen (refund in the Pesapal dashboard), no saved cards, no subscriptions or recurring payments, no payment form on the checkout page itself and no currency conversion.

Key features

Paid only when Pesapal confirms: Pesapal notifications and the customer return carry no payment data, so the plugin never trusts them. Each time it asks Pesapal for the transaction status with an authenticated server-to-server request.

Amount and currency check: the order is marked paid only when Pesapal reports Completed and the paid amount and currency match the order. A mismatch puts the order on hold with a note.

Automatic IPN setup: the notification URL is registered with Pesapal at the first payment, separately for sandbox and live.

No double processing: repeated notifications and a notification arriving together with the customer return do not create duplicate notes, e-mails or stock changes. Cancelled and refunded orders are never reopened, and a second payment for a paid order is flagged for refund.

Every attempt is remembered: a payment made on an older Pesapal page of the same order, for example in a second browser tab, is still recognised. Failed attempts are noted on the order with the reason from Pesapal.

Sandbox and live modes: separate keys for each mode. A payment is always checked in the mode it was started in.

Reversals: a payment that Pesapal reports as reversed sets the paid order to Refunded.

Modern WooCommerce: classic checkout, Checkout block, the Pay for order page, HPOS. Logs without keys, tokens or customer data. Swahili translation included.

Requirements

WordPress 6.2 or later, WooCommerce 8.0 or later, PHP 8.0 or later. A Pesapal merchant account with the consumer key and consumer secret (sandbox and/or live). Your site must be reachable from the internet to receive payment notifications. Store currency: KES, UGX, TZS, ZMW, RWF or USD. A VibeFox license key from vibefox.net (one key per domain).