KopoKopo Plugin for PhpNuxBill

KopoKopo STK Push Integration for PHPNUXBILL

Overview
---------
Easily integrate KopoKopo STK Push into PHPNUXBILL with this robust and developer-friendly solution. 
This integration allows your billing system to accept mobile money payments seamlessly via KopoKopo, 
streamlining your collection process within PHPNUXBILL.

Key Features
------------
✓ Seamless Mobile Payment Processing – Accept secure STK Push payments via KopoKopo.  
✓ Easy Setup – Minimal configuration needed to get started.  
✓ Fully Compatible – Supports PHP 5.6 and above.  
✓ User-Friendly – Organized file structure and simple implementation steps.  
✓ Secure – Safe and encrypted transaction handling with KopoKopo’s OAuth and till-based system.

Installation Guide
------------------
Prerequisites:
- PHP 5.6 or higher  
- CreateHotspotUser.php in your PHPNUXBILL root directory  
 (Don’t have it? Contact support at 0113015674)

Step-by-Step Installation
-------------------------
1. Unzip the provided integration package  
  Inside, you’ll find:
  - kopokopo.php – Main payment integration class  
  - initiatekopokopo.php – Handles the STK Push request  
  - kopokopo.tpl – User interface template  
  - README.md – This guide

2. File Placement – Place the files into the correct PHPNUXBILL folders:

  PHPNUXBILL/
  ├── paymentgateway/
  │   ├── kopokopo.php
  │   └── ui/
  │       └── kopokopo.tpl
  ├── plugin/
  │   └── initiatekopokopo.php

Folder Structure After Installation
-----------------------------------
PHPNUXBILL/
├── paymentgateway/
│   ├── kopokopo.php
│   └── ui/
│       └── kopokopo.tpl
├── plugin/
│   └── initiatekopokopo.php

Additional Notes
----------------
- Make sure to set correct file permissions (644 for files, 755 for folders)  
- Test the integration before going live to confirm the callback and STK flow  
- If using firewalls or whitelisting, allow access to Kopokopo endpoints  

Best Practices
--------------
- Version Control: Use Git or similar tools to track your changes  
- Backups: Always back up your system before making changes  
- Security: Keep your API credentials safe and never expose them publicly  

Need Help?
----------
📞 Call/WhatsApp: 0113015674  
📧 Email: [email protected]  
🌐 Visit: https://developer.kopokopo.com  

Enhance your PHPNUXBILL billing system with secure, reliable, and fast KopoKopo STK Push integration today!