knox2 / Pesapal by knox

A laravel package that integrates into the pesapal api
Package Data
Maintainer Username: knox
Maintainer Contact: (Timothy Radier)
Package Create Date: 2015-10-22
Package Last Update: 2024-03-14
Language: PHP
License: MIT
Last Refreshed: 2024-04-18 03:00:46
Package Statistics
Total Downloads: 57,728
Monthly Downloads: 1,064
Daily Downloads: 38
Total Stars: 25
Total Watchers: 9
Total Forks: 39
Total Open Issues: 0

Pesapal Laravel 5 API

Laravel 5 Package for the Pesapal API


Add this package using Composer

From the command line inside your project directory, simply type:

composer require knox/pesapal

Update your config

Add the service provider to the providers array in config/app.php:


Add the facade to the aliases array in config/app.php:

'Pesapal' => Knox\Pesapal\Facades\Pesapal::class,

Publish the package configuration

Publish the configuration file and migrations by running the provided console command:

php artisan vendor:publish --provider="Knox\Pesapal\PesapalServiceProvider"


Pesapal IPN

For the url of the route use /pesapal-ipn eg as the IPN on the Pesapal Merchant settings dashboard

Environmental Variables

PESAPAL_CONSUMER_KEY pesapal consumer key

PESAPAL_CONSUMER_SECRET pesapal consumer secret

PESAPAL_CURRENCY ISO code for the currency

PESAPAL_IPN controller method to call for instant notifications IPN as relative path from App\Http\Controllers\ eg "TransactionController@confirmation"

PESAPAL_CALLBACK_ROUTE route name to handle the callback eg Route::get('donepayment', ['as' => 'paymentsuccess', 'uses'=>'PaymentsController@paymentsuccess']); The route name is "paymentsuccess"

NB: The controller method accepts 4 function parameters, Example:

public function confirmation($trackingid,$status,$payment_method,$merchant_reference)
	$payments = Payments::where('tracking',$trackingid)->first();
    $payments -> payment_status = $status;
    $payments -> payment_method = $payment_method;
    $payments -> save();


live - Live or Demo environment

The ENV Variables can also be set from here.


At the top of your controller include the facade use Pesapal;

Example Code...Better Example..Haha

Assuming you have a Payment Model

use Pesapal;
use Illuminate\Http\Request;
use App\Http\Requests;
use Illuminate\Support\Facades\Auth;
use App\Payment;

class PaymentsController extends Controller
    public function payment(){//initiates payment
        $payments = new Payment;
        $payments -> businessid = Auth::guard('business')->id(); //Business ID
        $payments -> transactionid = Pesapal::random_reference();
        $payments -> status = 'NEW'; //if user gets to iframe then exits, i prefer to have that as a new/lost transaction, not pending
        $payments -> amount = 10;
        $payments -> save();

        $details = array(
            'amount' => $payments -> amount,
            'description' => 'Test Transaction',
            'type' => 'MERCHANT',
            'first_name' => 'Fname',
            'last_name' => 'Lname',
            'email' => '',
            'phonenumber' => '254-723232323',
            'reference' => $payments -> transactionid,
            //'currency' => 'USD'

        return view('', compact('iframe'));
    public function paymentsuccess(Request $request)//just tells u payment has gone thru..but not confirmed
        $trackingid = $request->input('tracking_id');
        $ref = $request->input('merchant_reference');

        $payments = Payment::where('transactionid',$ref)->first();
        $payments -> trackingid = $trackingid;
        $payments -> status = 'PENDING';
        $payments -> save();
        //go back home
        return view('', compact('payments'));
    //This method just tells u that there is a change in pesapal for your transaction..
    //u need to now query status..retrieve the change...CANCELLED? CONFIRMED?
    public function paymentconfirmation(Request $request)
        $trackingid = $request->input('pesapal_transaction_tracking_id');
        $merchant_reference = $request->input('pesapal_merchant_reference');
        $pesapal_notification_type= $request->input('pesapal_notification_type');

        //use the above to retrieve payment status now..
    //Confirm status of transaction and update the DB
    public function checkpaymentstatus($trackingid,$merchant_reference,$pesapal_notification_type){
        $payments = Payment::where('trackingid',$trackingid)->first();
        $payments -> status = $status;
        $payments -> payment_method = "PESAPAL";//use the actual method though...
        $payments -> save();
        return "success";

Example ENV


Example View

 {{ iframe }}

Example Routes

Relevant routes example, to help exclude entire webhooks route group in Csrf check in VerifyCsrfToken Middleware

Route::group(['prefix' => '/webhooks'], function () {
    Route::get('donepayment', ['as' => 'paymentsuccess', 'uses'=>'PaymentsController@paymentsuccess']);
    Route::get('paymentconfirmation', 'PaymentsController@paymentconfirmation');

All Done

Feel free to report any issues