README

A Laravel package for integrating with the Geepay Gateway. Supports Mobile Money Collections, Disbursements, Hosted Checkout, and Access Token Management.

👤 Author

• Isaac Malemelo – @Malemelo

🙋 Support

For issues, bugs, or feature requests, please open an issue on GitHub:

https://github.com/Malemelo/geepay-laravel/issues

📦 Installation

Install via Composer:

composer require icode/geepay-laravel

Publish the configuration file:

php artisan vendor:publish --tag=config

⚙️ Configuration

Add the following environment variables in your .env file:

GEEPAY_BASE_URL=https://gateway.mygeepay.com
GEEPAY_CLIENT_ID=your_client_id
GEEPAY_CLIENT_SECRET=your_client_secret
GEEPAY_CALLBACK_URL=https://yourapp.com/api/geepay-callback

The config file will be published to config/geepay.php.

HOW TO USE THE PACKAGE

use Geepay\Facades\Geepay;

// Get token
$token = Geepay::auth()->generateAccessToken();

// Disbursement
$response = Geepay::disburse()->disburse($token, '260972439891', 100, 'Test pay', uniqid());

// Collection
$response = Geepay::collect()->requestToPay($token, '260972439891', 1000, uniqid());

// Checkout
$response = Geepay::checkout()->createSession($token, 1000, 'ORD-123', 'Nagato', 'nagato@example.com', uniqid());

🧰 Requirements

PHP >= 8.0

Laravel >= 8.x

Guzzle HTTP Client

📄 License

This package is open-sourced software licensed under the MIT license.