Download the PHP package hosseinmehr/zarinpal-composer-library without Composer
On this page you can find all versions of the php package hosseinmehr/zarinpal-composer-library. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download hosseinmehr/zarinpal-composer-library
More information about hosseinmehr/zarinpal-composer-library
Files in hosseinmehr/zarinpal-composer-library
Package zarinpal-composer-library
Short Description کتابخانه PHP برای اتصال به درگاه پرداخت زرینپال (API v4)
License GPL-2.0-only
Homepage https://github.com/hosseinmehr/zarinpal-composer-library
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package zarinpal-composer-library
zarinpal-composer-library
نسخه: 1.0.1
کتابخانه PHP برای اتصال به درگاه پرداخت زرینپال بر پایه API v4.
این پکیج امکان ایجاد درخواست پرداخت، وریفای، استعلام، تسویه اشتراکی شناور، میانپی (چکاوت)، واحد پولی و اعتبارسنجی خودکار/غیرخودکار را فراهم میکند.
نصب
پیشنیاز
- PHP 7.2 یا بالاتر
- Guzzle HTTP Client
- کد درگاه پرداخت (
merchant_id) از پنل زرینپال
شروع سریع
وریفای پرداخت
پس از بازگشت کاربر، پارامتر Status در QueryString مقدار OK یا NOK دارد:
ویژگیهای پیشرفته
واحد پولی (ریال / تومان)
مقادیر مجاز: IRR (ریال، پیشفرض) و IRT (تومان).
اعتبارسنجی خودکار / غیرخودکار
با پارامتر auto_verify در metadata میتوانید رفتار اعتبارسنجی را کنترل کنید:
اگر
auto_verifyارسال نشود، رفتار طبق تنظیمات پنل زرینپال تعیین میشود. مستندات اعتبارسنجی
تسویه اشتراکی شناور (تسهیم)
میانپی (صفحه چکاوت)
ارسال جزئیات سبد خرید برای نمایش شفافتر به خریدار:
متدهای دیگر
استعلام وضعیت (بدون وریفای)
تراکنشهای وریفاینشده
ریورس تراکنش
محاسبه کارمزد
کدهای خطا
کلاس ErrorCodes شامل تمام کدهای خطای مستندات زرینپال است:
لیست خطاها
یکپارچهسازی با Laravel
این کتابخانه با Laravel 5.5 به بالا (شامل Laravel 8، 9، 10 و 11) سازگار است.
امکانات Laravel:
- Service Provider —
Zarinpal\Laravel\ZarinpalServiceProvider - Facade —
Zarinpal::request()،Zarinpal::verify()و سایر متدها - Auto-discovery — در Laravel 5.5+ پس از نصب، Provider و Facade خودکار ثبت میشوند
نصب در پروژه Laravel
تنظیمات
در فایل .env پروژه:
در فایل config/services.php:
یا انتشار فایل پیکربندی اختصاصی:
نمونه Controller
استفاده با Facade
استفاده با Dependency Injection
بهجای Facade میتوانید از container لاراول استفاده کنید:
نکات Laravel
- Laravel 11+ — همان روش کار میکند؛ فقط
services.phpرا خودتان تنظیم کنید. - محیط تست — در
.envمقدارZARINPAL_SANDBOX=trueبگذارید. - Route نمونه:
سازگاری با نسخه قبل
- امضای
verify('OK', $amount, $authority)همچنان پشتیبانی میشود. - فرمت قدیمی
AdditionalDataبا کلیدWagesبه فرمت v4 تبدیل میشود. - کلیدهای
AuthorityوRefIDدر پاسخها حفظ شدهاند.
تست
تستهای یکپارچهسازی به مرچنت سندباکس واقعی نیاز دارند:
مستندات رسمی
مجوز
GPL-2.0-only — مشاهده LICENSE.md
