WHMCS Automated Easypaisa Payment Gateway & Admin Manager Module

# 🚀 WHMCS Automated Easypaisa Payment Gateway & Admin Manager

Streamline your WHMCS billing with the ultimate **Easypaisa Payment Gateway & Management System** by CodeStar. Automatically verify customer transactions, match Trx IDs, and mark invoices as **PAID** in real-time via Android App Push Notifications and 3737 SMS webhooks!

---

### 🔥 Key Features

- ⚡ **Instant Automatic Verification:** Real-time invoice matching using Easypaisa App Push Notifications & 3737 SMS forwarder webhooks.
- 💵 **Automated USD to PKR Conversion:** Converts USD invoices to whole PKR amounts using customizable exchange rates.
- 🔢 **Unique Amount Generator:** Assigns rounded integer PKR amounts to prevent payment ambiguity.
- 📱 **Customer Payment Checkout:** Professional, dark-themed responsive checkout page with copy buttons for account title, mobile number, and exact PKR amount.
- 🖼️ **Screenshot & Trx ID Upload:** Customers can upload transaction receipts (JPG, PNG, WEBP) and enter 10-12 digit Trx IDs.
- 📊 **Comprehensive Admin Manager Addon:** Dedicated WHMCS admin dashboard to search, filter, audit, approve, or reject pending payments.
- 🛡️ **Built-in CodeStar License Guard:** Domain locking and 24-hour local JSON caching for secure distribution.
- 🔄 **1-Click Auto-Updater:** Integrated 1-Click Auto-Updater & manual `.zip` download SDK for seamless future updates.
- 🔒 **Security & CSRF Protection:** Protected against duplicate Trx ID submissions and CSRF attacks.

---

### 🛠️ What's Included in the Download

- `modules/addons/easypaisa_manager/` (Admin Dashboard & License/Updater SDKs)
- `modules/gateways/easypaisa.php` (Payment Gateway Integration)
- `modules/gateways/callback/easypaisa.php` (Webhook Callback Handler)
- `modules/gateways/easypaisa/` (Checkout Page, Status Checker, DB Installer & Cron)
- Full Documentation & Setup Guide

---

### 📋 Requirements

- WHMCS v8.x or higher
- PHP 7.4 / 8.0 / 8.1 / 8.2 / 8.3
- cURL & ZipArchive PHP Extensions enabled
- Android Phone with MacroDroid or Notification Forwarder app (for automated SMS/Notification forwarder)