PHPackages                             ngoni/dischub-php - 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. ngoni/dischub-php

ActiveLibrary[API Development](/categories/api)

ngoni/dischub-php
=================

A Laravel package for integrating with Dischub API

02PHP

Since Mar 1Pushed 1y ago1 watchersCompare

[ Source](https://github.com/Ngoni-Sendama/dischub-php)[ Packagist](https://packagist.org/packages/ngoni/dischub-php)[ RSS](/packages/ngoni-dischub-php/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependenciesVersions (1)Used By (0)

[![Image](3step.png "3-step-image")](3step.png)

Dischub PHP Package for 3-Step
==============================

[](#dischub-php-package-for-3-step)

This package provides an easy way to integrate with Dischub's API for order creation and payment handling in Laravel applications.

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

[](#installation)

You can install the package using Composer:

```
composer require ngoni/dischub-php
```

If you encounter stability issues, install with:

```
composer require ngoni/dischub-php:dev-main
```

Then, publish the configuration file:

```
php artisan vendor:publish --provider="Ngoni\DischubPhp\DischubServiceProvider"
```

Configuration
-------------

[](#configuration)

After publishing, the configuration file is located at `config/dischub.php`. Update your `.env` file with:

```
DISCHUB_API_KEY=your_api_key_here
DISCHUB_NOTIFY_URL=https://yourdomain.com/dischub/callback
DISCHUB_RECIPIENT=your_recipient_email@example.com
```

Usage
-----

[](#usage)

### Import the Service in a Controller

[](#import-the-service-in-a-controller)

In your Laravel controller, you can use the `DischubService` to create an order and redirect the user to payment:

```
use Illuminate\Http\Request;
use Ngoni\DischubPhp\DischubService;

class OrderController extends Controller
{
    protected $dischubService;

    public function __construct(DischubService $dischubService)
    {
        $this->dischubService = $dischubService;
    }

    /**
     * Create an order and redirect to payment.
     */
    public function createOrder(Request $request)
    {
        $validated = $request->validate([
            'order_id'  => 'required|numeric',
            'sender'    => 'required|email',
            'amount'    => 'required|numeric|min:0.01|max:480',
            'currency'  => 'required|in:USD,ZWG',
        ]);

        $response = $this->dischubService->createOrder($validated);

        if ($response['status'] === 'success') {
            return redirect($this->dischubService->getPaymentUrl($validated['order_id']));
        }

        return back()->with('error', $response['message']);
    }
}
```

### Handling the Callback

[](#handling-the-callback)

Dischub will send a callback when a transaction is processed. Handle it in your controller:

```
use Illuminate\Http\Request;
use Illuminate\Support\Facades\Log;

class PaymentController extends Controller
{
    public function receiveDischubCallback(Request $request)
    {
        if ($request->isMethod('post')) {
            $data = json_decode($request->getContent(), true);
            Log::info('Dischub Callback Data:', $data ?? []);

            return response()->json([
                'message' => 'Callback received successfully',
                'data'    => $data ?? []
            ], 200);
        }

        return response()->json(['error' => 'Invalid request method'], 405);
    }
}
```

License
-------

[](#license)

This package is open-source and available under the [MIT License](LICENSE).

###  Health Score

15

—

LowBetter than 3% of packages

Maintenance34

Infrequent updates — may be unmaintained

Popularity2

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity15

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.

### Community

Maintainers

![](https://www.gravatar.com/avatar/925b82cad07d64d7a128aa21898e0194f8b29d16205bb76bf08e6f6675a2a04f?d=identicon)[Ngoni-Sendama](/maintainers/Ngoni-Sendama)

---

Top Contributors

[![Ngoni-Sendama](https://avatars.githubusercontent.com/u/108223064?v=4)](https://github.com/Ngoni-Sendama "Ngoni-Sendama (9 commits)")

### Embed Badge

![Health badge](/badges/ngoni-dischub-php/health.svg)

```
[![Health](https://phpackages.com/badges/ngoni-dischub-php/health.svg)](https://phpackages.com/packages/ngoni-dischub-php)
```

###  Alternatives

[stripe/stripe-php

Stripe PHP Library

4.0k143.3M480](/packages/stripe-stripe-php)[twilio/sdk

A PHP wrapper for Twilio's API

1.6k92.9M272](/packages/twilio-sdk)[knplabs/github-api

GitHub API v3 client

2.2k15.8M187](/packages/knplabs-github-api)[facebook/php-business-sdk

PHP SDK for Facebook Business

90121.9M34](/packages/facebook-php-business-sdk)[meilisearch/meilisearch-php

PHP wrapper for the Meilisearch API

73813.7M114](/packages/meilisearch-meilisearch-php)[google/gax

Google API Core for PHP

263103.1M454](/packages/google-gax)

PHPackages © 2026

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