Bring Paystack, one of Africa's leading payment platforms, directly into your EasyCommerce store. This add-on lets your customers pay with the methods they already trust — credit and debit cards, bank transfer, USSD, and mobile money — through Paystack's secure, mobile-friendly checkout, without the friction of a clunky payment flow.

Built natively for EasyCommerce, the addon registers Paystack as a first-class payment method at checkout, initializes each transaction through the Paystack API, verifies every payment on your server before completing the order, and keeps your order statuses in sync automatically. Whether you are testing in sandbox mode or going live, the entire flow is wired up for you out of the box.

Key Benefits of EasyCommerce Paystack Addon

1. Simple, Secure Key-Based Setup

No complicated connection steps - just paste your Paystack API keys and start selling. The addon keeps your test and live credentials separate, hides your secret keys behind password fields, and lets you move between environments with a single Test Mode switch.

• Separate Test and Live key pairs (secret and public) stored independently
• Secret keys masked as password fields — never exposed in the browser
• One Test Mode toggle switches the whole gateway between test and live keys

2. Flexible Checkout - Redirect or Inline Popup

Choose how your customers pay. Send them to Paystack's secure hosted page, or keep them on your store with Paystack's inline payment popup. Either way, the experience is fast, mobile-ready, and fully branded to Paystack's trusted checkout.

• Redirect mode sends the customer to Paystack's hosted payment page
• Inline mode opens Paystack's payment popup right on your checkout - no redirect
• Switch between the two from a single dropdown; no code required

3. Verified, Tamper-Proof Payments

Security is built into every step. The addon never trusts the browser or the webhook body alone — each payment is verified directly with Paystack, and the amount charged is matched against the order total before the order is ever marked as paid.

• Every transaction is re-verified server-side through the Paystack Verify API
• Amount-match guard rejects any payment that does not equal the order total
• Failed, unverified, or mismatched payments are marked failed, never silently completed

4. Real-Time Webhook Synchronization

The addon exposes a dedicated, signature-verified webhook endpoint that listens for Paystack events, so your order statuses stay accurate even if a customer closes the browser before returning to your store.

• Listens for Paystack's charge.success event
• Webhook signatures verified with HMAC-SHA512 before anything is processed
• Idempotent handling skips duplicate deliveries, with automatic status updates and audit logs

5. Built-In Refund Support

Issue full or partial refunds straight from your EasyCommerce order screen. The addon talks to the Paystack Refund API, records the refund against the order, and writes it back into EasyCommerce so your totals always reconcile.

• Full and partial refunds processed through the Paystack Refund API
• Refund IDs stored against the order for easy reconciliation
• Refunds recorded in EasyCommerce so refunded totals stay accurate

6. Test Mode and Flexible Configuration

Try everything safely before you go live. A single toggle switches the gateway into test mode using your Paystack test keys, and the rest of the gateway bends to fit your store.

• Test (sandbox) mode for safe end-to-end testing
• Configurable default order status - pending, processing, or completed
• Custom payment-method name and logo shown at checkout
• Multi-currency support with correct subunit handling (NGN, USD, GHS, ZAR, KES, XOF, EGP, RWF)

Getting Started

Note: This addon requires the EasyCommerce plugin to be installed and active, plus an active Paystack account with API keys.

Step 1: Install the EasyCommerce Paystack add-on, activate it, and enable Paystack from your payment methods under EasyCommerce > Settings > Payment > Methods.

Step 2: Fill in the name, display image, and checkout settings [Redirect (hosted page) or Inline (popup)] — and confirm your store currency is one Paystack supports.

Step 3:  Get your API keys from your Paystack Dashboard (Settings > API Keys & Webhooks).

Step 4: Now paste your Secret Key and Public Key into the gateway settings. At the same time, copy the webhook URL from this settings page and paste in your Paystack Dashboard (Settings > API Keys & Webhooks) page.

This should do the work. Now start accepting card, bank transfer, USSD, and mobile money payments in minutes — add your Paystack keys and go live.