CamPay Plugin for PhpNuxBill

CamPay STK Push Integration for PHPNUXBILL

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

Key Features
------------
✓ Seamless Mobile Payment Processing – Accept secure  payments via CamPay.
✓ 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 CamPay’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:
  - campay.php – Main payment integration class
  - initiatecampay.php – Handles the  request
  - campay.tpl – User interface template
  - README.md – This guide

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

  PHPNUXBILL/
  ├── paymentgateway/
  │   ├── campay.php
  │   └── ui/
  │       └── campay.tpl
  ├── plugin/
  │   └── initiatecampay.php

Folder Structure After Installation
-----------------------------------
PHPNUXBILL/
├── paymentgateway/
│   ├── campay.php
│   └── ui/
│       └── campay.tpl
├── plugin/
│   └── initiatecampay.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 flow
- If using firewalls or whitelisting, allow access to CamPay 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.campay.net

Enhance your PHPNUXBILL billing system with secure, reliable, and fast CamPay integration today!