TopUp

A PHP-based web platform for purchasing game top-ups and recharges, with built-in user wallets, instant payment integration, and a full admin dashboard for managing games, orders, and transactions.

✨ Features

• 🎮 Game Top-Up Ordering — Browse games and place top-up/recharge orders (game_detail.php, order.php)
• 👤 User Accounts — Registration, login, logout, and profile management (login.php, logout.php, profile.php)
• 💰 Wallet System — Add funds to an in-app wallet balance (addmoney.php)
• ⚡ Instant Pay — Instant payment and wallet-based checkout support (instantpay.php, instantpay_wallet.php)
• 📜 Order & Payment History — Track past orders and payments (payment_history.php)
• 🔑 Redeem / Access Codes — Code-based feature for redeeming or applying codes (mycode.php)
• 🛠️ Admin Panel — Manage games, users, orders, and payments (admin/)
• 🔌 API Layer — Backend endpoints for app/site integrations (api/)
• 🧩 Shared Utilities — Common/shared code used across the app (common/)
• 📦 Easy Setup — Guided installer script and SQL schema included (install.php, database.sql)

🛠️ Tech Stack

• Backend: PHP
• Database: MySQL (database.sql)
• Frontend: HTML/CSS/JS (served via PHP views)
• CI: GitHub Actions (.github/workflows/)

📁 Project Structure

TopUp/
├── admin/                  # Admin dashboard (games, orders, users, payments)
├── api/                    # API endpoints
├── common/                 # Shared/reusable PHP code
├── uploads/                # Uploaded assets (e.g. game images, proofs)
├── .github/workflows/      # CI/CD workflows
├── database.sql            # Database schema
├── install.php             # Installation script
├── index.php                # Landing / home page
├── login.php / logout.php  # Authentication
├── profile.php              # User profile
├── game_detail.php          # Game details page
├── order.php                 # Place an order
├── addmoney.php              # Add funds to wallet
├── instantpay.php             # Instant payment handler
├── instantpay_wallet.php      # Instant pay via wallet
├── payment_history.php        # Payment history view
└── mycode.php                 # Redeem/access code feature

🚀 Getting Started

Prerequisites

• PHP 7.4+ (or compatible version)
• MySQL / MariaDB
• Apache/Nginx (or PHP's built-in server) with mod_rewrite if applicable

Installation

1. Clone the repository

   git clone https://github.com/Sujoyzz7/TopUp.git
   cd TopUp

2. Create a database and import the provided schema:

   mysql -u your_username -p your_database < database.sql

3. Configure database credentials in the relevant config file(s) used by the app (check common/ for connection settings).

4. Run the installer by visiting install.php in your browser, or configure manually.

5. Serve the app, e.g. with PHP's built-in server:

   php -S localhost:8000

6. Visit http://localhost:8000 in your browser.

⚠️ Note: Update this section with the exact configuration file name/path and any environment variables your setup requires, so new users can get running without guesswork.

🔐 Admin Access

The admin/ directory contains the dashboard for managing games, orders, users, and payments. Refer to the setup/installer for default admin credentials, and be sure to change them before deploying to production.

🤝 Contributing

Contributions are welcome!

1. Fork the repo
2. Create a feature branch (git checkout -b feature/your-feature)
3. Commit your changes (git commit -m 'Add some feature')
4. Push to the branch (git push origin feature/your-feature)
5. Open a Pull Request

📄 License

No license has been specified for this repository yet. Consider adding one (e.g. MIT, Apache 2.0) so others know how they can use your code.

📬 Contact

Maintained by Sujoyzz7. Feel free to open an issue for bugs, questions, or feature requests.