JazzCash Payment Gateway for WHMCS — Auto SMS & App Notification Verification

🔴 JazzCash Payment Gateway for WHMCS — by CodeStar

Accept JazzCash mobile wallet payments directly inside WHMCS with 100% automated
payment verification — no manual checking required!

This premium gateway uses a smart MacroDroid Android webhook to capture real-time
JazzCash 8558 SMS alerts and App push notifications, then automatically matches
them to pending invoices and marks them as PAID — all without any human involvement.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🚀 KEY FEATURES
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

✅ Automated Payment Verification
Instantly matches incoming JazzCash SMS/notifications to invoices.
No manual approval needed — payments are auto-confirmed in seconds.

📲 MacroDroid Android Webhook Support
Easy setup guide included. Forward JazzCash 8558 SMS and App notifications
to WHMCS using MacroDroid's HTTP POST action. Zero coding required.

🎨 Beautiful Checkout UI
Premium red-themed checkout page built with Outfit Google Font, smooth
animations, and a fully mobile-responsive design. One-tap Copy button
for the JazzCash number.

📊 Admin Transaction Dashboard
Full-featured JazzCash Manager Addon Module with:
- Stats cards (Total / Pending / Approved / Rejected)
- Advanced search and filters (Trx ID, Invoice ID, Status)
- Paginated transaction logs (25 per page)
- Screenshot viewer for receipt images
- Manual Approve / Reject buttons with WHMCS invoice auto-update

🔒 CodeStar License Protection
Integrated license verification via CodeStar API with 24-hour local
caching. Domain-locked. Revocation supported.

🔄 1-Click Auto-Updater
Built-in update checker and one-click installer. If auto-extraction fails,
a direct manual .zip download link is always available.

📷 Screenshot Upload Support
Customers can optionally upload a JazzCash receipt screenshot at checkout
for manual verification fallback. Supports JPG, PNG, WEBP (max 5MB).

🔐 CSRF Protection
All form submissions are protected with CSRF tokens.

💱 USD to PKR Auto Conversion
Configure your exchange rate in WHMCS settings. USD invoices are
automatically converted to PKR at checkout.

⚡ Real-Time Status Check Button
Customers can click "Check Payment Status Now" on the checkout page
for instant AJAX verification without page reload.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📂 INCLUDED FILES
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

modules/
├── gateways/
│ ├── jazzcash.php ← Gateway config & Pay button
│ ├── jazzcash/
│ │ ├── pay.php ← Checkout UI page
│ │ ├── check_status.php ← AJAX payment status endpoint
│ │ ├── functions.php ← SMS/Notification parsers
│ │ └── db.php ← Database schema installer
│ └── callback/
│ └── jazzcash.php ← Webhook & form submission handler
└── addons/
└── jazzcash_manager/
├── jazzcash_manager.php ← Admin dashboard addon
├── license/
│ └── LicenseVerifier.php ← CodeStar License SDK
└── updater/
└── CodeStarUpdater.php ← 1-Click Auto-Updater SDK

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
⚙️ SETUP INSTRUCTIONS (5 Minutes)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

STEP 1 — Upload Files
Upload the extracted zip to your WHMCS root directory.
All files go inside /modules/gateways/ and /modules/addons/.

STEP 2 — Activate Gateway
Go to: WHMCS Admin → Setup → Payments → Payment Gateways
Find "JazzCash (CodeStar)" → Click Activate.
Fill in: Account Title, JazzCash Mobile Number, USD to PKR Rate.

STEP 3 — Activate Addon Module
Go to: WHMCS Admin → Setup → Addon Modules
Find "JazzCash Payment Manager (CodeStar)" → Click Activate.
Enter your CodeStar Purchase Code to enable the admin dashboard.

STEP 4 — Setup MacroDroid (Android)
Install MacroDroid on any Android phone logged into your JazzCash account.
Trigger: SMS Received from 8558 OR Notification from JazzCash App
Action: HTTP POST → Your Webhook URL → JSON body with notification_text
(Full A-Z MacroDroid setup guide shown inside the Admin Dashboard)

STEP 5 — Done!
Customers can now pay via JazzCash. Payments are auto-verified in seconds.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🛡️ REQUIREMENTS
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

• WHMCS 8.x (tested on 8.6+)
• PHP 7.4 or higher (PHP 8.x recommended)
• cURL extension enabled
• ZipArchive extension (for 1-Click Updater)
• Android phone with MacroDroid + JazzCash App or 8558 SMS enabled
• Outbound HTTPS to codestar.pk (for license verification)

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
💬 SUPPORT
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Developer: CodeStar
Website: https://codestar.pk
WhatsApp: 03287112364
Response: Within a few hours (Pakistan Time)