PHPackages                             azima/laravel\_paytabs - 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. azima/laravel\_paytabs

ActiveLibrary

azima/laravel\_paytabs
======================

Official laravel package to implement PayTabs integration with laravel apps

1.4.1(5mo ago)001[1 PRs](https://github.com/Mahmoudalziem/laravel_paytabs/pulls)MITPHPPHP ^7.0|^8.0

Since Dec 7Pushed 5mo ago1 watchersCompare

[ Source](https://github.com/Mahmoudalziem/laravel_paytabs)[ Packagist](https://packagist.org/packages/azima/laravel_paytabs)[ Docs](https://site.paytabs.com/en/)[ RSS](/packages/azima-laravel-paytabs/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (1)DependenciesVersions (2)Used By (0)

Laravel PayTabs PT2

Description
-----------

[](#description)

This Package provides integration with the PayTabs payment gateway.

CONTENTS OF THIS FILE
---------------------

[](#contents-of-this-file)

- Introduction
- Requirements
- Installation
- Configuration
- usage

INTRODUCTION
------------

[](#introduction)

This Package integrates PayTabs online payments into the Laravel Framework starts from version 5.8 - 8.x.

REQUIREMENTS
------------

[](#requirements)

This Package requires no external dependencies.

INSTALLATION
------------

[](#installation)

- composer require azima/laravel\_paytabs

CONFIGURATION
-------------

[](#configuration)

- composer dump-autoload
- Go to *config/app.php* and in the providers array add

    ```
      azima\Laravel_paytabs\PaypageServiceProvider::class,

    ```
- Create the package config file:

    ```
      php artisan vendor:publish --tag=paytabs

    ```
- Go to *config/logging.php* and in the channels array add

    ```
    'PayTabs' => [
    'driver' => 'single',
    'path' => storage_path('logs/paytabs.log'),
    'level' => 'info',
    ],

    ```
- In *config/paytabs.php* add your merchant info.

**Important Hint:**you can pass your merchant info in the environment file with the same key names mentioned in the *config/paytabs.php* file. This value will be returned if no environment variable exists for the given key.

Usage
-----

[](#usage)

- create pay page

    ```
      use azima\Laravel_paytabs\Facades\paypage;

      $pay= paypage::sendPaymentCode('all')
             ->sendTransaction('sale')
              ->sendCart(10,1000,'test')
             ->sendCustomerDetails('Walaa Elsaeed', 'w.elsaeed@paytabs.com', '0101111111', 'test', 'Nasr City', 'Cairo', 'EG', '1234','100.279.20.10')
             ->sendShippingDetails('Walaa Elsaeed', 'w.elsaeed@paytabs.com', '0101111111', 'test', 'Nasr City', 'Cairo', 'EG', '1234','100.279.20.10')
             ->sendURLs('return_url', 'callback_url')
             ->sendLanguage('en')
             ->create_pay_page();
      return $pay;

    ```
- if you want to pass the shipping address as same as billing address you can use

    ```
      >shipping_same_billing()
      and make sure to remove calling
      ->sendShippingDetails.

    ```
- if you want to hide the shipping address you can use

    ```
      ->sendHideShipping(true);

    ```
- if you want to use iframe option instead of redirection you can use

    ```
      ->sendFramed(true);

    ```
- if you want to pass the payment methods you can use

    ```
      ::sendPaymentCode("['creditcard','fawry']")

    ```
- if you want to make a payment via token you can use

    ```
      ->sendTokinse(true)
      ->sendTransaction('transaction_type','recurring')
      ->sendToken('token returned from the first payment page created with Tokenization option')

    ```
- if you want to make a payment response via token you can use

    ```
      ->sendTransaction('transaction_type','recurring')
      ->sendToken('token returned from the first payment page')
      ->create_payment_response()

    ```
- if you want to make a payment with user defined you can use

    ```
      ->sendUserDefined(["udf1"=>"UDF1 Test", "udf2"=>"UDF2 Test", "udf3"=>"UDF3 Test"])

    ```
- refund (you can use this function to both refund and partially refund)

    ```
      $refund = Paypage::refund('tran_ref','order_id','amount','refund_reason');
      return $refund;

    ```
- Auth

    ```
      pay= Paypage::sendPaymentCode('all')
             ->sendTransaction('Auth')
              ->sendCart(10,1000,'test')
             ->sendCustomerDetails('Walaa Elsaeed', 'w.elsaeed@paytabs.com', '0101111111', 'test', 'Nasr City', 'Cairo', 'EG', '1234','100.279.20.10')
             ->sendShippingDetails('Walaa Elsaeed', 'w.elsaeed@paytabs.com', '0101111111', 'test', 'Nasr City', 'Cairo', 'EG', '1234','100.279.20.10')
             ->sendURLs('return_url', 'callback_url')
             ->sendLanguage('en')
             ->create_pay_page();
      return $pay;

    ```
- capture (the tran\_ref is the tran\_ref of the Auth transaction you need to capture it.

    you can use this function to both capture and partially capture.)

    ```
       $capture = Paypage::capture('tran_ref','order_id','amount','capture description');
       return $capture;

    ```
- void (the tran\_ref is the tran\_ref of the Auth transaction you need to void it.

    you can use this function to both capture and partially capture)

    ```
      $void = Paypage::void('tran_ref','order_id','amount','void description');
      return $void

    ```
- transaction details

    ```
      $transaction = Paypage::queryTransaction('tran_ref');
      return $transaction;

    ```
- if you face any error you will find it logged in: *storage/logs/paytabs.log*

PAYMENT RESULT NOTIFICATION
---------------------------

[](#payment-result-notification)

PayTabs payment gateway provides means to notify your system with payment result once transaction processing was completed so that your system can update the transaction respective cart.

To get use of this feature do the following:

1- Defining a route (Optional)
------------------------------

[](#1--defining-a-route-optional)

Laravel PayTabs PT2 package comes with a default route for incoming IPN requests. The route URI is */paymentIPN* , if you don't like it this URI just ignore it and define your own. Look at *routes/routes.php* to get a clue.

2- Implementing a means to receive notification
-----------------------------------------------

[](#2--implementing-a-means-to-receive-notification)

To receive notification, do one of the following:

- While creating a pay page, passed this route as a Callback URL to *sendURLs* method, that URL will receive an HTTP Post request with the payment result. For more about callback check: **merchant dashboard** &gt; **Developers** &gt; **Transaction API**.
- Second means is to configure IPN notification from merchant dashboard. For more details about how to configure IPN request and its different formats check: **merchant dashboard** &gt; **Developers** &gt; **Service Types**.

3- Configuring a callback method
--------------------------------

[](#3--configuring-a-callback-method)

Now, you need to configure the plugin with the class\\method that will grab the payment details and perform your custom logic (updating cart in DB, notifying the customer ...etc ).

- In your website *config/paytabs.php* file, add the following:

    ```
      'callback' => env('paytabs_ipn_callback', new namespace\your_class() ),

    ```
- In your class add new method, it must named: **updateCartByIPN**

    ```
      updateCartByIPN( $requestData){
          $cartId= $requestData->getCartId();
          $status= $requestData->getStatus();
          //your logic .. updating cart in DB, notifying the customer ...etc

          //Hold On Reject support
          // if $status = "H" this is mean the transaction is hold on reject.
          // you can't make capture for it from your system.
          // you must make the capture from paytabs dashboard side.
          // make sure to add your ipn value to paytabs dashboard from here:
           "{paytabs portal}/merchant/developers/ipnconfig".
      }

    ```

you can also get transaction reference number. To get the list of available properties check: *azima*\\Laravel\_\_paytabs\\IpnRequest\_ class.

###  Health Score

31

—

LowBetter than 68% of packages

Maintenance73

Regular maintenance activity

Popularity1

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity39

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

154d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/5e41d36182bd95fcb9228bd8676e83e30a941c1dc54ce9322d88806dd66c43a7?d=identicon)[azima](/maintainers/azima)

---

Top Contributors

[![Mahmoudalziem](https://avatars.githubusercontent.com/u/34794206?v=4)](https://github.com/Mahmoudalziem "Mahmoudalziem (10 commits)")

---

Tags

laravelpaymentspaytabsE-comerce

### Embed Badge

![Health badge](/badges/azima-laravel-paytabs/health.svg)

```
[![Health](https://phpackages.com/badges/azima-laravel-paytabs/health.svg)](https://phpackages.com/packages/azima-laravel-paytabs)
```

###  Alternatives

[paytabscom/laravel_paytabs

Official laravel package to implement PayTabs integration with laravel apps

24171.9k6](/packages/paytabscom-laravel-paytabs)[musahmusah/laravel-multipayment-gateways

A Laravel Package that makes implementation of multiple payment Gateways endpoints and webhooks seamless

852.2k1](/packages/musahmusah-laravel-multipayment-gateways)[a17mad/laravel-cybersource

This package wraps the Cybersource SOAP API in a convenient, easy to use package for Laravel.

136.8k](/packages/a17mad-laravel-cybersource)[itsmurumba/laravel-mpesa

Laravel Package for Mpesa Daraja API

191.6k](/packages/itsmurumba-laravel-mpesa)[threesquared/laravel-paymill

Laravel wrapper for the Paymill API

121.3k](/packages/threesquared-laravel-paymill)

PHPackages © 2026

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