pishran/zarinpal

Zarinpal library for Laravel.
34,620 46
laravel payment zarinpal
Install
composer require pishran/zarinpal
Latest Version:v4.3.7
PHP:^7.2|^8.0
License:MIT
Last Updated:May 1, 2026
Links: GitHub  ·  Packagist
Maintainer: FaridAghili

زرین پال | Zarinpal

Zarinpal library for Laravel based on Zarinpal API v4

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

روش نصب - Installation

Use composer to install this package

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

composer require pishran/zarinpal

تنظیمات - 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

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

ارسال مشتری به درگاه پرداخت | 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

$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();

Related Packages

dena-a/iran-payment

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

2,387 30
bank banking gateway iran laravel meli merchant novinopay pay pay.ir payment payment system payping purchase sadad saman sep zarinpal
hamraa/lumen-payment

A Lumen package for connecting to payment gateways

30 3
asan-pardakht bank dargah gateway ipay iran iranian-banks jahanpay lumen meli mellat pardakht parsian pasargad pay pay-ir payline payment paypal persian-banks poolport port sadad saman shaparak zarinpal
larabook/gateway

A Laravel package for connecting to all Iraninan payment gateways

54,942 243
asan-pardakht bank dargah gateway ipay iran iranian-banks jahanpay laravel meli mellat pardakht parsian pasargad pay pay-ir payline payment paypal persian-banks poolport port sadad saman shaparak zarinpal
mammutgroup/gateway

A Laravel package for connecting to all Iraninan payments gateways

66 1
bank dargah gateway ipay iran iranian-banks jahanpay laravel meli mellat pardakht parsian pasargad pay payline payment persian-banks poolport port sadad saman shaparak zarinpal
shetabit/payment

Laravel Payment Gateway Integration Package

380,949 954
bank gateway irankish irankish payment gateway jahanpay jahanpay payment gateway jibit jibit payment gateway laravel irankish laravel irankish package laravel jahanpay laravel jahanpay package laravel jibit laravel jibit package laravel meli laravel meli package laravel mellat laravel mellat package laravel melli bank payment package laravel parsian laravel parsian package laravel pasargad laravel pasargad package laravel pay laravel pay package laravel payline laravel payline package laravel payment gateway laravel payment package laravel paypal laravel paypal package laravel sadad laravel sadad package laravel saderat laravel saderat package laravel saman laravel saman package laravel shaparak laravel shaparak package laravel zarinpal laravel zarinpal package meli meli payment gateway mellat mellat payment gateway melli parsian parsian payment gateway pasargad pasargad payment gateway pay pay payment gateway payline payline payment gateway payment payment gateway paypal paypal payment gateway sadad sadad payment gateway saderat saderat payment gateway saman saman payment gateway shaparak shaparak payment gateway shetabit zarinpal zarinpal payment gateway

Version History

Version Released PHP Laravel License
v4.3.7 ^7.2|^8.0 ^7.0|^8.0|^9.0|^10.0|^11.0|^12.0|^13.0 MIT
v4.3.6 ^7.2|^8.0 ^7.0|^8.0|^9.0|^10.0|^11.0|^12.0 MIT
v4.3.5 ^7.2|^8.0 ^7.0|^8.0|^9.0|^10.0|^11.0|^12.0 MIT
v4.3.4 ^7.2|^8.0 ^7.0|^8.0|^9.0|^10.0|^11.0 MIT
v4.3.3 ^7.2|^8.0 ^7.0|^8.0|^9.0|^10.0 MIT