CartModules: Network International (N-Genius) Payment Gateway

Accept Payments in the UAE, Middle East & Africa with N-Genius Online

Integrate Network International -- the leading payment processor in the UAE, Middle East, and Africa -- directly into your CS-Cart or Multi-Vendor store. Customers pay using Visa, Mastercard, AMEX, mada, Apple Pay, Samsung Pay, and UnionPay through a secure hosted payment page powered by N-Genius Online.

Key Features

• N-Genius Online Hosted Payment Page -- Customers pay on a secure, PCI-compliant page hosted by Network International
• Multi-Currency Support -- AED, SAR, BHD, KWD, OMR, QAR, EGP, USD, EUR, GBP
• 3-Decimal Currency Handling -- Correct minor unit conversion for BHD, KWD, and OMR (x1000)
• Sale & Auth Modes -- Choose between immediate capture (Sale) or authorize-then-capture (Auth)
• Redirect-Based Flow -- No sensitive card data touches your server (PCI SAQ A compliant)
• Automatic Order Updates -- Order status updated based on N-Genius payment result
• Sandbox/Production Toggle -- Switch between UAT and live environments from the admin panel
• Configurable Order Statuses -- Map N-Genius statuses (Captured, Authorised, Failed, Cancelled) to any CS-Cart order status
• Bearer Token Authentication -- Secure JWT-based API communication with fresh tokens per transaction
• Idempotent Callbacks -- Duplicate callbacks are safely ignored
• Comprehensive Logging -- Detailed payment logs with sensitive data redacted

Supported Payment Methods

• Visa
• Mastercard
• American Express (AMEX)
• mada (Saudi Arabia debit network)
• Apple Pay
• Samsung Pay
• UnionPay

Requirements

• CS-Cart or Multi-Vendor 4.x
• PHP 7.1 or higher
• Network International merchant account with N-Genius Online API credentials
• API Key and Outlet Reference ID from the N-Genius merchant portal

How It Works

1. Customer selects Network International at checkout and clicks "Place Order"
2. The addon obtains a Bearer token and creates a payment order via the N-Genius API
3. Customer is redirected to the N-Genius hosted payment page
4. Customer completes payment using their preferred method (card, Apple Pay, etc.)
5. N-Genius redirects the customer back to your store
6. The addon verifies the payment status via API and updates the order

Installation

1. Go to Add-ons > Manage add-ons, click Manual installation, and upload the addon zip
2. Activate the addon and enter the license key
3. Go to Administration > Payment methods and create a new payment method
4. Select "Network International (N-Genius)" as the processor
5. Enter your API Key and Outlet Reference ID from the N-Genius merchant portal
6. Select the transaction currency and payment action (Sale or Auth)
7. Configure order status mappings as desired
8. Save and test with UAT sandbox mode before going live

Countries & Currencies

This addon is designed for merchants in the UAE, Saudi Arabia, Bahrain, Kuwait, Oman, Qatar, Egypt, and other regions served by Network International. Supported currencies include AED, SAR, BHD, KWD, OMR, QAR, EGP, USD, EUR, GBP. Currencies with 3 decimal places (BHD, KWD, OMR) are handled correctly with proper minor unit conversion.