README

laravel zibal

transaction request package for zibal

Getting Started

To get a local copy up and running follow these simple steps.

Installation

1. You can install the package via composer:

   composer require llabbasmkhll/laravel-zibal 

note that you only need to do following steps if you want to change merchant id . if you only want to test the webservice , no need to do these steps

1. publish config file to your project

   php artisan vendor:publish

2. change merchant value to your merchant id in config/zibal.php ( use zibal for testing )

   return [
         'merchant' => 'zibal',
   ];

Usage

first include package facade into your file by :

use Llabbasmkhll\LaravelZibal\Facades\Zibal;

according to zibals official documentation there is 3 steps to issue a transaction in zibal

1 . Request :

in this step zibal gets basic information about the transaction and returns trackId that is needed for next step

use this to init the transaction request :

Zibal::init(
    1000000,            //required amount          - in rial
    'redirect',         //required callback        - can be either route name or a valid url starting with http or https
    ['key' => 'value'], //optional callback_params - will be passed to callback as query params , works only when route name passed to callback
    'description',      //optional description     - additional data , good for various reports
    123,                //optional orderId         - id of clients order (eg $invoice->id) , will be passed back to callback
    '09366217515',      //optional mobile          - clients mobile number
    ['000000000000']    //optional allowedCards    - array of allowed card numbers
)->getResponse();

this will return an array consist of result , message and trackId

result represents the request status as below.

you can add validate() function after init like below :

Zibal::init( $amount, 'redirect')->validate(404)->getResponse();

this will redirect the user to 404 page if the result code was anything except 100.

2 . Start :

redirect the user to zibals gateway for payment use :

Zibal::redirect($trackId);

you may combine first and second step into one line of code like this :

Zibal::init( $amount, 'redirect')->validate()->redirect();

that will init the transaction , then redirect the user zibals payment page if init was successful , otherwise it will redirect the user to 422 page

3 . Verify :

you can use this line of code to verify the transaction status:

Zibal::verify($trackId)->validate()->getResponse();

this will return an array consist of below parameters

result represents the request status as below.

status represents the request status as below.

Example Controller

<?php

namespace App\Http\Controllers\Web;

use App\Http\Controllers\Controller;
use App\Models\Invoice;
use Illuminate\Http\Request;
use Llabbasmkhll\LaravelZibal\Facades\Zibal;

class GatewayController extends Controller
{

    /**
     * redirect user to zibal.
     *
     * @param  \Illuminate\Http\Request  $request
     *
     * @return \Illuminate\Contracts\Foundation\Application|\Illuminate\Http\RedirectResponse|\Illuminate\Routing\Redirector
     */
    public function show(Request $request)
    {
        $invoice = Invoice::find($request->input('invoice'));
        $user    = $invoice->user()->first();


        return Zibal::init(
            $invoice->amount,
            'redirect',
            [],
            $user->id,
            $invoice->id,
            $user->mobile,
        )->validate()->redirect();
    }


    /**
     * validate the transaction.
     *
     * @return \Illuminate\Contracts\Foundation\Application|\Illuminate\Http\RedirectResponse|\Illuminate\Routing\Redirector
     */
    public function index(Request $request)
    {
        abort_unless($request->has('trackId'), 422);

        $response = Zibal::verify($request->input('trackId'))->getResponse();

        if ($response['result'] == 100) {
            $invoice = Invoice::find($response['orderId']);
            $invoice->update(
                [
                    'status'       => 1,
                    'bank_code'    => $response['refNumber'],
                    'finalized_at' => now(),
                ]
            );
        }

        return redirect('panel');
    }

}

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

License

Distributed under the MIT License. See LICENSE for more information.

Contact

Abbas mkhzomi - Telegram@llabbasmkhll - llabbasmkhll@gmail.com

Project Link: https://github.com/llabbasmkhll/laravel-zibal