وحدة Moyasar لـ WHMCS

حول هذه الوحدة قم بقبول مدفوعات بطاقات الائتمان بسهولة عبر Moyasar مع دعم العملات المتعددة وتغطية واسعة. هذا يبسط عملية الدفع لعملائك ويزيد في نفس الوقت من مبيعاتك وإيراداتك.

قدم لعملائك طرق الدفع المحلية والإقليمية والعالمية. وسّع نشاطك التجاري عالميًا من خلال توفير جميع خيارات الدفع الشائعة في منطقة الشرق الأوسط وشمال إفريقيا، بما في ذلك مدى، فيزا، ماستركارد، أمريكان إكسبريس، والعديد غيرها.

لمزيد من التفاصيل، تفضل بزيارة:
https://www.Moyasar.sa/home

المتطلبات تثبيت WHMCS يعمل بشكل صحيح (تم اختباره حتى الإصدار 8.11.2).
حساب Moyasar، يمكنك التسجيل مجانًا عبر: https://dashboard.moyasar.com/register/new

خطوات التثبيت

1. فك ضغط ملف "MoyasarV2-3-1-by-datasource.zip" مباشرة في مجلد تثبيت WHMCS الخاص بك.
2. قم بتفعيل الوحدة في لوحة إدارة WHMCS:
   إعدادات -> المدفوعات -> بوابات الدفع -> جميع بوابات الدفع
3. قم بإعداد حساب Moyasar في WHMCS:
   إعدادات -> المدفوعات -> بوابات الدفع -> إدارة البوابات القائمة
   ابحث عن Moyasar، قم بتفعيله، ثم أدخل المفتاح السري الذي تحصل عليه من https://dashboard.moyasar.com
4. اضغط على حفظ التغييرات لإتمام عملية الإعداد.

الميزات

1. أساسيات البوابة
   دعم كامل لمدفوعات بطاقات الائتمان.
   تمكين تحويل العملات عبر إعداد ConvertTo.

2. حفظ بيانات البطاقة (Tokenization)
   يتم حفظ البطاقة تلقائيًا بعد أول دفع ناجح.
   يتم حذف التوكن تلقائيًا عند فشل محاولة الدفع.

3. الدفع التلقائي / الدفعات المتكررة
   التكامل مع إعداد Attempt CC Captures الرسمي في WHMCS.
   إضافة ملف moyasar_cron.php لتشغيل الدفعات التلقائية يدويًا عبر Cron Job.
   استخدام WHMCS API لجلب الفواتير غير المدفوعة ومعالجتها تلقائيًا.

4. ميزة إضافة رصيد
   يتم إنشاء فاتورة تلقائيًا عند اختيار المستخدم "إضافة رصيد".
   إعادة توجيه المستخدمين تلقائيًا إلى صفحة الفاتورة بعد إنشائها.

5. دعم Apple Pay
   تكامل كامل مع زر Apple Pay الرسمي على الويب.
   عرض زر Apple Pay مخصص بجانب نموذج الدفع.

6. تحويل العملات والدعم الدولي
   العملات المدعومة: SAR, USD, AED, EUR, KWD, BHD, OMR.
   التحويل التلقائي للعملة إلى العملة المدعومة من Moyasar.

الاختبار لاختبار الوحدة، قم بتمكين وضع الاختبار على خدمتك عبر لوحة Moyasar. تذكر تعطيل وضع الاختبار قبل العمل الفعلي.

Moyasar Module for WHMCS

About This Module Easily accept credit card payments via Moyasar with multi-currency support and extensive coverage. This simplifies the payment process for your customers while increasing your sales and revenue.

Offer local, regional, and global payment methods to your clients. Scale your business globally by providing all popular payment options across the MENA region, including Mada, Visa, Mastercard, Amex, and many more.

For more details, visit:
https://www.Moyasar.sa/home

Requirements A working WHMCS installation (tested up to version 8.11.2).
A Moyasar account. Register for free at: https://dashboard.moyasar.com/register/new

Installation Steps

1. Unzip the file "MoyasarV2-3-1-by-datasource.zip" directly into your WHMCS installation folder.
2. Activate the module in your WHMCS admin panel:
   Setup -> Payments -> Payment Gateways -> All Payment Gateways
3. Configure your Moyasar account in WHMCS:
   Setup -> Payments -> Payment Gateways -> Manage Existing Gateways
   Locate Moyasar, activate it, then enter the secret key obtained from https://dashboard.moyasar.com
4. Click Save Changes to finalize the setup.

Features

1. Gateway Basics
   Credit card payments fully supported.
   Currency conversion enabled via ConvertTo setting.

2. Card Tokenization
   Automatically saves the card after the first successful payment.
   Tokens are automatically deleted if a payment attempt fails.

3. Recurring / Auto Capture Payments
   Integration with WHMCS official Attempt CC Captures setting.
   Added moyasar_cron.php for manual Cron Job execution of recurring payments.
   Uses WHMCS API to fetch unpaid invoices and process them automatically.

4. Add Funds Feature
   Automatically generates an invoice when a user selects “Add Funds.”
   Redirects users to the invoice page after creation.

5. Apple Pay Support
   Full Apple Pay Web integration with official button.
   Custom Apple Pay button displayed next to the payment form.

6. Currency Conversion & International Support
   Supported currencies: SAR, USD, AED, EUR, KWD, BHD, OMR.
   Automatic currency conversion to the currency supported by Moyasar.

Testing To test the module, enable Test Mode on your service via the Moyasar dashboard. Remember to disable Test Mode before going live.