توثيق واجهة برمجة التطبيقات v1.0

سهل الربط، فوري التحديث، آمن تماماً

قم بدمج بوابة RACORE Gateway في مشروعك خلال 5 دقائق فقط. نحن ندعم الويب هوكس الفورية، وسكربتات الدفع المرنة القابلة للتضمين داخل أي iframe أو متجر Shopify وأيزي أوردر.

</>{}

إعداد مستمع الويب هوك (Webhook Listener)

عند إتمام عملية دفع مطابقة لمبلغ الفاتورة بنجاح، يرسل الخادم طلب HTTP POST محمل ببيانات العملية إلى خادمك. يجب فحص مفتاح الـ API للتحقق من هوية المرسل.

// Node.js Express Webhook Handler
app.post('/api/racore-webhook', express.json(), (req, res) => {
  const { amount, sender, api_key, id } = req.body;
  
  // 1. التحقق من مفتاح الـ API الأمني
  if (api_key !== process.env.RACORE_API_KEY) {
    return res.status(401).send('فشل المصادقة');
  }
  
  // 2. تحديث حالة الطلب في قاعدة بياناتك
  console.log(`تم استلام ${amount} ج.م من ${sender} برقم معاملة ${id}`);
  
  res.status(200).json({ status: 'success', message: 'تم التحديث' });
});

عناصر وهيكل الـ JSON للويب هوك

الحقلالنوعالشرح
idString (UUID)معرف المعاملة الفريد المولد بالشبكة.
amountFloatقيمة التحويل المالي (مثال: 150.00).
senderStringاسم الشخص الراسل من إشعار الموبايل.
api_keyStringمفتاح الـ API الخاص ببوابتك لتوثيق المصدر.

أقسام التوثيق

  • • إعداد مستمع الويب هوك
  • • معايير الأمان والحقن البرمجي
  • • تخصيص واجهة الـ Widget بالـ CSS
  • • الربط التلقائي مع شوبيفاي (Shopify)
  • • إرسال البيانات المرتجعة لأيزي أوردر

تحتاج مساعدة فنية؟

يتواجد خبراء الدعم الفني لدينا على مدار الساعة لمساعدتك في الربط وتخصيص الكود.

تواصل مع خبير