PHPackages algmaal/laravel-fawaterak - 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. algmaal/laravel-fawaterak ActiveLibrary[Payment Processing](/categories/payments) algmaal/laravel-fawaterak ========================= Laravel package for Fawaterak payment gateway integration v1.0.3(8mo ago)217MITPHPPHP ^8.1CI failing Since Aug 30Pushed 8mo agoCompare [ Source](https://github.com/algmaal/laravel-fawaterak)[ Packagist](https://packagist.org/packages/algmaal/laravel-fawaterak)[ RSS](/packages/algmaal-laravel-fawaterak/feed)WikiDiscussions main Synced 1mo ago READMEChangelogDependencies (6)Versions (5)Used By (0) Laravel Fawaterak Payment Gateway ================================= [](#laravel-fawaterak-payment-gateway) [![Latest Version on Packagist](https://camo.githubusercontent.com/5ff06cfe39c8ef59acbbe38d9e4b518d8fe569aa11d31d664a9b61b132e51c6a/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f616c676d61616c2f6c61726176656c2d66617761746572616b2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/algmaal/laravel-fawaterak)[![Total Downloads](https://camo.githubusercontent.com/d0e6ecda785aab797a5ea81eb7954b93a0102f038b1ab1305f6de9659d1e099c/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f616c676d61616c2f6c61726176656c2d66617761746572616b2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/algmaal/laravel-fawaterak)[![GitHub Tests Action Status](https://camo.githubusercontent.com/deb188f95d15b894a6ba9a2756ce80b58c444e41ede0d7be1320f6512af79301/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f776f726b666c6f772f7374617475732f616c676d61616c2f6c61726176656c2d66617761746572616b2f72756e2d74657374733f6c6162656c3d7465737473)](https://github.com/algmaal/laravel-fawaterak/actions?query=workflow%3Arun-tests+branch%3Amain) حزمة Laravel للتكامل مع بوابة الدفع Fawaterak. تدعم جميع طرق الدفع المتاحة في Fawaterak مع إدارة شاملة للمعاملات والـ webhooks. المميزات -------- [](#المميزات) - ✅ دعم Laravel 10+ و 11+ و 12+ - ✅ تكامل كامل مع Fawaterak API - ✅ دعم جميع طرق الدفع (Visa/Mastercard، Fawry، Meeza، Aman، Basta) - ✅ معالجة Webhooks التلقائية - ✅ إدارة البيئات المتعددة (Staging/Production) - ✅ Cache للبيانات المتكررة - ✅ Logging شامل للعمليات - ✅ Validation للبيانات - ✅ معالجة الأخطاء المتقدمة - ✅ اختبارات شاملة - ✅ Facade سهل الاستخدام التثبيت ------- [](#التثبيت) ``` composer require algmaal/laravel-fawaterak ``` نشر ملف التكوين: ``` php artisan vendor:publish --provider="Algmaal\LaravelFawaterak\FawaterakServiceProvider" --tag="fawaterak-config" ``` التكوين ------- [](#التكوين) أضف المتغيرات التالية إلى ملف `.env`: ``` # البيئة الافتراضية (staging أو production) FAWATERAK_ENVIRONMENT=staging # إعدادات بيئة التطوير FAWATERAK_STAGING_API_KEY=your_staging_api_key FAWATERAK_STAGING_BASE_URL=https://staging.fawaterk.com FAWATERAK_STAGING_WEBHOOK_SECRET=your_staging_webhook_secret # إعدادات بيئة الإنتاج FAWATERAK_PRODUCTION_API_KEY=your_production_api_key FAWATERAK_PRODUCTION_BASE_URL=https://app.fawaterak.com FAWATERAK_PRODUCTION_WEBHOOK_SECRET=your_production_webhook_secret # العملة الافتراضية FAWATERAK_DEFAULT_CURRENCY=EGP # إعدادات إضافية FAWATERAK_CACHE_ENABLED=true FAWATERAK_LOGGING_ENABLED=true ``` الاستخدام الأساسي ----------------- [](#الاستخدام-الأساسي) ### الحصول على طرق الدفع المتاحة [](#الحصول-على-طرق-الدفع-المتاحة) ``` use Algmaal\LaravelFawaterak\Facades\Fawaterak; // الحصول على طرق الدفع $paymentMethods = app(\Algmaal\LaravelFawaterak\Contracts\FawaterakServiceInterface::class) ->getPaymentMethods(); foreach ($paymentMethods['data'] as $method) { echo $method['name_ar'] . ' - ' . $method['name_en']; } ``` ### إنشاء دفعة جديدة [](#إنشاء-دفعة-جديدة) ``` use Algmaal\LaravelFawaterak\Facades\Fawaterak; // بيانات العميل $customerData = [ 'first_name' => 'محمد', 'last_name' => 'أحمد', 'email' => 'mohamed@example.com', 'phone' => '01234567890', 'address' => 'القاهرة، مصر' ]; // عناصر السلة $cartItems = [ [ 'name' => 'منتج تجريبي 1', 'price' => '100', 'quantity' => '1' ], [ 'name' => 'منتج تجريبي 2', 'price' => '50', 'quantity' => '2' ] ]; // إنشاء الدفعة $payment = Fawaterak::createPayment( $customerData, $cartItems, 200.0, // المجموع 2, // معرف طريقة الدفع (Visa/Mastercard) [ 'currency' => 'EGP', 'invoice_number' => 'INV-001', 'redirection_urls' => [ 'successUrl' => 'https://yoursite.com/payment/success', 'failUrl' => 'https://yoursite.com/payment/failed', 'pendingUrl' => 'https://yoursite.com/payment/pending' ] ] ); // إعادة توجيه العميل لصفحة الدفع if (isset($payment['data']['payment_data']['redirectTo'])) { return redirect($payment['data']['payment_data']['redirectTo']); } ``` ### التحقق من حالة الدفعة [](#التحقق-من-حالة-الدفعة) ``` use Algmaal\LaravelFawaterak\Facades\Fawaterak; $invoiceKey = 'hyU2vcy3USvT5Tg'; // التحقق من نجاح الدفعة if (Fawaterak::isPaymentSuccessful($invoiceKey)) { echo 'تم الدفع بنجاح!'; } else { echo 'الدفعة لم تكتمل بعد'; } // الحصول على حالة الدفعة $status = Fawaterak::getPaymentStatus($invoiceKey); echo "حالة الدفعة: {$status}"; // الحصول على تفاصيل الدفعة كاملة $paymentDetails = Fawaterak::getPayment($invoiceKey); ``` معالجة Webhooks --------------- [](#معالجة-webhooks) الحزمة تتعامل تلقائياً مع webhooks من Fawaterak. يمكنك الاستماع للأحداث: ``` // في EventServiceProvider use Illuminate\Support\Facades\Event; Event::listen('fawaterak.webhook.received', function ($data) { // معالجة عامة لجميع الـ webhooks Log::info('Webhook received', $data); }); Event::listen('fawaterak.payment.paid', function ($data) { // معالجة الدفعات المكتملة $invoiceKey = $data['invoice_key']; // تحديث قاعدة البيانات، إرسال إيميل، إلخ }); Event::listen('fawaterak.payment.failed', function ($data) { // معالجة الدفعات الفاشلة }); Event::listen('fawaterak.payment.pending', function ($data) { // معالجة الدفعات المعلقة }); ``` طرق الدفع المختلفة ------------------ [](#طرق-الدفع-المختلفة) ### Visa/Mastercard [](#visamastercard) ``` $payment = Fawaterak::createPayment($customer, $items, $total, 2); // سيتم إعادة توجيه العميل لصفحة الدفع ``` ### Fawry [](#fawry) ``` $payment = Fawaterak::createPayment($customer, $items, $total, 3); // سيحصل العميل على كود Fawry للدفع $fawryCode = $payment['data']['payment_data']['fawryCode']; ``` ### Meeza (Mobile Wallet) [](#meeza-mobile-wallet) ``` $payment = Fawaterak::createPayment($customer, $items, $total, 4, [ 'mobile_wallet_number' => '01234567890' ]); // سيحصل العميل على QR Code للدفع $qrCode = $payment['data']['payment_data']['meezaQrCode']; ``` الخيارات المتقدمة ----------------- [](#الخيارات-المتقدمة) ### تخصيص URLs إعادة التوجيه [](#تخصيص-urls-إعادة-التوجيه) ``` $options = [ 'redirection_urls' => [ 'successUrl' => 'https://yoursite.com/payment/success', 'failUrl' => 'https://yoursite.com/payment/failed', 'pendingUrl' => 'https://yoursite.com/payment/pending' ] ]; ``` ### إضافة خصم [](#إضافة-خصم) ``` $options = [ 'discount_data' => [ 'type' => 'pcg', // أو 'literal' 'value' => 10 // 10% أو 10 جنيه ] ]; ``` ### إضافة ضريبة [](#إضافة-ضريبة) ``` $options = [ 'tax_data' => [ 'title' => 'ضريبة القيمة المضافة', 'value' => 14 // 14% ] ]; ``` الاختبار -------- [](#الاختبار) تشغيل الاختبارات: ``` composer test ``` تشغيل الاختبارات مع تقرير التغطية: ``` composer test-coverage ``` المساهمة -------- [](#المساهمة) نرحب بالمساهمات! يرجى قراءة [دليل المساهمة](CONTRIBUTING.md) للمزيد من التفاصيل. الأمان ------ [](#الأمان) إذا اكتشفت مشكلة أمنية، يرجى إرسال إيميل إلى بدلاً من استخدام issue tracker. الترخيص ------- [](#الترخيص) هذه الحزمة مرخصة تحت [رخصة MIT](LICENSE.md). الدعم ----- [](#الدعم) - [التوثيق الرسمي لـ Fawaterak](https://fawaterak-api.readme.io/) - [GitHub Repository](https://github.com/algmaal/laravel-fawaterak) - [GitHub Issues](https://github.com/algmaal/laravel-fawaterak/issues) - [Packagist Package](https://packagist.org/packages/algmaal/laravel-fawaterak) - [البريد الإلكتروني](mailto:mohamedalgamal@gmail.com) حالة النشر ---------- [](#حالة-النشر) - ✅ **GitHub**: متاح ومحدث - ✅ **Packagist**: منشور ومتاح - ✅ **Laravel 12**: مدعوم ومختبر - ✅ **Auto-Updates**: مفعل عبر GitHub Webhooks ### Health Score 33 — LowBetter than 75% of packages Maintenance60 Regular maintenance activity Popularity10 Limited adoption so far Community6 Small or concentrated contributor base Maturity47 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 ~0 days Total 4 Last Release 256d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/bc8a9e130f449c1dd6d4f1b34d10eaad7f67bafde8bceed7c16f59264393b1a1?d=identicon)[algmaal](/maintainers/algmaal) --- Top Contributors [![algmaal](https://avatars.githubusercontent.com/u/4155734?v=4)](https://github.com/algmaal "algmaal (11 commits)") --- Tags egyptfawateraklaravelpayment-gatewaypayment-processingphplaravelpayment processingpaymentgatewayEgyptfawaterak ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/algmaal-laravel-fawaterak/health.svg) ``` [![Health](https://phpackages.com/badges/algmaal-laravel-fawaterak/health.svg)](https://phpackages.com/packages/algmaal-laravel-fawaterak) ``` ### Alternatives [sebdesign/laravel-viva-payments A Laravel package for integrating the Viva Payments gateway 4845.9k](/packages/sebdesign-laravel-viva-payments)[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)[baklysystems/laravel-paymob Laravel PayMob online payment gateway package 282.4k](/packages/baklysystems-laravel-paymob) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)