1. المساعدة
  2. الدفع والشحن
الدفع والشحن

اربط ميسر

المفتاح العام والمفتاح السري بكلمات واضحة، ورابط الويبهوك وأين تلصقه، ولماذا تبدأ بمفاتيح التجربة.

  • 9 دقائق قراءة
  • آخر تحديث: 2026-08-04

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

قبل أن تبدأ

  • حساب في ميسر. تفتحه من موقعهم. هم يطلبون مستنداً نظامياً — سجل تجاري أو وثيقة عمل حر — وحساباً بنكياً، ويراجعون الطلب قبل التفعيل. الشروط شروطهم هم، فاسأل دعمهم عما يطلبونه بالضبط قبل أن تبدأ.
  • لوحة تحكم ميسر مفتوحة أمامك في لسان آخر. ستنقل منها مفتاحين، وستلصق فيها رابطاً واحداً. الانتقال بين اللسانين أسهل من الحفظ عن ظهر قلب.
  • عشر دقائق ونسخ ولصق. لا يوجد شيء تكتبه بيدك هنا. كل شيء يُنسخ.

ما هما المفتاحان؟

المفتاح كلمة طويلة من حروف وأرقام، تعرّف حسابك عند ميسر. ميسر يعطيك اثنين، ولكل واحد عمل مختلف:

المفتاحيبدأ بـمن يراهعمله
المفتاح العام (القابل للنشر) pk_ كل من يفتح صفحة الدفع في متجرك يرسم صندوق البطاقة أمام المشتري. ظهوره للناس عادي وليس خطراً.
المفتاح السري sk_ خادمنا وحده يسأل ميسر «هل دُفع هذا الطلب فعلاً؟». من يملكه يقدر يتصرف بحسابك.
تنبيه: لا ترسل المفتاح السري في واتساب ولا في بريد ولا لأي شخص يطلبه منك، حتى لو قال إنه من الدعم. نحن لا نطلبه منك أبداً.
  1. انسخ المفتاحين من ميسر

    في لوحة ميسر افتح صفحة المفاتيح. ستجد مجموعتين: مجموعة تجربة تبدأ بـ pk_test_ وsk_test_، ومجموعة حقيقية تبدأ بـ pk_live_ وsk_live_.

    ابدأ بمجموعة التجربة. في هذه الشاشة لا يوجد مفتاح «وضع التجربة»، لأن نوع المفاتيح نفسه هو الذي يقرر الوضع.

  2. الصق المفتاحين في متجرك

    افتح إعدادات المتجر ثم الدفع. اجعل صندوق البوابة على ميسر. تظهر تحته خانتان.

    قسم بوابة الدفع في إعدادات متجر الدليل وقد اختير فيه ميسر، ويظهر صندوق البوابة وخانة المفتاح العام وخانة المفتاح السري وهما فارغتان.
    1. 1 صندوق البوابة على ميسر. هذا ما يُظهر الخانتين تحته.
    2. 2 المفتاح العام (القابل للنشر). الصق هنا المفتاح الذي يبدأ بـ pk_.
    3. 3 المفتاح السري. الصق هنا المفتاح الذي يبدأ بـ sk_. الخانة تخفي ما تكتبه، وهذا مقصود.
    يعمل أيضاً: بعد الحفظ ترى شارة محفوظ بجانب المفتاح السري، والخانة تعود فارغة في الشكل. المفتاح لم يُحذف. اتركها فارغة ليبقى المفتاح المحفوظ، واكتب فيها مفتاحاً جديداً حين تريد استبداله.
  3. انسخ رابط الويبهوك إلى لوحة ميسر

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

    في البطاقة الزرقاء رابط الويبهوك ترى عنوان متجرك ينتهي بـ /payment-webhook. اضغط نسخ. ثم في لوحة ميسر افتح Settings ثم Webhooks، وأضف الرابط، واختر الحدثين payment.paid وpayment.failed.

    البطاقة الزرقاء رابط الويبهوك في إعدادات الدفع، وفيها خانة العنوان مع زر نسخ وسطر يشرح خطوات لوحة ميسر، وأسفل الصفحة زر حفظ إعدادات الدفع.
    1. 1 عنوان الويبهوك وزر نسخ. العنوان يخصّ هذا المتجر وحده، ولا يُكتب بيدك.
    2. 2 الخطوات داخل لوحة ميسر، مكتوبة تحت العنوان: Settings ثم Webhooks ثم إضافة الرابط واختيار الحدثين.
    3. 3 زر حفظ إعدادات الدفع أسفل الصفحة.
    تنبيه: انسخ الرابط بالزر، لا بالكتابة. حرف ناقص أو http بدل https يعني أن الرسالة تضيع في الطريق ولا يصير الطلب مدفوعاً.
  4. جرّب طلباً، ثم انتقل إلى المفاتيح الحقيقية

    بمفاتيح التجربة، افتح متجرك واشترِ منتجاً بنفسك حتى النهاية. ميسر يعطيك في وثائقه أرقام بطاقات تجريبية. لا يُخصم منك ريال واحد.

    ثم افتح طلبات المتجر وتأكد أن الطلب صار مدفوع. إن صار، فالويبهوك يعمل.

    بعدها ارجع إلى هذه الشاشة، واستبدل المفتاحين بمفاتيح live، واحفظ. وأضف رابط الويبهوك في وضع live داخل لوحة ميسر أيضاً، لأن الوضعين منفصلان عندهم.

إذا لم ينجح

ما تراهمعناهما تفعله
صفحة الدفع تفتح بيضاء بلا صندوق بطاقة المفتاح العام ناقص أو خاطئ. انسخه من ميسر مرة أخرى، وتأكد أنه يبدأ بـ pk_ وليس sk_.
المشتري دفع والطلب ما زال غير مدفوع الويبهوك لم يصل. افتح لوحة ميسر وتأكد أن الرابط مضاف في الوضع الصحيح، وأن الحدثين مختاران، ثم أعد المحاولة.
الدفع يُرفض دائماً وأنت في وضع التجربة تستعمل بطاقة حقيقية مع مفاتيح تجربة. استعمل أرقام البطاقات التجريبية من وثائق ميسر.
كل شيء نجح في التجربة وفشل بعد النقل إلى live غالباً نسيت رابط الويبهوك في وضع live، أو خلطت مفتاح تجربة مع مفتاح حقيقي. راجع الاثنين. المفتاحان يجب أن يكونا من المجموعة نفسها.
خانة المفتاح السري فارغة بعد الحفظ هذا هو الوضع الطبيعي. الشارة محفوظ بجانبها هي الدليل. لا تفعل شيئاً. اتركها فارغة ما دمت لا تريد تغيير المفتاح.
ميسر يقول: حسابك غير مفعّل بعد مراجعة أوراقك عندهم لم تنتهِ. هذا خارج متجرك. تابع معهم، واستقبل الطلبات بالتحويل البنكي ريثما ينتهون.

أسئلة شائعة

أين مفتاح «وضع التجربة» في هذه الشاشة؟

لا يوجد. ميسر لا يعمل بمفتاح تشغيل، بل بنوع المفاتيح: pk_test_ و sk_test_ تعني تجربة، وpk_live_ و sk_live_ تعني بيعاً حقيقياً. باي لينك وحده عنده مفتاح تشغيل، وهو مشروح في اربط باي لينك.

هل تحتفظون بمفتاحي السري؟

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

هل رابط الويبهوك نفسه لكل متاجري؟

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

غيّرت رابط متجري. هل أعيد شيئاً؟

نعم. العنوان القديم لم يعد يعمل. افتح هذه الشاشة، انسخ العنوان الجديد، واستبدله في لوحة ميسر.

متى يصل المال إلى حسابي؟

حسب اتفاقك مع ميسر، وعادة بعد أيام من الطلب. المال لا يمرّ عبرنا، فلا نقدر نسرّعه ولا نؤخره.

أستطيع تشغيل التحويل البنكي مع ميسر؟

نعم. القسمان مستقلان في الشاشة نفسها. اقرأ اختر بوابة الدفع.

الخطوة التالية

ميسر يعمل. أكمل صورة الدفع في متجرك:

هل ساعدك هذا الشرح؟

إن بقي عندك سؤال، تواصل معنا من صفحة الدعم.

اقرأ أيضاً

← كل الشروحات