VibeFox Pesapal for PrestaShop

Overview

VibeFox Pesapal Pay Gateway adds Pesapal payments to PrestaShop. It connects to the Pesapal API 3.0. At the payment step the customer chooses Pesapal, 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. The order is created only after Pesapal confirms the payment, so abandoned payments leave no unpaid orders.

It suits shops 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 module has no refunds from the order page (refund in the Pesapal dashboard), no saved cards, no subscriptions or recurring payments, no payment form on your own site and no currency conversion.

Key features

Paid only when Pesapal confirms: Pesapal notifications and the customer return carry no payment data, so the module 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 cart. A mismatch puts the order in Pesapal payment on hold with a note.

Automatic IPN setup: the notification URL is registered with Pesapal at the first payment, separately for sandbox and live. Nothing has to be set up in the Pesapal dashboard.

No double processing: repeated notifications and a notification arriving together with the customer return never create a second order. 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 cart, for example in a second browser tab, is still recognised.

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.

Pesapal block on the order page: tracking ID, merchant reference, mode, Pesapal status, payment method, confirmation code, all payment attempts and notes. Optional log without keys, tokens or customer data.

Requirements

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