PHPackages                             mastercode724/parsian-ipg - 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. mastercode724/parsian-ipg

ActiveLibrary[Payment Processing](/categories/payments)

mastercode724/parsian-ipg
=========================

Iranian parsian bank payment gateways handler for laravel based applications

1.1.2(3y ago)082[1 PRs](https://github.com/mastercode724/parsian-ipg/pulls)MITPHPPHP >=7.0

Since Oct 8Pushed 3y ago1 watchersCompare

[ Source](https://github.com/mastercode724/parsian-ipg)[ Packagist](https://packagist.org/packages/mastercode724/parsian-ipg)[ RSS](/packages/mastercode724-parsian-ipg/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (3)Dependencies (3)Versions (4)Used By (0)

parsianPay
==========

[](#parsianpay)

Easily integrate PHP application with parsian bank payment.

[راهنمای درگاه پارسیان ](https://github.com/mastercode724/parsian-ipg/wiki/%D8%AF%D8%B1%DA%AF%D8%A7%D9%87-%D9%BE%D8%A7%D8%B1%D8%B3%DB%8C%D8%A7%D9%86)Installation
============

[](#installation)

```
$ composer require mastercode724/parsian-ipg
```

Example Usage
=============

[](#example-usage)

Example For Pay
===============

[](#example-for-pay)

```
use Mastercode724\ParsianIPG\ParsianIPG;
use Mastercode724\ParsianIPG\Entities\SalePaymentResult;

$parsianIPG=new ParsianIPG('scsdsdfbdsthsgfnfgndg');//set parsian pin
$OrderId = (float)(time() . rand(000,999)); // factor number
$Amount  = 1000; // amount to pay
$CallbackUrl='http://example.ir/callback' ; // set callback url
$additionalData='' ; // set Additional Data max 500 character
$originator='' ; // set Originator max 50 character
$isLog=true; //is log request and result
$addressLogger="";//is log file address request and result
$salePaymentResult=$parsianIPG->salePayment($OrderId,$Amount,$CallbackUrl,$additionalData,$originator,$isLog,$addressLogger);
if($parsianIPG->isReadyToRedirect($salePaymentResult)){
    $parsianIPG->redirect($salePaymentResult);// redirect to parsian bank gateway  for payment
}

```

Example For Callback
====================

[](#example-for-callback)

```
use Mastercode724\ParsianIPG\ParsianIPG;
use Mastercode724\ParsianIPG\Entities\ConfirmPaymentResult;

$parsianIPG=new ParsianIPG('scsdsdfbdsthsgfnfgndg');//set parsian pin
$isLog=true; //is log request and result
$addressLogger="";//is log file address request and result
$confirmPaymentResult = $parsianIPG->confirmPayment($isLog,$addressLogger);
if($parsianIPG->isReadyConfirm($confirmPaymentResult)){
    die(' Payment OK ');
}else{
    if($confirmPaymentResult instanceof ConfirmPaymentResult){
        echo $confirmPaymentResult->getMessage();
    }
}

```

Example For reverse
===================

[](#example-for-reverse)

```
use Mastercode724\ParsianIPG\ParsianIPG;
use Mastercode724\ParsianIPG\Entities\ReversalResult;

$parsianIPG=new ParsianIPG('scsdsdfbdsthsgfnfgndg');//set parsian pin
$isLog=true; //is log request and result
$addressLogger="";//is log file address request and result
$token=12545485;//Token of pay request
$reversalResult = $parsianIPG->reversal($token,$isLog,$addressLogger);//reverse token payment
if($parsianIPG->isReadyReversal($reversalResult)){
    die(' Reverse Payment OK ');
}else{
    if($reversalResult instanceof ReversalResult){
        echo $reversalResult->getMessage();
    }
}

```

جهت صدا زدن درگاه پرداخت #

```
use Mastercode724\ParsianIPG\ParsianIPG;
use Mastercode724\ParsianIPG\Entities\SalePaymentResult;

# ایجاد کلاس درگاه . ورودی سازنده کلاس . Loginaccount درگاه می باشد
$parsianIPG=new ParsianIPG('scsdsdfbdsthsgfnfgndg');//set parsian pin
# ورودی ها
$OrderId = آی دی یکتای پرداخت; // factor number
$Amount  = مبلغ پرداختی ; // amount to pay
$CallbackUrl=آدرس بازگشتی به سایت ; // set callback url
$additionalData= رشته با طول حداکثر 500 کاراکتر حاوی داده های اضافی است   ; // set Additional Data max 500 character
$originator=  رشته با طول حداکثر 50 کاراکتر که نمایانگر منشأ درخواست تراکنش میباشد ; // set Originator max 50 character
$isLog = فلگ تعیین وضعیت لاگ  ; //is log request and result
در صورتی که این فلگ مقدار true داشته باشد . اطلاعات درخواست و خروجی فرخوانی در فایل لاگ ثبت می شود
$addressLogger= آدرس   فایل لاگ ;//is log file address request and result
در صورتی که شما آدرس فایل لاگ را مقداردهی نکنید فایل لاگ در مسیر کد پکیج در پوشه logs قرار داده می شود

# فراخوانی تابع salePayment برای درگاه پرداخت
$salePaymentResult=$parsianIPG->salePayment($OrderId,$Amount,$CallbackUrl,$additionalData,$originator,$isLog,$addressLogger);
# چک کردن نتیجه فراخوانی
در صورتی که خروجی در وضعیت موفق باشد تابع isReadyToRedirect  نتیجه درستی true را برمی گرداند در غیر اینصورت نتیجه false را بر می گرداند

if($parsianIPG->isReadyToRedirect($salePaymentResult)){
# انتقال به صفحه پرداخت
    $parsianIPG->redirect($salePaymentResult);// redirect to parsian bank gateway  for payment
}

```

جهت صفحه بازگشت از پرداخت درگاه #

```
use Mastercode724\ParsianIPG\ParsianIPG;
use Mastercode724\ParsianIPG\Entities\ConfirmPaymentResult;

# ایجاد کلاس درگاه . ورودی سازنده کلاس . Loginaccount درگاه می باشد
$parsianIPG=new ParsianIPG('scsdsdfbdsthsgfnfgndg');//set parsian pin

$isLog = فلگ تعیین وضعیت لاگ  ; //is log request and result
در صورتی که این فلگ مقدار true داشته باشد . اطلاعات درخواست و خروجی فرخوانی در فایل لاگ ثبت می شود
$addressLogger= آدرس   فایل لاگ ;//is log file address request and result
در صورتی که شما آدرس فایل لاگ را مقداردهی نکنید فایل لاگ در مسیر کد پکیج در پوشه logs قرار داده می شود

 # فراخوانی تابع confirmPayment برای تائید درخواست پرداخت از درگاه

$confirmPaymentResult = $parsianIPG->confirmPayment($isLog,$addressLogger);
# چک کردن نتیجه فراخوانی
در صورتی که خروجی در وضعیت موفق باشد تابع isReadyConfirm  نتیجه درستی true را برمی گرداند در غیر اینصورت نتیجه false را بر می گرداند
if($parsianIPG->isReadyConfirm($confirmPaymentResult)){
    die(' Payment OK ');
}else{
    if($confirmPaymentResult instanceof ConfirmPaymentResult){
        echo $confirmPaymentResult->getMessage();
    }
}

```

درخواست برگشت وجه توسط درگاه پرداخت اینترنتی پارسیان #

```
use Mastercode724\ParsianIPG\ParsianIPG;
use Mastercode724\ParsianIPG\Entities\ReversalResult;
# ایجاد کلاس درگاه . ورودی سازنده کلاس . Loginaccount درگاه می باشد

$parsianIPG=new ParsianIPG('scsdsdfbdsthsgfnfgndg');//set parsian pin

$token=توکن پرداخت موفق;//Token of pay request

$isLog = فلگ تعیین وضعیت لاگ  ; //is log request and result
در صورتی که این فلگ مقدار true داشته باشد . اطلاعات درخواست و خروجی فرخوانی در فایل لاگ ثبت می شود
$addressLogger= آدرس   فایل لاگ ;//is log file address request and result
در صورتی که شما آدرس فایل لاگ را مقداردهی نکنید فایل لاگ در مسیر کد پکیج در پوشه logs قرار داده می شود

 # فراخوانی تابع reversal برای برگشت وجه پرداخت از درگاه
$reversalResult = $parsianIPG->reversal($token,$isLog,$addressLogger);//reverse token payment
# چک کردن نتیجه فراخوانی
در صورتی که خروجی در وضعیت موفق باشد تابع isReadyReversal نتیجه درستی true را برمی گرداند در غیر اینصورت نتیجه false را بر می گرداند

if($parsianIPG->isReadyReversal($reversalResult)){
    die(' Reverse Payment OK ');
}else{
    if($reversalResult instanceof ReversalResult){
        echo $reversalResult->getMessage();
    }
}

```

###  Health Score

21

—

LowBetter than 19% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity6

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity44

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

Every ~1 days

Total

3

Last Release

1309d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/88becfda80ec271368fc210aef17d1fa030c8a2200e366e106b43c4965c4b205?d=identicon)[Mastercode724](/maintainers/Mastercode724)

---

Top Contributors

[![mastercode724](https://avatars.githubusercontent.com/u/114698254?v=4)](https://github.com/mastercode724 "mastercode724 (32 commits)")

---

Tags

online-paymentparsian paymentparsian bankparsian gateway

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/mastercode724-parsian-ipg/health.svg)

```
[![Health](https://phpackages.com/badges/mastercode724-parsian-ipg/health.svg)](https://phpackages.com/packages/mastercode724-parsian-ipg)
```

###  Alternatives

[cybersource/rest-client-php

Client SDK for CyberSource REST APIs

39881.3k6](/packages/cybersource-rest-client-php)[checkout/checkout-php-api

Checkout PHP API Library

25442.1k1](/packages/checkout-checkout-php-api)[buckaroo/sdk

Buckaroo payment SDK

12189.1k9](/packages/buckaroo-sdk)[contica/facturador-electronico-cr

Un facturador de código libre para integrar facturación electrónica en Costa Rica a un proyecto PHP

2128.8k](/packages/contica-facturador-electronico-cr)[sunnysideup/ecommerce

Silverstripe E-commerce Application

257.2k79](/packages/sunnysideup-ecommerce)

PHPackages © 2026

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