PAYBILL TILL BANK STK PUSH Plugin for PhpNuxBill

# HOW TO INSTALL AND RUN PAYBILL TILL BANK STK PUSH ON PHPNUXBILL

## Introduction

This is a simple PHP script that demonstrates how to integrate with the Paybill Till Bank STK Push API. The script allows you to initiate a payment request and handle the response from the API.

The script is designed to be used with PHPNUXBILL, a popular billing and invoicing software. It provides a user-friendly interface for managing payments and transactions.

## Requirements

1. PHP 5.6 or higher

2. Make sure you have the file : CreateHotspotUser.php in the root directory of your PHPNUXBILL installation.if you don't have it, contact 0113015674

## Installation

1. After unzipping the folder, you will find the following files:

    - `paybilltillsbankmpesa.php` - The main file

    - `initiatepaybilltillsbankmpesa.php` - The file that initiates the STK push

    - `paybilltillsbankmpesa.tpl` - The template file

    - `README.md` - This file

## File Placement

1. Navigate to your PHPNUXBILL directory.

2. Place the files in the specified locations as shown below:

   - **`paybilltillsbankmpesa.php`**: Move this file to the `paymentgateway` folder.

   - **`initiatepaybilltillsbankmpesa.php`**: Move this file to the `plugin` folder.

   - **`paybilltillsbankmpesa.tpl`**: Move this file to the `paymentgateway > ui` folder.

## Folder Structure After Placement

PHPNUXBILL/

├── paymentgateway/

│   ├── paybilltillsbankmpesa.php

│   ├── ui/

│       ├── paybilltillsbankmpesa.tpl

├── plugin/

│   ├── initiatepaybilltillsbankmpesa.php
 

## Additional Notes

- Ensure the file permissions are correctly set for your environment.

- Test the integration thoroughly after placing the files.

- Refer to the official PHPNUXBILL documentation if you encounter issues.

Best practices for managing custom integrations:

- **Version Control**: Commit changes to your version control system.

- **Backups**: Keep a backup of your PHPNUXBILL directory before adding new files.

Feel free to reach out for support or open an issue if you face any challenges!