CartModules: Paystack Payment Gateway
Accept Paystack Payments in Your CS-Cart Store
Integrate Paystack -- Africa's leading payment gateway serving Nigeria, Ghana, South Africa, and Kenya -- directly into your CS-Cart or Multi-Vendor store. Customers complete payment through Paystack's secure hosted checkout supporting cards, bank transfers, USSD, mobile money, and more.
Key Features
- Dual Checkout Modes -- Choose between redirect (hosted page) or inline (popup) checkout
- On-Site Payment -- Inline mode keeps customers on your store during payment
- Apple Pay -- Accept Apple Pay payments via inline checkout
- Multi-Currency Support -- Accept NGN, GHS, ZAR, KES, and USD
- Redirect-Based Flow -- No sensitive data touches your server (PCI SAQ A compliant)
- Webhook Notifications -- HMAC-SHA512 signed webhooks for reliable payment confirmation
- Automatic Order Updates -- Transaction verified on customer return and via webhook
- Test/Live Mode -- Use test keys for sandbox or live keys for production
- Configurable Order Statuses -- Map Paystack statuses (success, failed) to any CS-Cart order status
- Amount Verification -- Confirms paid amount matches order total to prevent tampering
- Idempotent Callbacks -- Duplicate callbacks and webhooks are safely ignored
- Multiple Payment Methods -- Card, bank transfer, USSD, mobile money, QR via Paystack
Requirements
- CS-Cart or Multi-Vendor 4.x
- PHP 7.1 or higher
- Paystack account with API credentials (Public Key, Secret Key)
- Store currency set to a Paystack-supported currency (NGN, GHS, ZAR, KES, or USD)
Checkout Modes
- Redirect (Default) -- Customer is redirected to Paystack's secure hosted payment page
- Inline (Popup) -- Paystack InlineJS opens directly on your checkout page. Customer pays without leaving your store.
How It Works
- Customer selects Paystack at checkout and clicks "Place Order"
- The addon initializes a transaction with Paystack and obtains a payment URL
- In redirect mode: Customer is redirected to Paystack's hosted payment page
- In inline mode: Paystack popup appears on the checkout page
- Customer completes payment using their preferred method (card, bank transfer, USSD, mobile money)
- Customer is returned to your store (or popup closes)
- The addon verifies the transaction with Paystack and updates the order status
- Paystack also sends a webhook as backup confirmation
Installation
- Go to Add-ons > Manage add-ons, click Manual installation, and upload the addon zip
- Activate the addon and enter the license key
- Go to Administration > Payment methods and create a new payment method
- Select "Paystack Payment Gateway" as the processor
- Enter your Public Key and Secret Key from the Paystack Dashboard
- Copy the displayed Webhook URL into your Paystack Dashboard > Settings > API Keys & Webhooks
- Configure order status mappings as desired
- Save and test with test keys before going live
Supported Countries & Currencies
| Country | Currency |
|---|---|
| Nigeria | NGN (Nigerian Naira) |
| Ghana | GHS (Ghanaian Cedi) |
| South Africa | ZAR (South African Rand) |
| Kenya | KES (Kenyan Shilling) |
| International | USD (US Dollar) |
Security
- PCI SAQ A compliant -- no card data handled by your server
- HMAC-SHA512 webhook signature verification
- Amount verification prevents payment tampering
- Sensitive data stripped from all logs
- SSL/TLS enforced on all API communication
