CartModules: JazzCash Payment Gateway

Accept JazzCash Mobile Payments in Your CS-Cart Store

Integrate JazzCash -- Pakistan's leading mobile payment service by Jazz/Mobilink -- directly into your CS-Cart or Multi-Vendor store. Customers can pay using their JazzCash wallet, debit/credit cards, bank accounts, or vouchers through a secure hosted checkout flow.

Key Features

• JazzCash Hosted Checkout -- Customers pay via JazzCash wallet, cards, bank accounts, or vouchers
• Redirect-Based Flow -- No sensitive payment data touches your server (PCI SAQ A compliant)
• HMAC-SHA256 Verification -- All requests and responses are cryptographically signed for integrity
• Sandbox/Production Toggle -- Switch between test and live environments from the admin panel
• Configurable Order Statuses -- Map JazzCash statuses (Success, Pending, Failed) to any CS-Cart order status
• Auto-Submit Form -- Seamless redirect to JazzCash via secure POST form
• Idempotent Callbacks -- Duplicate callbacks are safely ignored
• PKR Currency -- Native Pakistani Rupee support with paisa conversion

Requirements

• CS-Cart or Multi-Vendor 4.x
• PHP 7.1 or higher
• JazzCash merchant account with API credentials (Merchant ID, Password, Integrity Salt)
• Store currency set to PKR (Pakistani Rupees)

How It Works

1. Customer selects JazzCash at checkout and clicks "Place Order"
2. The addon builds a signed form and auto-submits it to JazzCash
3. Customer completes payment on JazzCash's hosted page (wallet, card, bank, or voucher)
4. After payment, customer is redirected back to your store
5. The addon verifies the HMAC signature, maps the response code, and updates the order status

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 "JazzCash Payment Gateway" as the processor
5. Enter your Merchant ID, Password, and Integrity Salt from the JazzCash merchant portal
6. Configure order status mappings as desired
7. Save and test with sandbox mode before going live

Country & Currency

This addon is designed for merchants selling in Pakistan. JazzCash exclusively supports PKR (Pakistani Rupees). Ensure your store's primary currency is PKR.

Payment Methods Supported

• JazzCash Mobile Wallet
• Debit Cards
• Credit Cards
• Bank Accounts
• Voucher Payments