عند بناء متجر إلكتروني أو تطبيق داخل السعودية، تصبح بوابة الدفع جزءًا أساسيًا من المشروع.

ومن أشهر بوابات الدفع المستخدمة داخل السوق السعودي نجد Moyasar والتي توفر دعمًا لوسائل دفع متعددة مثل:

وتوفر Moyasar مكتبة PHP يمكن ربطها مباشرة مع Laravel لتسهيل إنشاء المدفوعات وإدارة العمليات المالية داخل التطبيق.

في هذا المقال سنتعرف على طريقة الربط خطوة بخطوة باستخدام مكتبة moyasar-php داخل Laravel.

أول خطوة هي تثبيت الحزمة داخل المشروع:

composer require moyasar/moyasar

توفر الحزمة خدمات خاصة بالمدفوعات والفواتير ويمكن دمجها مباشرة داخل Laravel Service Container.

بعد التثبيت نقوم بنشر ملف الإعدادات:

php artisan vendor:publish
--provider="Moyasar\Providers\LaravelServiceProvider"

هذه الخطوة ستقوم بإنشاء ملف:

config/moyasar.php

بعد إنشاء حساب داخل Moyasar والحصول على مفاتيح API قم بإضافتها داخل ملف:

.env

ثم أضف:

MOYASAR_API_KEY=sk_test_xxxxxxxxx

تقرأ المكتبة المفتاح تلقائيًا من متغير البيئة دون الحاجة لإضافته داخل الكود.

بعد الإعداد يمكن الوصول إلى الخدمات مباشرة من خلال:

app(PaymentService::class);

app(InvoiceService::class);

أو عبر حقن الخدمة داخل Controller:

use Moyasar\Providers\PaymentService;

class PaymentController
{
   public function __construct(
      PaymentService $paymentService
   ){

      $this->paymentService =
         $paymentService;

   }
}

بهذه الطريقة تصبح خدمة الدفع متاحة داخل المشروع بالكامل.

توفر المكتبة Facade جاهزة:

Moyasar\Facades\Payment

يمكن استخدامها بالشكل التالي:

use Moyasar\Facades\Payment;

$payment =
Payment::fetch("payment_id");

يسمح ذلك بجلب بيانات عملية دفع مباشرة من Moyasar.

بعد إعداد الطلب داخل النظام يمكن إنشاء عملية الدفع وإرسال البيانات إلى Moyasar.

عادة تتضمن البيانات:

مثال تقريبي:

$data = [

 "amount" => 10000,

 "currency" => "SAR",

 "description" =>
 "Order Payment"

];

بعد نجاح العملية تقوم Moyasar بإرجاع معلومات الدفع والتي يمكن تخزينها داخل قاعدة البيانات.

المكتبة لا تقتصر على المدفوعات فقط.

بل توفر أيضًا:

ويمكن الوصول لذلك عبر:

InvoiceService

توفر Moyasar واحدة من أشهر حلول الدفع داخل السعودية، كما أن دمجها مع Laravel يعتبر مباشرًا بفضل مكتبة PHP الجاهزة.

بعد تثبيت الحزمة وإضافة مفاتيح API يمكن البدء مباشرة في إنشاء المدفوعات وإدارة الفواتير وربطها مع التطبيقات والمتاجر الإلكترونية.