VibeFox Pesapal for Adobe Commerce

Overview

VibeFox Pesapal Pay Gateway adds Pesapal payments to Magento Open Source and Adobe Commerce. It connects to the Pesapal API 3.0. The customer chooses Pesapal at the payment step and clicks Place Order. Magento places the order in Pending Payment, and the customer is sent to the Pesapal payment page and pays there 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 invoiced only after Pesapal confirms the payment, and the order e-mail is sent only then.

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 module has no online refunds from Magento (refund in the Pesapal dashboard), no saved cards, no subscriptions or recurring payments, no payment form on your own site, no currency conversion and no payments for orders created in the Admin.

Key features

Paid only when Pesapal confirms: Pesapal notifications and the customer return carry no payment data and no signature, so the module never trusts them. Each time it asks Pesapal for the transaction status with an authenticated server-to-server request. The invoice carries the Pesapal tracking ID as the transaction ID.

Amount and currency check: the order is invoiced only when Pesapal reports Completed and the paid amount and currency match the order. A mismatch puts the order On Hold with a note and without an invoice.

Automatic IPN setup: the notification URL is registered with Pesapal at the first payment, separately for sandbox and live and for each consumer key. 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 invoice an order twice. Cancelled orders are not reopened, and a second payment for a paid cart is flagged for refund. A failed or cancelled payment cancels the waiting order and gives the cart back.

No blind second payment: before a new payment page is created, the earlier attempts of the cart are checked with Pesapal. If an earlier payment is paid or its result is uncertain, no new payment is started.

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

Reversals: when Pesapal reports the payment of an order as reversed, the module records an offline Credit Memo for the remaining amount. It never sends a refund itself.

Standard Magento settings: all settings are on the standard Payment Methods configuration page, with encrypted keys, the notification URL shown on the page, countries and minimum and maximum order totals, and an optional log without keys, tokens or customer contact data. The admin order page shows the tracking ID, mode, Pesapal status, all payment attempts of the cart and their notes.

Requirements

Magento Open Source or Adobe Commerce 2.4.6 to 2.4.9 (your own server or Adobe Commerce on cloud infrastructure; not Adobe Commerce as a Cloud Service), PHP 8.1 to 8.4. A Pesapal merchant account with the consumer key and consumer secret (sandbox and/or live). Your store must be reachable from the internet to receive payment notifications. Order currency: KES, UGX, TZS, ZMW, RWF or USD. A VibeFox license key from vibefox.net (one key per domain).