Download the PHP package farayaz/larapay without Composer
On this page you can find all versions of the php package farayaz/larapay. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download farayaz/larapay
More information about farayaz/larapay
Files in farayaz/larapay
Package larapay
Short Description iranian online payment gateways
License MIT
Homepage https://github.com/farayaz/larapay
Informations about the package larapay
Larapay | لاراپِی
Larapay is a Laravel package for integrating Iranian payment gateways.
لاراپی یک پکیج لاراول برای اتصال به درگاههای پرداختی ایرانی است.
Requirements | نیازمندیها
- PHP:
^8.2 - Laravel:
^12.0|^13.0
Installation | نصب
Configuration | تنظیمات
No configuration file is required. Just pass the gateway config directly when calling the gateway.
نیازی به فایل کانفیگ جداگانه نیست. تنظیمات درگاه را مستقیماً هنگام فراخوانی ارسال کنید.
Each gateway has its own required parameters. See the Gateways table below.
هر درگاه پارامترهای مورد نیاز خود را دارد. به جدول درگاهها مراجعه کنید.
Gateways | درگاهها
| Class | Name (en) | Name (fa) | Requirements | Features |
|---|---|---|---|---|
| AsanPardakht | AsanPardakht | آسان پرداخت (آپ) | username, password, merchant_configuration_id |
- |
| Azkivam | Azkivam | ازکی وام | merchant_id, api_key |
- |
| BehPardakht | Beh Pardakht Mellat | بهپرداخت ملت | terminal_id, username, password, is_credit |
- |
| Bitpay | Bitpay | بیت پی | api, sandbox |
- |
| Digipay | Digipay | دیجیپی | username, password, client_id, client_secret |
- |
| ECD | Electronic Card Damavand | پرداخت الکترونیک دماوند | terminal_number, hash_key |
- |
| FanavaCard | FanavaCard | فنآوا کارت | user_id, password |
- |
| IdPay | IdPay | آیدیپی | apiKey, sandbox |
- |
| IranDargah | IranDargah | ایران درگاه | merchant_id, sandbox |
- |
| IranKish | Iran Kish | ایران کیش | terminalId, password, acceptorId, pubKey |
- |
| IsipaymentSamin | Isipayment Samin | ایزایران ثمین | merchant_code, merchant_password, terminal_code, type, number_of_installment |
- |
| JetPay | JetPay | جتپی | username, password, terminal_id, credit_id |
Bulk Check, Transaction List |
| Keepa | Keepa - Kipaa | کیپا | token |
- |
| MehrIran | MehrIran | بانک مهر ایران | terminal_id, merchant_nid, encrypt_key |
- |
| NextPay | NextPay | نکست پی | api_key |
- |
| Omidpay | Omidpay - Sayan Card | امید پی (سایان کارت) | user_id, password |
- |
| PardakhtNovin | Pardakht Novin | پرداخت نوین | userId, password, terminalId |
- |
| PayPing | PayPing | پی پینگ | token |
- |
| PEC | PEC | تجارت الکترونیک پارسیان | login_account |
- |
| PEP | PEP | پرداخت الکترونیک پاسارگاد | username, password, terminal_number |
- |
| Polam | Polam (Poolam) | پولام | api_key |
- |
| RefahBeta | Refah Beta | بانک رفاه بتا | client_id, client_secret, api_key, number_of_installments |
Bulk Check |
| Sadad | Sadad | پرداخت الکترونیک سداد (ملی) | terminal_id, merchant_id, key |
- |
| SadadBNPL | SadadBNPL | سداد BNPL | terminal_id, merchant_id, key |
- |
| Sep | Saman Electronic Payment | پرداخت الکترونیک سامان (سپ) | terminalId |
- |
| Sepal | Sepal | سپال | api_key |
- |
| SepehrPay | Sepehr Pay | پرداخت الکترونیک سپهر (مبنا) | terminalId |
- |
| Shepa | Shepa | شپا | api |
- |
| SnappPay | SnappPay | اسنپپی | username, password, client_id, client_secret |
- |
| TabaPay | TabaPay | تاباپی | token |
- |
| TejaratBajet | Tejarat Bajet | بانک تجارت - باجت | client_id, client_secret, sandbox |
Bulk Check |
| :test_tube: Test | Test | تست | - | - |
| Vandar | Vandar | وندار | api_key |
- |
| ZarinPal | Zarin Pal | زرین پال | merchant_id |
- |
| Zibal | Zibal | زیبال | merchant |
- |
Features:
Bulk Check= supports bulk transaction status checking.Transaction List= supports transaction lists and filters.
اگر درگاه مورد نظر خود را پیدا نکردید، به ما اطلاع دهید یا در اضافه کردن آن مشارکت کنید.
Usage | نحوه استفاده
The payment flow consists of 3 steps: Request (get token), Redirect (send user to gateway), and Verify (confirm payment).
فرایند پرداخت شامل ۳ مرحله است: دریافت توکن، هدایت کاربر به درگاه، و تأیید پرداخت.
1. Request Token | دریافت توکن
Response:
| Key | Type | Description |
|---|---|---|
token |
string | Gateway token to use in redirect/verify |
fee |
int | Transaction fee in Rials |
2. Redirect to Gateway | هدایت به درگاه
This returns a redirect response (either a RedirectResponse to the gateway or a form view).
3. Verify Payment | تأیید پرداخت
Response:
| Key | Type | Description |
|---|---|---|
result |
string | Status message from gateway |
reference_id |
string|null | Gateway reference number (شناسه پیگیری) |
tracking_code |
string|null | Transaction tracking code (شماره تراکنش) |
card |
string|null | Masked card number (شماره کارت) |
fee |
int | Transaction fee in Rials |
Complete Controller Example | مثال کامل کنترلر
Advanced Usage | استفاده پیشرفته
Refund | بازگشت وجه
Only available on gateways that implement RefundableInterface.
فقط در درگاههایی که RefundableInterface را پیادهسازی کردهاند در دسترس است.
Bulk Check | بررسی گروهی
Only available on gateways that implement BulkCheckableInterface.
فقط در درگاههایی که BulkCheckableInterface را پیادهسازی کردهاند در دسترس است.
JetPay checks the last 30 days: failed and refunded transactions trigger unsuccessCallback; pending and unknown statuses are skipped.
Transaction List | لیست تراکنشها
Check Gateway Capabilities | بررسی قابلیتهای درگاه
Error Handling | مدیریت خطا
All exceptions are thrown as Farayaz\Larapay\Exceptions\LarapayException.
تمام خطاها به صورت LarapayException پرتاب میشوند.
Benefits | مزایا
- Simple | ساده: Unified API for all gateways | API یکسان برای همه درگاهها
- Flexible | انعطافپذیر: Easy to add new gateways | اضافه کردن درگاه جدید آسان
- Fee Calculation | محاسبه هزینه: Built-in transaction fee calculation | محاسبه خودکار کارمزد
- Maintained | بهروز: Actively maintained and updated | نگهداری و بهروزرسانی فعال
- Open Source | متنباز: MIT license | مجوز MIT
Contributing | مشارکت
If you don't find the gateway you want, feel free to contribute!
اگر درگاه مورد نظر خود را پیدا نکردید، در اضافه کردن آن مشارکت کنید!
- Create a new class in
src/Gateways/extendingGatewayAbstract - Implement
request(),redirect(), andverify()methods - Optionally implement
RefundableInterfaceorBulkCheckableInterface - Add the gateway to the table in this README
- Submit a Pull Request
License | مجوز
This package is open-source software licensed under the MIT license.
این پکیج تحت مجوز MIT منتشر شده است.
All versions of larapay with dependencies
illuminate/container Version ^12.0 || ^13.0
illuminate/contracts Version ^12.0 || ^13.0
illuminate/support Version ^12.0 || ^13.0
morilog/jalali Version 3.*
illuminate/http Version ^12.0 || ^13.0
ramsey/uuid Version ^4.7