Paystack Gateway for Magento 2

Key Features

Paystack gateway implemented as a Magento\Payment\Model\Method\Adapter with a di.xml command pool (authorize, capture, refund, void) — not a monolithic Payment model

Server-side transaction verification against /transaction/verify before order placement, preventing unpaid orders from abandoned tabs

Inline popup checkout (Paystack Inline JS) and redirect/standard flow, selectable per store view

Signed webhook controller validating the x-paystack-signature HMAC-SHA512 header for charge.success, transfer and refund reconciliation

Cards, bank transfer and USSD plus mobile money channels for Ghana and Kenya, with Apple Pay and QR where Paystack enables them on your account

Admin-initiated full and partial refunds via a Refund gateway command tied to Magento credit memos

Store-view-scoped configuration: test/live secret and public keys, supported currencies (NGN, GHS, ZAR, KES, USD) and allowed countries

Admin ACL resource so only permitted roles can edit gateway credentials and settings

GraphQL and REST exposure of the payment method for Hyvä, PWA Studio and headless storefronts

Order status and email automation: pending_payment to processing on verified capture, with configurable new-order status

Idempotent webhook and verification handling so duplicate Paystack events never double-process an order

Detailed gateway logging (sanitized, no raw keys) to var/log for traceable support and disputes

Built to order, done for you

No DIY setup — a working app, built, installed and supported by ECOSIRE.

You order

Start with a one-time build price. We scope it with you at kickoff.

We build & install

ECOSIRE builds, configures and installs it on your Magento 2.

Go live + support

You go live in about 2–4 weeks, with a post-launch support window.

About this Product

Paystack is the dominant card-and-alternative-payments gateway across Sub-Saharan Africa, but Magento 2 ships no native Paystack support and the community options are inconsistent across versions. ECOSIRE builds you a clean, production-grade Paystack integration as a proper Magento 2 module under app/code/Ecosire/Paystack, wired into the platform the right way — a Magento\Payment\Model\Method\Adapter gateway command pool, value handlers and a ConfigProvider for the checkout, not a bolted-on script.

Customers pay with Paystack cards, bank transfer, USSD and mobile money (Ghana and Kenya) through either an inline popup or a redirect flow. The module verifies every transaction server-side against the Paystack /transaction/verify endpoint before the Magento order is placed, so a closed browser tab never produces an unpaid "paid" order. A signed webhook controller (validating the x-paystack-signature HMAC-SHA512 header) reconciles charge.success, transfer and refund events out-of-band, and an admin-initiated Refund gateway command issues partial or full refunds back through the Paystack API with the credit-memo.

Because this is build-to-order, ECOSIRE tailors it to your store: test/live key handling via Magento\Config, store-view-scoped enable/disable, supported-currency and country restrictions (NGN, GHS, ZAR, KES, USD), min/max order rules, and admin ACL so only authorized roles change gateway settings. We support both Adobe Commerce and Magento Open Source, Luma and Hyvä themes, and can expose the method through GraphQL/REST for headless (PWA Studio) storefronts.

You are not downloading an unsupported zip. ECOSIRE writes the code, installs it on your environment, runs setup:upgrade and setup:di:compile, and stands behind it.

What you get

A complete, namespaced Magento 2 module (Ecosire_Paystack) delivered as source under app/code, with composer.json for composer-based installs

Installation on your environment by ECOSIRE: setup:upgrade, setup:di:compile, static content deploy and cache flush, verified in your staging or production

Admin configuration section under Stores > Configuration > Sales > Payment Methods, scoped by website/store view, with ACL

Webhook endpoint configured and tested end-to-end against your Paystack dashboard (test then live)

A test-mode walkthrough using Paystack test keys and test cards, plus a go-live checklist

Short technical handover doc (config reference, webhook URL, key rotation steps) and a recorded or live handover session

Who this is for

Nigerian / Ghanaian Magento merchant

Runs a Magento 2 Open Source store and needs local-trusted Paystack checkout (cards, bank transfer, USSD) instead of forcing customers through international gateways with high decline rates.

Cross-border African retailer

Sells across Nigeria, Ghana, South Africa and Kenya and needs one gateway handling multiple currencies and mobile money, configured per store view, without maintaining the integration in-house.

Adobe Commerce / agency lead developer

Wants a properly architected payment adapter (command pool, service contracts, ACL, webhook signature checks) they can review, extend and trust in code review — not a fragile community module.

How Paystack Gateway for Magento 2 Compares

Criterion	ECOSIRE	Custom Build	Competitor
Built, installed and supported by the vendor on your environment	Included	Partial support	Not included
Native Paystack support (cards, bank transfer, USSD, mobile money)	Included	Included	Included
Server-side verification plus signed webhook (HMAC-SHA512) reconciliation	Included	Partial support	Partial support
Proper payment adapter architecture (command pool, ACL, service contracts)	Included	Partial support	Partial support
Tailored to your currencies, store views, theme and headless storefront	Included	Included	Not included
Admin full/partial refunds tied to Magento credit memos	Included	Partial support	Partial support
GraphQL/REST exposure for PWA Studio / Hyvä headless	Included	Partial support	Not included
Fixed one-time price with no per-transaction license fee	Included	Not included	Partial support

Frequently Asked Questions about Paystack Gateway for Magento 2

How long does delivery take, and is this an instant Marketplace download?

This is build-to-order, not an instant Adobe Commerce Marketplace download. Typical delivery is about 5 to 10 business days from kickoff and access to your environment and Paystack account, depending on theme (Luma vs Hyvä), headless requirements and any custom currency or checkout rules. ECOSIRE writes the module, installs it, and verifies test then live transactions before handover.

Do I get ongoing support and updates after delivery?

Yes. The build includes a defined support and bug-fix window after go-live. Because we deliver the source as a real composer module, you own the code. We offer optional ongoing maintenance to keep it compatible as you upgrade Magento or Adobe Commerce versions and as Paystack changes its API or adds channels.

Which Magento and Adobe Commerce versions are supported?

We target current Magento 2 Open Source and Adobe Commerce releases (2.4.x and the current line) on supported PHP versions. Tell us your exact version at kickoff and we build and compile against it. We support Luma, Hyvä and headless (PWA Studio) storefronts.

How are payments verified so I never get an unpaid order marked as paid?

Every transaction is verified server-side against Paystack's /transaction/verify endpoint before the Magento order is finalized, and a signed webhook (x-paystack-signature HMAC-SHA512) reconciles events independently. Handling is idempotent, so an abandoned browser tab or a duplicate webhook never produces a false paid order or double-processes one.

Can it handle multiple currencies, mobile money and refunds from the admin?

Yes. We configure supported currencies (NGN, GHS, ZAR, KES, USD) and allowed countries per store view, enable Paystack channels available on your account including mobile money for Ghana and Kenya, and wire a Refund gateway command so your team issues full or partial refunds directly from Magento credit memos.