VibeFox Paystack for Adobe Commerce

Overview

VibeFox Paystack Payment adds Paystack payments to Magento Open Source and Adobe Commerce. The customer chooses Paystack at the payment step and clicks Place Order. Magento places the order in Pending Payment, and the customer goes to the secure Paystack hosted checkout page and pays with any channel enabled on your Paystack account, such as cards, bank transfer, USSD or mobile money. Card data never touches your site. The order is invoiced only after Paystack confirms the payment, and the order e-mail is sent only then.

It suits stores that sell in NGN, USD, GHS, ZAR, KES, XOF, EGP or RWF and have a Paystack account. Only the secret keys are needed. The module has no inline or popup payment form (redirect only), no saved cards, no subscriptions, no split payments or subaccounts, no choice of payment channels and no payments for orders created in the Admin.

Key features

Paid only when Paystack confirms: neither the customer return nor the webhook body is trusted. The module reads the transaction from the Paystack API on the server and checks its reference, status, amount and currency against the order.

Signed webhooks: Paystack signs every webhook with your secret key, so there is no extra secret to set up. Bank transfer and USSD payments that complete later are confirmed by the webhook, and Paystack retries it after temporary errors.

Amount and currency check: a mismatch puts the order On Hold with a note and without an invoice. Paystack fees passed to the customer are supported.

No double processing: the customer return and the webhook can arrive at the same moment without a second invoice. A cancelled or failed payment cancels the waiting order and gives the cart back. A second payment for a paid order is flagged for refund.

Test and live modes: separate secret keys. The settings page warns about a missing key, a test key in live mode, a live key in test mode or a public key in a secret key field, and hides the payment method until it is fixed.

Online refunds with Credit Memo: full and partial refunds through the standard Magento Credit Memo of the invoice with Refund, always to the paying transaction and in the mode (test or live) it was made in. Payments held after a mismatch can be refunded from the order page in the amount Paystack actually charged.

Paystack block on the order page: every payment attempt with reference, mode, channel and card, the refund history and the Paystack notes of the order.

Standard Magento settings: all settings are on the standard Payment Methods configuration page, with encrypted keys, the webhook URL shown on the page, countries and minimum and maximum order totals, and a log without keys or customer data.

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 Paystack account with test and/or live secret keys. Order currency: NGN, USD, GHS, ZAR, KES, XOF, EGP or RWF, as enabled on your Paystack account. A VibeFox license key from vibefox.net (one key per domain).