PHPackages                             henryejemuta/php-clubkash-vtu - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. henryejemuta/php-clubkash-vtu

ActiveLibrary[API Development](/categories/api)

henryejemuta/php-clubkash-vtu
=============================

A PHP package for integrating with the ClubKash VTU API.

v0.0.1(4mo ago)022MITPHPPHP ^7.4 || ^8.0CI passing

Since Dec 25Pushed 4mo agoCompare

[ Source](https://github.com/henryejemuta/php-clubkash-vtu)[ Packagist](https://packagist.org/packages/henryejemuta/php-clubkash-vtu)[ RSS](/packages/henryejemuta-php-clubkash-vtu/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (1)Dependencies (3)Versions (2)Used By (0)

ClubKash VTU PHP Package
========================

[](#clubkash-vtu-php-package)

[![Run Tests](https://github.com/henryejemuta/php-clubkash-vtu/actions/workflows/run-tests.yml/badge.svg)](https://github.com/henryejemuta/php-clubkash-vtu/actions/workflows/run-tests.yml)[![Latest Stable Version](https://camo.githubusercontent.com/0ad8275241da75f579b01a75be003b3910285d387294d35f46391e0240af6787/68747470733a2f2f706f7365722e707567782e6f72672f68656e7279656a656d7574612f7068702d636c75626b6173682d7674752f762f737461626c65)](https://packagist.org/packages/henryejemuta/php-clubkash-vtu)[![Total Downloads](https://camo.githubusercontent.com/2d8d7ce63125f6b73cbc68e607729f3c683ce1b8cf76ef7105a56c31ea87ff51/68747470733a2f2f706f7365722e707567782e6f72672f68656e7279656a656d7574612f7068702d636c75626b6173682d7674752f646f776e6c6f616473)](https://packagist.org/packages/henryejemuta/php-clubkash-vtu)[![License](https://camo.githubusercontent.com/6d7a2426e734b5f6f3e16ab3e7e86b44222a02cd367042f6e6a4929380e594c9/68747470733a2f2f706f7365722e707567782e6f72672f68656e7279656a656d7574612f7068702d636c75626b6173682d7674752f6c6963656e7365)](https://packagist.org/packages/henryejemuta/php-clubkash-vtu)[![Quality Score](https://camo.githubusercontent.com/52fa714b70ef7d0fc62e7a017b0e81166717733f6be3b8869269bacfb168b5b1/68747470733a2f2f696d672e736869656c64732e696f2f7363727574696e697a65722f672f68656e7279656a656d7574612f7068702d636c75626b6173682d7674752e7376673f7374796c653d666c61742d737175617265)](https://scrutinizer-ci.com/g/henryejemuta/php-clubkash-vtu)

A robust PHP package for integrating with the ClubKash (Nellobytes Systems) VTU API. This package allows you to easily purchase airtime, data, cable TV, and electricity tokens.

Features
--------

[](#features)

- **Airtime Purchase**: Buy airtime for all major Nigerian networks.
- **Data Purchase**: Buy data bundles for all major Nigerian networks.
- **Cable TV Subscription**: Subscribe to DSTV, GOTV, and Startimes.
- **Electricity Bill Payment**: Pay for prepaid and postpaid electricity meters.
- **Wallet Balance**: Check your wallet balance.
- **Universal Compatibility**: Works with Laravel, CodeIgniter, Symfony, and raw PHP projects.

Installation
------------

[](#installation)

You can install the package via composer:

```
composer require henryejemuta/php-clubkash-vtu
```

Usage
-----

[](#usage)

### Initialization

[](#initialization)

To start using the package, initialize the `Client` with your UserID, API Key, and optional configuration. You can also pass an existing `token` if available to skip initial authentication.

```
use HenryEjemuta\Clubkash\Client;

$config = [
    'timeout' => 30,
    // 'token' => 'YOUR_CACHED_TOKEN', // Optional: Reuse valid token
];

$client = new Client('YOUR_USER_ID', 'YOUR_API_KEY', $config);
```

### Authentication (Token Generation)

[](#authentication-token-generation)

The API supports token-based authentication. Tokens are valid for 7 days. It is recommended to cache the token and reuse it.

```
// Authenticate to get a new token
$authResponse = $client->authenticate();
if (isset($authResponse['token'])) {
    $token = $authResponse['token'];
    // Store $token in your database/cache with expiry
}
```

### Check Wallet Balance

[](#check-wallet-balance)

```
try {
    $balance = $client->getWalletBalance();
    print_r($balance);
} catch (\Exception $e) {
    echo "Error: " . $e->getMessage();
}
```

### Airtime Purchase

[](#airtime-purchase)

```
// Network Codes: 01=MTN, 02=GLO, 03=9Mobile, 04=Airtel
$response = $client->purchaseAirtime('01', 100.00, '08012345678');
print_r($response);
```

### Data Purchase

[](#data-purchase)

```
// Data Plan Code: Get from ClubKash Documentation or use verify tool
$response = $client->purchaseData('01', 'DATA_PLAN_CODE', '08012345678');
print_r($response);
```

### Cable TV Subscription

[](#cable-tv-subscription)

```
// CableTV: 'dstv', 'gotv', 'startimes'
$response = $client->purchaseCableTV('dstv', 'package_code', 'IUC_NUMBER', 'PHONE_NUMBER');
print_r($response);
```

### Electricity Payment

[](#electricity-payment)

```
// ElectricCompany: '01', '02', etc. MeterType: '01' (Prepaid), '02' (Postpaid)
$response = $client->purchaseElectricity('01', 'METER_NUMBER', '01', 1000.00, 'PHONE_NUMBER');
print_r($response);
```

API Documentation
-----------------

[](#api-documentation)

For full API documentation, please refer to the [Nellobytes Systems API](https://www.nellobytesystems.com/).

Testing
-------

[](#testing)

```
composer test
```

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE) for more information.

###  Health Score

31

—

LowBetter than 68% of packages

Maintenance75

Regular maintenance activity

Popularity9

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity29

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

139d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/54673a3d375309540e1831b2827b8bf499d048dfe3cdb56193cf575c4105d85f?d=identicon)[henryejemuta](/maintainers/henryejemuta)

---

Top Contributors

[![henryejemuta](https://avatars.githubusercontent.com/u/13375596?v=4)](https://github.com/henryejemuta "henryejemuta (5 commits)")

###  Code Quality

TestsPHPUnit

Code StylePHP CS Fixer

### Embed Badge

![Health badge](/badges/henryejemuta-php-clubkash-vtu/health.svg)

```
[![Health](https://phpackages.com/badges/henryejemuta-php-clubkash-vtu/health.svg)](https://phpackages.com/packages/henryejemuta-php-clubkash-vtu)
```

###  Alternatives

[tencentcloud/tencentcloud-sdk-php

TencentCloudApi php sdk

3731.2M42](/packages/tencentcloud-tencentcloud-sdk-php)[convertkit/convertkitapi

Kit PHP SDK for the Kit API

2167.1k1](/packages/convertkit-convertkitapi)[mapado/rest-client-sdk

Rest Client SDK for hydra API

1125.9k2](/packages/mapado-rest-client-sdk)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)