# إعداد ميسر

كل حقل في مزود ميسر بترتيب نموذجه، من الحالة والمفاتيح إلى طرق الدفع والعملات ودفتر يومية الدفع والرسائل، ثم الزر الذي يعرضه على العملاء.

تقبل ميسر الدفع بالبطاقات، أي مدى وفيزا وماستركارد وأمريكان إكسبريس ويونيون باي في نموذج بطاقة واحد، وتقبل STC Pay أيضا. وتمر هذه الصفحة على نموذج المزود من أعلاه إلى أسفله، أما صفحة [أول دفعة إلكترونية](first-online-payment) فتريك المزود نفسه وهو يعمل.

## قبل أن تبدأ {#before-you-start}

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

## الحالة والمفاتيح {#state-and-keys}

1. افتح **الفوترة/التهيئة/المدفوعات عبر الإنترنت/مزودي الدفع** وانقر بطاقة **ميسر**.
2. اختر قيمة **الولاية** (أي الحالة): **وضع الاختبار** ما دمت تجرب، و**ممكن** للدفعات الحقيقية، و**معطل** لتوقف عرضه.

![حالة المزود، ووضع الاختبار ما دمت تجربه.](https://jaah.app/web/image/11510-8e0bfde9/online-payments-first-payment-provider_state-ar.png)

3. في تبويب **بيانات الاعتماد** الصق **المفتاح العلني** (pk_) و**المفتاح السري** (sk_) و**الرمز السري للWebhook**. تقترن مفاتيح الاختبار بوضع الاختبار، والمفاتيح الحية بالحالة **ممكن**، ويرفض الحفظ أي اقتران غير ذلك، كما يرفض مفتاحا سريا ملصقا في خانة المفتاح العلني.

![بيانات الاعتماد الثلاث لحساب ميسر.](https://jaah.app/web/image/11574-3db66575/online-payments-moyasar-moyasar_keys-ar.png)

4. في لوحة ميسر أضف رابط إشعارات (Webhook) يتجه إلى عنوان موقعك متبوعا بالمسار /payment/moyasar/webhook، بالرمز السري نفسه. فتبلغ ميسر عن كل دفعة حتى لو أغلق العميل الصفحة قبل أن يعود إليها.

## استمارة الدفع {#payment-form}

يعدد حقل **طرق الدفع** ما يختاره العميل: **البطاقة**، ثم **STCPay** حين تفعلها. ويفتح رابط **قم بتمكين طرق الدفع**، الظاهر متى لم يعد المزود **معطل**، قائمة الطرق التي تفعل منها طريقة أو تعطلها.

![طرق الدفع المعروضة على العميل، والرابط الذي يفعل غيرها.](https://jaah.app/web/image/11578-e43cfa25/online-payments-moyasar-moyasar_methods-ar.png)

ويتيح خيار **السماح بحفظ طرق الدفع** (مفعل افتراضيا) للعميل أن يحفظ بطاقته لدفعة لاحقة. ويحدد خيار **تحصيل المبلغ يدويا** (غير مفعل افتراضيا، ومفعل في قاعدة البيانات التجريبية) هل تؤخذ الدفعة فورا أم تحجز على البطاقة حتى تحصلها من الفاتورة، وتستطيع ميسر أيضا تحصيل جزء من المبلغ أو رد جزء منه.

![حفظ البطاقات والتحصيل اليدوي، خياران من خيارات استمارة الدفع.](https://jaah.app/web/image/11582-7722b84e/online-payments-moyasar-moyasar_capture-ar.png)

## مجموعة ميسر {#moyasar-group}

- **إصدار نموذج الدفع**: إصدار نموذج البطاقة لدى ميسر، وهو 1.7.3. لا تغيره إلا إذا طلبت ميسر ذلك.
- **تفعيل تعدد العملات**: لا تقبل ميسر إلا الريال السعودي ما لم يفعل هذا الخيار، ولا تفعله إلا إذا كان تعدد العملات مفعلا في حسابك لدى ميسر.
- **سياسة المتابعة**: كيف تعاد محاولة التحصيل التلقائي من بطاقة محفوظة حين يفشل. وإن تركت فارغة طبقت السياسة الافتراضية؛ انظر [أتمتة الدفع الإلكتروني](online-payments-automations).

![مجموعة ميسر، وفيها إصدار النموذج وتعدد العملات وسياسة المتابعة.](https://jaah.app/web/image/11586-9ed55a30/online-payments-moyasar-moyasar_group-ar.png)

## التوافر {#availability}

يخفي **الحد الأقصى للمبلغ** المزود فوق مبلغ معين (0 بلا حد). وتتبع **العملات** خيار **تفعيل تعدد العملات**. أما **الدول** فإن تركت فارغة عرض المزود على عملاء كل الدول، وإن ملئت عرض على عملاء الدول المذكورة وحدها.

![يقيد التوافر المزود بالمبلغ والعملة والدولة.](https://jaah.app/web/image/11590-0b5b1a9c/online-payments-moyasar-moyasar_availability-ar.png)

## دفتر يومية الدفع {#payment-journal}

**دفتر يومية الدفع** هو دفتر يومية البنك الذي تسجل فيه الدفعات الناجحة، ويجب ملؤه قبل أن يخرج المزود من **معطل**. أما دفاتر اليومية نفسها فتشرحها [المحاسبة: ابدأ هنا](/docs/accounting-start-here).

![دفتر يومية البنك الذي تسجل فيه الدفعات.](https://jaah.app/web/image/11522-950d2d5a/online-payments-first-payment-provider_journal-ar.png)

## الرسائل {#messages}

يحمل تبويب **الرسائل** النصوص التي يقرؤها العميل: **رسالة المساعدة** تحت طريقة الدفع، ثم رسالة كل نتيجة (قيد الانتظار، مصرح بها، تمت، ألغيت). اكتبها بكل لغة يستخدمها عملاؤك.

![الرسائل التي يقرؤها العميل في كل مرحلة من مراحل الدفع.](https://jaah.app/web/image/11594-afff41b3/online-payments-moyasar-moyasar_messages-ar.png)

## النشر {#publish}

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

![زر النشر؛ ولا يرى العملاء من خارج المكتب إلا المزود المنشور.](https://jaah.app/web/image/11598-a7290cdf/online-payments-moyasar-moyasar_published-ar.png)

## الأسئلة الشائعة {#faq}

### لا يظهر ميسر في فاتورة العميل. {#not-shown}

تحقق بالترتيب: أن الحالة ليست **معطل** وأن المزود منشور، وأن عملة الفاتورة مقبولة (الريال وحده دون **تفعيل تعدد العملات**)، وأن دولة العميل ضمن **الدول** أو أن القائمة فارغة، وأن المبلغ تحت **الحد الأقصى للمبلغ**، وأن خيار **سداد قيمة الفاتورة عبر الإنترنت** مفعل في [إعدادات الدفع الإلكتروني](online-payment-settings).

### هل أستطيع التجربة دون سحب مال من بطاقة؟ {#test}

نعم. في **وضع الاختبار** وبمفاتيح الاختبار تمر الدفعات ببيئة الاختبار لدى ميسر وبطاقاتها التجريبية.

### ماذا يحدث للبطاقات المحفوظة حين أغير الحالة؟ {#saved-cards}

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

---

- Source: https://jaah.app/ar/docs/online-payments/set-up-moyasar
- Updated: 2026-10-23
- Version: الدفع الإلكتروني 19.0.1.3.0
- Verified: 2026-10-23