Download the PHP package puresoft/jibimo-api-laravel without Composer
On this page you can find all versions of the php package puresoft/jibimo-api-laravel. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download puresoft/jibimo-api-laravel
More information about puresoft/jibimo-api-laravel
Files in puresoft/jibimo-api-laravel
Package jibimo-api-laravel
Short Description This package will let you use Jibimo API in your Laravel app.
License MIT
Informations about the package jibimo-api-laravel
= π’ Jibimo API Laravel Package Hesam Gholami [email protected] v1.0, 2019-06-16
++++
++++ :icons: font :experimental: true
Welcome to Laravel package of Jibimo API, This package will make your life easier to use Jibimo APIs in your Laravel application.
image:https://img.shields.io/github/release/j-tag/jibimo-api-laravel-package.svg[GitHub release] image:https://img.shields.io/packagist/php-v/puresoft/jibimo-api-laravel.svg[PHP from Packagist]
== π Quick Start
This package will use Jibimo PHP library underneath which is available at https://github.com/J-TAG/jibimo-api-php-lib .
Only thing you need to do, is to add composer requirements to your project and then publish Jibimo configs in your project.
=== π© Installation
Simply install this package using following composer command:
[source, bash]
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:
[source, bash]
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:
[source, env]
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:
[source, php]
public function myMethod(Jibimo $jibimo)
{
$response = $jibimo->pay(...);
// ...
}
=== π΅ 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
Use following code to initiate a request transaction and redirect user to gateway:
[source, php]
$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
After that, they will be back to your provided $returnUrl
, so you can validate their transaction there:
[source, php]
$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
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
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.
[source, php]
$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
Validating pay transactions is easy. You can use following code:
[source, php]
$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
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
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.
[source, php]
$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
Validating extended pay transactions is easy. You can use following code:
[source, php]
$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
To better understanding Jibimo API specifications you can see it's API documentation available at https://jibimo.com/api/documentaion . But here you can find a simple cheat sheet to use.
=== π Privacy Levels
Jibimo has 3 privacy levels to show transactions to users.
==== π 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
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
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
In Jibimo API, transactions have three different statuses.
==== βοΈ 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
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
This status means that transaction was successful and everything went cool.
=== π± 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
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
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!
All versions of jibimo-api-laravel with dependencies
puresoft/jibimo-api Version ~1.1
illuminate/support Version ~5.6.0|~5.7.0|~5.8.0|~5.9.0