PHPackages                             puresoft/jibimo-api-laravel - 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. [Payment Processing](/categories/payments)
4. /
5. puresoft/jibimo-api-laravel

AbandonedArchivedLibrary[Payment Processing](/categories/payments)

puresoft/jibimo-api-laravel
===========================

This package will let you use Jibimo API in your Laravel app.

v1.0.0(6y ago)06MITPHPPHP >=7.1.0

Since Jun 16Pushed 6y agoCompare

[ Source](https://github.com/J-TAG/jibimo-api-laravel-package)[ Packagist](https://packagist.org/packages/puresoft/jibimo-api-laravel)[ RSS](/packages/puresoft-jibimo-api-laravel/feed)WikiDiscussions master Synced yesterday

READMEChangelog (1)Dependencies (2)Versions (2)Used By (0)

🏢 Jibimo API Laravel Package
============================

[](#-jibimo-api-laravel-package)

Welcome to Laravel package of Jibimo API, This package will make your life easier to use Jibimo APIs in your Laravel application.

[![GitHub release](https://camo.githubusercontent.com/4c23c93a5e416c49a77e846d6ca8e6811e8dc78d23b42a643dd652b9cc5e5690/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f72656c656173652f6a2d7461672f6a6962696d6f2d6170692d6c61726176656c2d7061636b6167652e737667)](https://camo.githubusercontent.com/4c23c93a5e416c49a77e846d6ca8e6811e8dc78d23b42a643dd652b9cc5e5690/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f72656c656173652f6a2d7461672f6a6962696d6f2d6170692d6c61726176656c2d7061636b6167652e737667)[![PHP from Packagist](https://camo.githubusercontent.com/a2ac5e53445bcb73f6126aa488482ebea005e3fb86f80c1e30d29eba9a0992a7/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f70757265736f66742f6a6962696d6f2d6170692d6c61726176656c2e737667)](https://camo.githubusercontent.com/a2ac5e53445bcb73f6126aa488482ebea005e3fb86f80c1e30d29eba9a0992a7/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f70757265736f66742f6a6962696d6f2d6170692d6c61726176656c2e737667)

🎁 Quick Start
-------------

[](#-quick-start)

This package will use Jibimo PHP library underneath which is available at  .

Only thing you need to do, is to add composer requirements to your project and then publish Jibimo configs in your project.

### 🎩 Installation

[](#-installation)

Simply install this package using following composer command:

```
composer require puresoft/jibimo-api-laravel --prefer-stable
```

So this will install the original Jibimo PHP library with Laravel package in your app.

Now you need to publish Jibimo configs using following command:

```
php artisan vendor:publish --provider=puresoft\jibimo\laravel\JibimoServiceProvider
```

This will create a `jibimo.php` file in your config folder and now you can set environment variables in your `.env` file as follow:

```
JIBIMO_BASE_URL="https://jibimo.com/api"
JIBIMO_API_TOKEN="..." #Your Jibimo API token
```

Now you can use `Jibimo` static class available at `puresoft\jibimo\laravel` like `puresoft\jibimo\laravel\Jibimo::pay()`or simply you can inject it to your method like this:

```
    public function myMethod(Jibimo $jibimo)
    {
        $response = $jibimo->pay(...);
        // ...
    }
```

### 💵 Request Money from People

[](#-request-money-from-people)

For using Jibimo money request API you should first initiate the transaction and redirect user to the gateway, after returning back from gateway you **MUST** validate the transaction, and if the transaction was valid and accepted, you are all set and user was paid you correctly.

Below you can see the instruction:

#### 👍 Initiating Transaction and Redirecting User to Gateway

[](#-initiating-transaction-and-redirecting-user-to-gateway)

Use following code to initiate a request transaction and redirect user to gateway:

```
$mobile = "09366061280";
$amountInToman = 8500;
$privacyLevel = JibimoPrivacyLevel::PUBLIC;
$trackerId = "xxxx"; // Anything like a factor number or maybe a UUID, it's up to you
$description = "Thank you for using our service :)"; // Optional, this will show up in Jibimo feed
$returnUrl = "http://mywebsite.com/callback/?something=somethingelse"; // Optional, after payment, Jibimo will redirect user to this URL. If you omit it, Jibimo will redirect user to your company homepage

$response = Jibimo::request($mobile, $amountInToman, $privacyLevel, $trackerId, $description, $returnUrl);

// Status of transaction must be `Pending`
if(JibimoTransactionStatus::PENDING === $response->getStatus()) {

    // Save Jibimo transaction ID to database or whatever to use that to verify transaction later
    // $response->getTransactionId();

    // Now, redirect user to Jibimo gateway
    $redirect = $response->getRedirectUrl();
    // Redirect code ...
}
```

After redirecting user to Jibimo gateway, they will see a web page to pay you money through Jibimo account or normal banking gateway.

#### ✔️ Verifying Request Transactions

[](#️-verifying-request-transactions)

After that, they will be back to your provided `$returnUrl`, so you can validate their transaction there:

```
$transactionId = X; // You should get this transaction ID from where you saved it when you were creating the request in the previous step
$mobile = "09366061280";
$amountInToman = 8500;
$trackerId = "xxxx"; //Tracker ID of main transaction

$validationResult = Jibimo::validateRequest($transactionId, $mobile, $amountInToman, $trackerId);

// Validate and check status of transaction in Jibimo
if($validationResult->isAccepted()) {
    // Transaction was successful, user paid money correctly
}
// Otherwise, there is a problem. You can get raw response or handle exceptions to find out why there is still problem
```

### 💲 Pay Money to People

[](#-pay-money-to-people)

Using Jibimo Payment API is straight forward.

Simply you will pay money and then validate it. There is no extra step like request money to show gateway or anything else to user.

#### 📫 Using Jibimo Pay API

[](#-using-jibimo-pay-api)

Use following code to pay to a mobile number which may or may not be registered in Jibimo. If the mobile number registered in Jibimo, money will be transferred to its Jibimo account immediately, otherwise it will be pending for user to be registered in Jibimo. They will be receive an SMS by Jibimo to be informed about payment.

```
$mobile = "09366061280";
$amountInToman = 8500;
$privacyLevel = JibimoPrivacyLevel::PUBLIC;
$trackerId = "xxxx"; // Anything like a factor number or maybe a UUID, it's up to you
$description = "Thank you for using our service :)"; // Optional, this will show up in Jibimo feed

$response = Jibimo::pay($mobile, $amountInToman, $privacyLevel, $trackerId, $description);

// Here you should save transaction ID to verify it later
// $response->getTransactionId();

if(JibimoTransactionStatus::ACCEPTED === $response->getStatus()) {
    // Money was paid immediately
} else if(JibimoTransactionStatus::PENDING === $response->getStatus()) {
    // The user was not registered in Jibimo, so it will be pending until user being registered in Jibimo
}

// For other problems and errors, you can see the raw response or catch exceptions
```

#### ✔️ Verifying Pay Transactions

[](#️-verifying-pay-transactions)

Validating pay transactions is easy. You can use following code:

```
$transactionId = X; // You should get this transaction ID from where you saved it when you were creating the request in the previous step
$mobile = "09366061280";
$amountInToman = 8500;
$trackerId = "xxxx"; // Tracker ID of main transaction

$validationResult = Jibimo::validatePay($transactionId, $mobile, $amountInToman, $trackerId);

// Validate and check status of transaction in Jibimo
if($validationResult->isAccepted()) {
    // Transaction was successful, user received money
}
// Otherwise, there is a problem. You can get raw response or handle exceptions to find out why there is still problem
```

### 🚄 Extended Pay AKA Direct Pay API

[](#-extended-pay-aka-direct-pay-api)

Using Jibimo *Extended Payment* API, you can pay directly to bank account of people using the combination of their mobile number and IBAN (Sheba) number.

The difference between this method and the normal payment is in IBAN (Sheba) number and also in extended payment, money will be directly transferred to the original bank account of user whereas in normal payment it would transfer to the Jibimo account of user. So if the user is not registered in Jibimo, it will get money anyway without even contacting with any of Jibimo services.

#### 🌈 Using Jibimo Extended Pay API

[](#-using-jibimo-extended-pay-api)

Use following code to pay to combination of a mobile number and IBAN (Sheba) number which may or may not be registered in Jibimo. In this method, money will be transferred directly to the original bank account of user using *Paya*.

```
$mobile = "09366061280";
$amountInToman = 8500;
$iban = "IR140570028870010133089001"; // This is my real IBAN(Sheba), so keep your head up to not pay to it mistakenly, I will not return back your money to you ! :D
$privacyLevel = JibimoPrivacyLevel::PUBLIC;
$trackerId = "xxxx"; // Anything like a factor number or maybe a UUID, it's up to you
$description = "Thank you for using our service :)"; // Optional, this will show up in Jibimo feed
$name = "حسام"; // Optional, The first name of IBAN(Sheba) owner
$family = "غلامی"; // Optional, The last name of IBAN(Sheba) owner

$response = Jibimo::extendedPay($mobile, $amountInToman, $privacyLevel, $iban, $trackerId,
            $description, $name, $family);

// Here you should save transaction ID to verify it later
// $response->getTransactionId();

if(JibimoTransactionStatus::ACCEPTED === $response->getStatus()) {
    // Money was paid successfully
}

// For other problems and errors, you can see the raw response or catch exceptions
```

#### ✔️ Verifying Extended Pay Transactions

[](#️-verifying-extended-pay-transactions)

Validating extended pay transactions is easy. You can use following code:

```
$transactionId = X; // You should get this transaction ID from where you saved it when you were creating the request in the previous step
$mobile = "09366061280";
$amountInToman = 8500;
$trackerId = "xxxx"; // Tracker ID of main transaction

$validationResult = Jibimo::validateExtendedPay($transactionId, $mobile, $amountInToman, $trackerId);

// Validate and check status of transaction in Jibimo
if($validationResult->isAccepted()) {
    // Transaction was successful, user received money
}
// Otherwise, there is a problem. You can get raw response or handle exceptions to find out why there is still problem
```

That was it!, hope this quick start will help you up and running quickly.

Please feel free to post an issue if you found any problems in this package.

📃 Jibimo API Specifications
---------------------------

[](#-jibimo-api-specifications)

To better understanding Jibimo API specifications you can see it’s API documentation available at  . But here you can find a simple cheat sheet to use.

### 🎭 Privacy Levels

[](#-privacy-levels)

Jibimo has 3 privacy levels to show transactions to users.

#### 😃 Personal

[](#-personal)

It means the transaction is only visible between two parties that are involved in it, meaning payer and payee. So only these two people can see this transaction.

#### 👪 Friend

[](#-friend)

It means the transaction is only visible between two parties that are involved in it **AND** their friends, meaning payer and payee and Jibimo friends of payer and Jibimo friends of payee.

Note

In this privacy level, the amount of transaction is not visible for people other than payer and payee.

#### 🏦 Public

[](#-public)

Means anyone who is registered in Jibimo can see this transaction. So it can be a good point for promoting your products in a social media like, type of feed.

Note

In this privacy level, the amount of transaction is not visible for people other than payer and payee.

### 🚦 Transaction Statuses

[](#-transaction-statuses)

In Jibimo API, transactions have three different statuses.

#### ⛔️ Rejected

[](#️-rejected)

Means one of parties were reject to accept the transaction or there is a problem with the transaction.

For example in request money API, if user clicks the cancel button, the transaction status will be set to `Rejected`. Or if you pay to an invalid IBAN(Sheba) number, the transaction status will be `Rejected` after failure response from bank to Jibimo.

#### 🕞 Pending

[](#-pending)

This status means the transaction is pending for something else to happen.

For example if you pay to a user who is not registered in Jibimo using normal pay API, the transaction will be pending until the user comes in Jibimo.

#### ✅ Accepted

[](#-accepted)

This status means that transaction was successful and everything went cool.

### 📱 Mobile Number Format

[](#-mobile-number-format)

This package will try to normalize your mobile numbers to match it with Jibimo API requirement.

In Jibimo API, mobile number must be in following format:

`+989366061280`

But in this package you can use following formats as well:

`9366061280``09366061280``989366061280``+989366061280`

All of above formats are supported.

### 📊 IBAN (Sheba) Format

[](#-iban-sheba-format)

like mobile number, this package will try to normalize your IBAN(Sheba) numbers too.

In Jibimo API, IBAN(Sheba) number must be in following format:

`140570028870010133089001`

But in this package you can use both formats with or without leading `IR`:

`140570028870010133089001``IR140570028870010133089001`

All of above formats are supported.

💝 Contributing
--------------

[](#-contributing)

If you enjoyed this project, please consider contributing to it and make it better.

And please don’t forget to give a star to this project.

Thank you and happy coding!

###  Health Score

23

—

LowBetter than 27% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity4

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity54

Maturing project, gaining track record

 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

2523d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/f02d9ddc2672d5af59ac98c6716dc39d6c93b6b8a4f8844c0dcdb0c422cf2cda?d=identicon)[jtag](/maintainers/jtag)

---

Top Contributors

[![j-tag](https://avatars.githubusercontent.com/u/3483320?v=4)](https://github.com/j-tag "j-tag (2 commits)")

---

Tags

jibimolaravel-5-packagelaravel-packagepaymen-servicepaymentpayment-gatewayphpphp7

### Embed Badge

![Health badge](/badges/puresoft-jibimo-api-laravel/health.svg)

```
[![Health](https://phpackages.com/badges/puresoft-jibimo-api-laravel/health.svg)](https://phpackages.com/packages/puresoft-jibimo-api-laravel)
```

###  Alternatives

[laraveldaily/laravel-invoices

Missing invoices for Laravel

1.5k1.3M4](/packages/laraveldaily-laravel-invoices)[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)[karson/mpesa-php-sdk

172.2k](/packages/karson-mpesa-php-sdk)

PHPackages © 2026

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