Laravel payment processor package for FreeKassa gateway

Latest Stable Version Build Status StyleCI CodeFactor Total Downloads License

Accept payments via FreeKassa ( using this Laravel framework package (Laravel).

  • receive payments, adding just the two callbacks

Laravel >= 8.*, PHP >= 7.3

To use the package for Laravel 7.* use the 3.x branch

To use the package for Laravel 6.* use the 2.x branch

To use the package for Laravel 5.* use the 1.x branch


Require this package with composer.

composer require maksa988/laravel-freekassa

If you don't use auto-discovery, add the ServiceProvider to the providers array in config/app.php


Add the FreeKassa facade to your facades array:

'FreeKassa' => Maksa988\FreeKassa\Facades\FreeKassa::class,

Copy the package config to your local config with the publish command:

php artisan vendor:publish --provider="Maksa988\FreeKassa\FreeKassaServiceProvider"


Once you have published the configuration files, please edit the config file in config/freekassa.php.

  • Create an account on

  • Add your project, copy the project_id, secret_key and secret_key_second params and paste into config/freekassa.php

  • After the configuration has been published, edit config/freekassa.php

  • Set the callback static function for searchOrder and paidOrder

  • Create route to your controller, and call FreeKassa::handle method


  1. Generate a payment url or get redirect:
$amount = 100; // Payment`s amount

$url = FreeKassa::getPayUrl($amount, $order_id);

$redirect = FreeKassa::redirectToPayUrl($amount, $order_id);

You can add custom fields to your payment:

$rows = [
    'time' => Carbon::now(),
    'info' => 'Local payment'

$url = FreeKassa::getPayUrl($amount, $order_id, $email, $phone, $rows);

$redirect = FreeKassa::redirectToPayUrl($amount, $order_id, $email, $phone, $rows);

$email and $phone can be null.

  1. Process the request from FreeKassa:
    FreeKassa::handle(Request $request)


You must define callbacks in config/freekassa.php to search the order and save the paid order.

'searchOrder' => null  // [email protected](Request $request)
'paidOrder' => null  // [email protected](Request $request, $order)


The process scheme:

  1. The request comes from GET / POST (with params).
  2. The function[email protected] runs the validation process (auto-validation request params).
  3. The method searchOrder will be called (see config/freekassa.php searchOrder) to search the order by the unique id.
  4. If the current order status is NOT paid in your database, the method paidOrder will be called (see config/freekassa.php paidOrder).

Add the route to routes/web.php:

 Route::get('/freekassa/result', '[email protected]');

Note: don't forget to save your full route url (e.g. ) for your project on

Create the following controller: /app/Http/Controllers/FreeKassaController.php:

class FreeKassaController extends Controller
     * Search the order in your database and return that order
     * to paidOrder, if status of your order is 'paid'
     * @param Request $request
     * @param $order_id
     * @return bool|mixed
    public function searchOrder(Request $request, $order_id)
        $order = Order::where('id', $order_id)->first();

        if($order) {
            $order['_orderSum'] = $order->sum;

            // If your field can be `paid` you can set them like string
            $order['_orderStatus'] = $order['status'];

            // Else your field doesn` has value like 'paid', you can change this value
            $order['_orderStatus'] = ('1' == $order['status']) ? 'paid' : false;

            return $order;

        return false;

     * When paymnet is check, you can paid your order
     * @param Request $request
     * @param $order
     * @return bool
    public function paidOrder(Request $request, $order)
        $order->status = 'paid';


        return true;

     * Start handle process from route
     * @param Request $request
     * @return mixed
    public function handlePayment(Request $request)
        return FreeKassa::handle($request);


Please see CHANGELOG for more information on what has changed recently.


Please see CONTRIBUTING for details.


If you discover any security related issues, please send me an email at instead of using the issue tracker.



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

Laravel Freekassa

FreeKassa payments for Laravel

Laravel Freekassa Info

⭐ Stars10
🔗 Source
🕒 Last Updatea year ago
🕒 Created4 years ago
🐞 Open Issues2
➗ Star-Issue Ratio5
😎 Authormaksa988