> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ofatoura.com/llms.txt
> Use this file to discover all available pages before exploring further.

# إعداد طرق الدفع وبوابات الدفع

> قم بإعداد بوابات الدفع الإلكترونية والدفع النقدي ورمز QR وطرق الدفع المخصصة غير الإلكترونية في لوحة الإدارة oFatoura، حتى يتمكن فريقك من قبول جميع طرق الدفع التي يحتاجها عملاؤك.

تتحكم إعدادات الدفع في طرق الدفع التي تظهر عند إتمام الطلب — سواء في نقطة البيع عبر الويب أو في تطبيق ePOS للنادل. يمكنك تفعيل بوابات بطاقات الدفع الدولية بوضعَي الاختبار والإنتاج، وتشغيل الدفع النقدي أو برمز QR، وتعريف طرق دفع مخصصة غير إلكترونية كالتحويل البنكي أو الشيكات.

<Note>
  تحتاج إلى صلاحية **إدارة الإعدادات** (المخصصة عادةً لدور المسؤول) لإعداد طرق الدفع.
</Note>

## أين تجد إعدادات الدفع

انتقل إلى **الإعدادات ← إعدادات الدفع** من الشريط الجانبي الأيسر. تنقسم الصفحة إلى تبويبات — تبويب لكل بوابة دفع، إضافةً إلى تبويب لطرق الدفع غير الإلكترونية.

***

## إعداد بوابة دفع إلكترونية

تدعم oFatoura البوابات التالية: **Paymob** و**AmwalPay** و**Stripe** و**Razorpay** و**PayPal** و**Payfast** و**Paystack** و**Flutterwave** و**Xendit**.

تتبع كل بوابة نفس خطوات الإعداد العامة:

<Steps>
  <Step title="افتح تبويب البوابة">
    في **الإعدادات ← إعدادات الدفع**، انقر على تبويب البوابة التي تريد إعدادها (مثلاً **Stripe** أو **Paymob**).
  </Step>

  <Step title="فعّل البوابة">
    حرّك مفتاح **التفعيل** (Enable) في أعلى التبويب لتشغيل البوابة.
  </Step>

  <Step title="اختر وضع الاختبار أو الإنتاج">
    استخدم محدد **الوضع** (Mode) للاختيار بين **اختبار** (Test/Sandbox) أو **مباشر** (Live). تحقق دائماً في وضع الاختبار قبل التبديل إلى وضع الإنتاج.
  </Step>

  <Step title="أدخل بيانات الاعتماد">
    أدخل حقول بيانات الاعتماد الخاصة بهذه البوابة. تختلف الحقول المطلوبة من مزود لآخر — انظر الجدول أدناه لمعرفة ما تحتاجه كل بوابة.
  </Step>

  <Step title="احفظ التغييرات">
    انقر على **حفظ** (Save) أو زر الحفظ المماثل في التبويب. ستصبح البوابة متاحةً كخيار دفع فوراً.
  </Step>
</Steps>

### حقول بيانات الاعتماد لكل بوابة

| البوابة     | الحقول المطلوبة                                                    |
| ----------- | ------------------------------------------------------------------ |
| Paymob      | مفتاح API، معرّف التكامل (Integration ID)، مفتاح HMAC، رمز Webhook |
| AmwalPay    | مفتاح API، المفتاح السري                                           |
| Stripe      | مفتاح API (قابل للنشر)، المفتاح السري                              |
| Razorpay    | مفتاح API، المفتاح السري                                           |
| PayPal      | عنوان البريد الإلكتروني لحساب PayPal                               |
| Payfast     | معرّف التاجر، مفتاح API، المفتاح السري                             |
| Paystack    | مفتاح API (العام)، المفتاح السري                                   |
| Flutterwave | مفتاح API، المفتاح السري                                           |
| Xendit      | مفتاح API، المفتاح السري                                           |

<Note>
  تدعم Paymob معرّفات تكامل متعددة. أضف كل معرّف تكامل في سطر منفصل إذا كان حساب Paymob الخاص بك يتعامل مع أكثر من قناة دفع (مثلاً بطاقة ائتمانية ومحفظة إلكترونية).
</Note>

### روابط Webhook

يعرض كل تبويب بوابة **رابط Webhook** الخاص بذلك المزود. انسخ هذا الرابط إلى لوحة تحكم البوابة لديك حتى تتمكن oFatoura من استقبال تأكيدات الدفع. هذه الروابط للقراءة فقط داخل oFatoura — تُعدّ على جانب البوابة وليس هنا.

<Warning>
  التبديل من وضع **الاختبار** إلى وضع **الإنتاج** دون تحديث بيانات الاعتماد بمفاتيح الإنتاج سيتسبب في فشل عمليات الدفع. تحقق جيداً من محدد الوضع وجميع حقول بيانات الاعتماد قبل الانتقال إلى البث المباشر.
</Warning>

***

## الدفع النقدي

في صفحة إعدادات البوابة، يوجد قسم **نقدي** (Cash) يحتوي على مفتاح تفعيل/تعطيل. قم بتشغيله للسماح للموظفين بتسجيل المدفوعات النقدية مقابل الطلبات. لا تحتاج إلى أي بيانات اعتماد للدفع النقدي.

***

## الدفع برمز QR

إذا كنت تقبل المدفوعات برمز QR (مثلاً محفظة محلية أو تحويل بنكي عبر QR):

<Steps>
  <Step title="فعّل الدفع برمز QR">
    ابحث عن خيار **الدفع برمز QR** (QR Payment) في إعدادات الدفع وفعّله.
  </Step>

  <Step title="ارفع صورة رمز QR">
    ارفع صورة رمز QR الخاص بحساب الدفع لديك. تُعرض هذه الصورة للعملاء عند إتمام الطلب حتى يتمكنوا من المسح والدفع.
  </Step>

  <Step title="احفظ">
    احفظ التغييرات. سيظهر خيار الدفع برمز QR عندما يعالج الموظفون طلباً.
  </Step>
</Steps>

***

## طرق الدفع المخصصة غير الإلكترونية

استخدم طرق الدفع غير الإلكترونية في حالات كالتحويل البنكي أو الشيكات أو أي عملية تحصيل يدوية أخرى تريد تسميتها وتتبعها.

### إضافة طريقة دفع غير إلكترونية جديدة

<Steps>
  <Step title="انتقل إلى تبويب المدفوعات غير الإلكترونية">
    في **الإعدادات ← إعدادات الدفع**، انقر على تبويب **المدفوعات غير الإلكترونية** (Offline Payments).
  </Step>

  <Step title="انقر على إضافة">
    انقر على الزر لإضافة طريقة دفع غير إلكترونية جديدة.
  </Step>

  <Step title="أدخل التفاصيل">
    أدخل **اسم الطريقة** (Method name) — مطلوب، بحد أقصى 255 حرفاً — و**الوصف** الذي يشرح هذه الطريقة للموظفين — مطلوب، بحد أقصى 1,000 حرف.
  </Step>

  <Step title="حدّد الحالة">
    اتركها على **نشط** (Active) حتى تظهر الطريقة عند إتمام الطلب، أو اضبطها على **غير نشط** (Inactive) لإخفائها دون حذفها.
  </Step>

  <Step title="احفظ">
    احفظ الطريقة. ستظهر فوراً كخيار دفع في نقطة البيع.
  </Step>
</Steps>

### تعديل أو حذف طرق الدفع غير الإلكترونية

من تبويب **المدفوعات غير الإلكترونية**، تحتوي كل طريقة مدرجة على إجراءات للتعديل والحذف. يؤدي حذف الطريقة إلى إزالتها من القائمة؛ أما سجلات المدفوعات التاريخية المسجلة بموجبها فتظل محفوظة في سجلات الدفع.

***

## ذات صلة

* [سجلات الدفع والمدفوعات المستحقة](/ar/payments/payment-records)
* [إتمام الدفع والتقسيم والإكراميات](/ar/pos/payments-and-tips)
* [نظرة عامة على المدفوعات والمصروفات](/ar/payments/index)