CartModules: Interswitch Webpay
Accept Interswitch Payments in Your CS-Cart Store
Integrate Interswitch Webpay — Nigeria's leading payment infrastructure provider — directly into your CS-Cart or Multi-Vendor store. Customers can pay using Verve, Visa, Mastercard, bank transfer, USSD, and QR code through a secure hosted payment page.
Key Features
- Interswitch Webpay Hosted Payment Page — Customers pay on Interswitch's secure page
- Multiple Payment Methods — Verve, Visa, Mastercard, bank transfer, USSD, QR code
- Redirect-Based Flow — No card data touches your server (PCI SAQ A compliant)
- SHA512 Hash Security — Form integrity verified with cryptographic hash
- Server-Side Verification — Transaction status confirmed via API query, not redirect params alone
- Amount Verification — Prevents partial payment attacks by verifying kobo amounts
- Sandbox/Production Toggle — Switch between test and live from the admin panel
- Three-Way Status Mapping — Map approved (00), pending (Z0/Z1), and failed to any CS-Cart status
- Idempotent Callbacks — Duplicate callbacks are safely ignored
- NGN Currency — Native Nigerian Naira support (amounts in kobo)
Requirements
- CS-Cart or Multi-Vendor 4.x
- PHP 7.1 or higher
- Interswitch merchant account with Webpay credentials (Product ID, Pay Item ID, MAC Key)
- Store currency set to NGN (Nigerian Naira)
How It Works
- Customer selects Interswitch at checkout and clicks “Place Order”
- The addon generates a SHA512 hash and auto-submits a form to Interswitch Webpay
- Customer pays on the Interswitch hosted payment page (card, bank, USSD, QR)
- After payment, customer is redirected back to your store
- The addon queries Interswitch's API to verify the transaction, then updates the order status
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 “Interswitch Webpay” as the processor
- Enter your Product ID, Pay Item ID, and MAC Key
- Configure order status mappings for approved, pending, and failed payments
- Save and test with sandbox mode before going live
Supported Payment Methods
- Verve cards (Nigeria's domestic card scheme)
- Visa cards
- Mastercard
- Bank transfer
- USSD banking
- QR code payments
Country & Currency
This addon is designed for merchants selling in Nigeria. Interswitch Webpay supports NGN (Nigerian Naira). Amounts are processed in kobo (1 NGN = 100 kobo) with currency code 566 (ISO 4217).
