PHPackages                             huseinghasemi/zarinpal - 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. huseinghasemi/zarinpal

ActiveLibrary[Payment Processing](/categories/payments)

huseinghasemi/zarinpal
======================

Zarinpal library for Laravel.

v5.1.0(1y ago)09MITPHPPHP ^7.2|^8.0

Since Jul 29Pushed 1y agoCompare

[ Source](https://github.com/huseinghasemi/Zarinpal)[ Packagist](https://packagist.org/packages/huseinghasemi/zarinpal)[ Docs](https://github.com/huseinghasemi/zarinpal)[ RSS](/packages/huseinghasemi-zarinpal/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (1)Versions (23)Used By (0)

زرین پال | Zarinpal
===================

[](#زرین-پال--zarinpal)

Zarinpal library for Laravel based on Zarinpal API v4

کتابخانه زرین پال برای لاراول براساس نسخه 4 ای‌پی‌آی زرین پال

روش نصب - Installation
----------------------

[](#روش-نصب---installation)

Use composer to install this package

برای نصب و استفاده از این پکیج می توانید از کمپوسر استفاده کنید

```
composer require huseinghasemi/zarinpal
```

تنظیمات - Configuration
-----------------------

[](#تنظیمات---configuration)

Add your merchant id to .env file

مرچنت کد خود را اضافه کنید

```
ZARINPAL_MERCHANT_ID=00000000-0000-0000-0000-000000000000
```

You can also define merchant id at runtime.

امکان تعیین مرچنت کد در حین اجرا نیز وجود دارد که در ادامه توضیح داده خواهد شد.

To change currency to Toman (Default)

برای تغییر واحد پول به تومان (مقدار پیشفرض)

```
ZARINPAL_CURRENCY=IRT
```

To change currency to Rial

برای تغییر واحد پول به ریال

```
ZARINPAL_CURRENCY=IRR
```

To change payment type to test gateway

برای تغییر وضعیت درگاه به تست (به طور پیشفرض false هست. که اگر نیاز به درگاه تست هست کد پایین رو به dotenv اضافه کنید)

```
ZARINPAL_SANDBOX=TRUE
```

روش استفاده | How to use
------------------------

[](#روش-استفاده--how-to-use)

### ارسال مشتری به درگاه پرداخت | Send customer to payment gateway

[](#ارسال-مشتری-به-درگاه-پرداخت--send-customer-to-payment-gateway)

```
$response = zarinpal()
    ->merchantId('00000000-0000-0000-0000-000000000000') // تعیین مرچنت کد در حین اجرا - اختیاری
    ->amount(100) // مبلغ تراکنش
    ->request()
    ->description('transaction info') // توضیحات تراکنش
    ->callbackUrl('https://domain.com/verification') // آدرس برگشت پس از پرداخت
    ->mobile('09123456789') // شماره موبایل مشتری - اختیاری
    ->email('name@domain.com') // ایمیل مشتری - اختیاری
    ->send();

if (!$response->success()) {
    return $response->error()->message();
}

// ذخیره اطلاعات در دیتابیس
// $response->authority();

// هدایت مشتری به درگاه پرداخت
return $response->redirect();
```

### بررسی وضعیت تراکنش | Verify payment status

[](#بررسی-وضعیت-تراکنش--verify-payment-status)

```
$authority = request()->query('Authority'); // دریافت کوئری استرینگ ارسال شده توسط زرین پال
$status = request()->query('Status'); // دریافت کوئری استرینگ ارسال شده توسط زرین پال

$response = zarinpal()
    ->merchantId('00000000-0000-0000-0000-000000000000') // تعیین مرچنت کد در حین اجرا - اختیاری
    ->amount(100)
    ->verification()
    ->authority($authority)
    ->send();

if (!$response->success()) {
    return $response->error()->message();
}

// دریافت هش شماره کارتی که مشتری برای پرداخت استفاده کرده است
// $response->cardHash();

// دریافت شماره کارتی که مشتری برای پرداخت استفاده کرده است (بصورت ماسک شده)
// $response->cardPan();

// پرداخت موفقیت آمیز بود
// دریافت شماره پیگیری تراکنش و انجام امور مربوط به دیتابیس
return $response->referenceId();
```

###  Health Score

36

—

LowBetter than 82% of packages

Maintenance44

Moderate activity, may be stable

Popularity4

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity73

Established project with proven stability

 Bus Factor1

Top contributor holds 71.8% 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 ~96 days

Recently: every ~27 days

Total

22

Last Release

445d ago

Major Versions

v1.x-dev → v2.0.02020-02-01

v2.3 → v4.02021-06-06

v1.0.1 → v5.0.02025-02-19

PHP version history (4 changes)v1.0.0PHP >=7.1.0

v2.1.0PHP ^7.1

v2.3PHP ^7.1|^8.0

v4.0PHP ^7.2|^8.0

### Community

Maintainers

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

---

Top Contributors

[![FaridAghili](https://avatars.githubusercontent.com/u/8607021?v=4)](https://github.com/FaridAghili "FaridAghili (28 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (7 commits)")[![huseinghasemi](https://avatars.githubusercontent.com/u/77407105?v=4)](https://github.com/huseinghasemi "huseinghasemi (3 commits)")[![MohammadZarifiyan](https://avatars.githubusercontent.com/u/55022827?v=4)](https://github.com/MohammadZarifiyan "MohammadZarifiyan (1 commits)")

---

Tags

laravelpaymentzarinpal

### Embed Badge

![Health badge](/badges/huseinghasemi-zarinpal/health.svg)

```
[![Health](https://phpackages.com/badges/huseinghasemi-zarinpal/health.svg)](https://phpackages.com/packages/huseinghasemi-zarinpal)
```

###  Alternatives

[larabook/gateway

A Laravel package for connecting to all Iraninan payment gateways

24553.7k](/packages/larabook-gateway)[evryn/laravel-toman

A simple stable Laravel package to handle popular payment gateways in Iran including ZarinPal and IDPay.

1079.9k](/packages/evryn-laravel-toman)[pishran/zarinpal

Zarinpal library for Laravel.

4728.7k](/packages/pishran-zarinpal)[omalizadeh/laravel-multi-payment

A driver-based laravel package for online payments via multiple gateways

491.1k](/packages/omalizadeh-laravel-multi-payment)[dena-a/iran-payment

a Laravel package to handle Internet Payment Gateways for Iran Banking System

312.4k1](/packages/dena-a-iran-payment)[parsisolution/gateway

A Laravel package for connecting to all Iraninan payment gateways

231.7k](/packages/parsisolution-gateway)

PHPackages © 2026

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