ما تحتاجه
| الحقل | ما يفعله |
|---|---|
| معرّف مفتاح API | يتيح لنا استدعاء مفتاح MakePay الصحيح. ليس سرياً. |
| سر مفتاح API | يتيح لنا إنشاء دفعات MakePay في حسابك. سري. |
| سر توقيع الـ webhook | يؤكّد أن webhook أتى فعلاً من MakePay. سري. |
| عنوان النجاح / عنوان الفشل | حيث يصل المشتري بعد الدفع أو بعد فشل الدفع أو إلغاؤها. |
يصدر MakePay معرّف مفتاح API وسره معاً حين تنشئ مفتاحاً؛ وسر توقيع الـ webhook قيمة منفصلة من إعدادات الـ callback.
لماذا نطلب كل حقل
معرّف مفتاح API
يعرّف مفتاح MakePay الذي نستخدمه في المصادقة. ليس سرياً بمفرده، لكنه مقترِن مع السر أدناه.
سر مفتاح API
يفوّض إنشاء الدفعة، فتجري الخصمة عبر حسابك وتستقر في محفظتك. يعرضه MakePay مرة واحدة فقط، مباشرة بعد إنشاء المفتاح.
سر توقيع الـ webhook
يثبت أن webhook وارداً من MakePay فعلاً، فلا يستطيع أحد تزوير حدث "مدفوع". وهو قيمة منفصلة عن مفتاح API.
عنوان النجاح والفشل
إعدادات بسيطة: حيث يصل المشتري بعد الدفع أو بعد فشل الدفع أو إلغاؤها. ليست سرية.
الإعداد
- أنشئ مفتاح API في MakePay
سجّل الدخول إلى MakePay وافتح API & SDK → API integrations. تحت API keys، انقر Generate API Key، سمّه مثلاً "Coin Moebius"، وأنشئه. يعرض MakePay معرّف مفتاح API وسره مرة واحدة فقط، مباشرة بعد الإنشاء — انسخ كليهما الآن، لأن السر لن يُعرَض مرة أخرى.
MakePay → API & SDK → API integrations → Generate API Key تعامل مع سر مفتاح API ككلمة مرور. إن نسيته، أنشئ مفتاحاً جديداً بدلاً من محاولة استرجاع القديم.
- ابحث عن معرّف مشروعك في Coin Moebius
في تبويب منفصل، افتح مشروعك في لوحة تحكم Coin Moebius وانسخ معرّف المشروع من أسفل اسم المشروع. عنوان webhook MakePay الخاص بك هو ذلك المعرّف مُدرَجاً في العنوان أدناه — ستلصقه في MakePay في الخطوة التالية.
https://api.coinmoebius.com/webhook/makepay/<your project id>Coin Moebius → مشروعك → معرّف المشروع تُظهر بطاقة المزود المتصل (الخطوة الأخيرة) العنوان ذاته، فيمكنك إعادة نسخه في أي وقت.
- اضبط عنوان الـ callback وانسخ سر توقيع الـ webhook
عُد إلى MakePay، مرّر لأسفل إلى Delivery → Callback URL configuration. انقر Edit Callback URL، الصق عنوان webhook Coin Moebius كوجهة نشطة، واحفظ. بعدها، تحت Webhook signing، انسخ سر التوقيع (استخدم Regenerate secret إن لم تكن هناك قيمة بعد) — ذلك هو سر الـ webhook الذي يطلبه Coin Moebius.
MakePay → Delivery → Callback URL configuration ينشر MakePay تحديثات التسليم إلى هذا العنوان بعد كل تغيير حالة ملحوظ للتاجر. سر التوقيع منفصل عن مفتاح API — تحتاج إليهما كليهما.
- اربط في لوحة تحكم Coin Moebius
في Coin Moebius، افتح Providers → Add provider → MakePay. الصق معرّف مفتاح API الخاص بك وسر مفتاح API وسر توقيع الـ webhook، ثم اضبط عنوان النجاح وعنوان الفشل (حيث يصل المشترون بعد الدفع أو بعد فشل الدفع). انقر Save.
Coin Moebius → Add provider → MakePay تبقى الأسرار المحفوظة مختفية. لتغيير واحد لاحقاً، اختر Replace والصق القيمة الجديدة.
- أنت متصل الآن
يظهر MakePay الآن في تبويب Providers الخاص بك مع تاريخ الاتصال وعنوان webhook المتوقع. إن لم تكن قد فعلت بعد، الصق ذلك العنوان في إعدادات callback في MakePay. استخدم Edit لتدوير المفاتيح أو Disconnect لإزالته، واستخدم مبدّل وضع الاختبار للمرور بطلب دون التأثير على أرقامك الحقيقية.
Coin Moebius → Providers → MakePay (متصل)
بعد أن تربط
أجرِ طلباً واحداً قبل الإطلاق:
- فعّل مبدّل وضع الاختبار على بطاقة MakePay المتصلة للمرور بطلب دون التأثير على أرقامك الحقيقية.
- أنشئ منتجاً واضبط زر الشراء على صفحة (ملف HTML محلي يعمل) موجَّهاً إلى مشروعك.
- أتمِم الدفع عبر MakePay.
- افتح تبويب المعاملات. حين تبلغ حالة الصف الجديد succeeded، تعمل مفاتيحك و webhook من البداية إلى النهاية.
عطّل وضع الاختبار حين تكون جاهزاً للمدفوعات الحقيقية.
حل المشكلات
ابدأ بالتحقق من لوحة التحكم: تأكّد أن بطاقة MakePay متصلة وأن عنوان webhook يطابق وجهة الـ callback المحفوظة في MakePay.
تكتمل الدفعة لكن الطلب يبقى معلّقاً.
لا يصل الـ webhook أو لا يتحقق. تأكّد أن عنوان الـ callback في MakePay يطابق عنوان webhook مشروعك تماماً، وأن سر الـ webhook في Coin Moebius يطابق سر التوقيع في MakePay.
حفظ المزود مُرفَوض.
معرّف مفتاح API وسر مفتاح API وسر الـ webhook مطلوبة جميعها. أعد نسخ كليهما من MakePay — لا يُعرَض السر إلا مرة واحدة، لذا أنشئ مفتاحاً جديداً إن فقدته.
طلب اختبار لم يظهر في المعاملات أبداً.
فعّل مبدّل وضع الاختبار على بطاقة MakePay قبل تشغيل زر الشراء، وتأكّد أن المنتج موجَّه إلى المشروع ذاته.
جيد أن تعرف
ليس احتفاظ بالمال. يستقر MakePay الأموال مباشرة في محفظتك الخاصة. لا يحتفظ Coin Moebius بالأموال ولا يستطيع تحريكها.
تدوير الأسرار. أنشئ مفتاح API جديداً أو دوّر سر توقيع الـ webhook في أي وقت، ثم اختر Replace في لوحة التحكم والصق القيمة الجديدة. تبقى الحقول السرية فارغة عند التعديل.
أسئلة؟ Join our Discord