ربط بوابة الدفع ميسر (والانتقال من وضع المحاكاة)
تجربة المتجر بوضع المحاكاة وبطاقات الاختبار، ثم ربط حساب ميسر الخاص بالجمعية: المفاتيح، الـWebhook، وطرق الدفع.
يدفع المتبرع عبر ميسر — بوابة دفع مرخّصة من البنك المركزي السعودي — بحساب مسجّل باسم الجمعية، فتصل التسويات مباشرة إلى حساب الجمعية البنكي. وقبل أن يجهز حساب ميسر يمكن تجربة المسار كاملاً بـوضع المحاكاة.
تحتاج صلاحية: تعديل المتجر وإعداداته
التجربة بوضع المحاكاة
- 1من متجر التبرعات ← الإعدادات ← بطاقة بوابة الدفع اختر «وضع المحاكاة (اختبار)» ثم حفظ التغييرات. لا يحتاج هذا الوضع أي مفاتيح.
- 2افتح موقع الجمعية ← فرص التبرع وتبرّع كأي زائر. تظهر في صفحة الدفع شارة محاكاة وتنبيه «بيئة اختبار — لا تُدخل بيانات بطاقة حقيقية».
- 3استخدم إحدى بطاقات الاختبار (تظهر أيضاً في الصفحة تحت بطاقات الاختبار)، بأي تاريخ انتهاء مستقبلي وأي CVC، ورمز التحقق دائماً
1234.
| رقم البطاقة | النتيجة |
|---|---|
4111111111111111 | فيزا — تنجح |
5555555555554444 | ماستركارد — تنجح |
5888450000000003 | مدى — تنجح |
4000000000000002 | يرفضها البنك |
4000000000009995 | رصيد غير كافٍ |
sim_. جرّب بمبالغ صغيرة، واطلب من المحاسب عكس قيود التجربة قبل الإطلاق إن لزم.تجهيز حساب ميسر
تفتح الجمعية حسابها لدى ميسر (moyasar.com) باسمها وسجلّها، وتُكمل التوثيق المطلوب منهم. بعد اعتماد الحساب تحصل من لوحة ميسر على:
- المفتاح المعلن (Publishable Key) — يبدأ بـ
pk_live_(أوpk_test_للتجربة). - المفتاح السري (Secret Key) — يبدأ بـ
sk_live_(أوsk_test_). - رمز Webhook السري (Secret Token) — من Webhooks في لوحة ميسر.
إدخال المفاتيح في غيث
- 1في بطاقة بوابة الدفع اختر «ميسر (إنتاج)»، ثم الصق المفتاح المعلن (Publishable) والمفتاح السري (Secret) ورمز Webhook السري.
حقول مفاتيح ميسر - 2اضغط حفظ التغييرات. يرفض النظام مفتاحاً لا يبدأ بالبادئة الصحيحة، أو مفتاحين من بيئتين مختلفتين (تجريبي مع إنتاج).
ضبط الـWebhook في لوحة ميسر
الـWebhook هو إشعار ترسله ميسر لموقع الجمعية عند نجاح الدفع أو فشله، فيُقيَّد التبرع حتى لو أغلق المتبرع الصفحة قبل العودة للموقع.
- 1في لوحة ميسر افتح Webhooks وأضف عنواناً جديداً بالصيغة الظاهرة في حقل عنوان الـWebhook:
https://<نطاق-موقع-الجمعية>/api/store/webhook— ضع مكان<نطاق-موقع-الجمعية>نطاق موقعكم الفعلي (مثلwww.example.org.sa). - 2اختر الحدثين
payment_paidوpayment_failed. - 3انسخ Secret Token من ميسر والصقه في حقل رمز Webhook السري في غيث، ثم احفظ.
طرق الدفع
- 1في طرق الدفع المتاحة فعّل الطرق المتفق عليها في عقد ميسر: مدى، بطاقات ائتمانية، Apple Pay، STC Pay. الطريقة غير المفعّلة لا تظهر للمتبرع.
- 2فعّل «تحويل بنكي (بمراجعة)» إن أردت قبول التحويل البنكي: يظهر خياراً في صفحة الدفع متى وُجد حساب بنكي معلن في الموقع، ويرفع المتبرع إيصاله ليراجعه الموظف في العمليات. ألغِه لإخفاء التحويل البنكي من صفحة الدفع.
قائمة الإطلاق
- البوابة على ميسر (إنتاج) والمفتاحان بالبادئة
_live_. - الـWebhook مضاف في ميسر بنطاق الموقع الصحيح، ورمزه محفوظ في غيث.
- حساب النقد/البنك المستلم في الوجهة المحاسبية هو حساب البنك الذي تصله تسويات ميسر.
- تبرّع تبرعاً حقيقياً صغيراً، وتأكد من ظهوره مدفوعة في العمليات بمرجع ميسر.
أسئلة شائعة
دفع المتبرع ونجحت العملية لدى ميسر لكنها «معلّقة» في غيث؟+
غالباً الـWebhook غير مضبوط أو رمزه السري خاطئ. راجع عنوان الـWebhook ورمزه في لوحة ميسر وفي غيث. عند ضبطه تعيد ميسر الإرسال فتُقيَّد العملية مرة واحدة دون تكرار.
هل يمكن العودة لوضع المحاكاة بعد الإنتاج؟+
نعم بتبديل الخيار، لكن تجنّب ذلك والمتجر معلن للجمهور، لأن المتبرعين سيرون صفحة دفع تجريبية لا تخصم شيئاً.