تخط وانتقل إلى المحتوى الرئيسي

الربط مع Stripe

  • ربط بوابة الدفع Stripe مع المنصة

    ما هي Stripe؟

    Stripe هي بوابة دفع إلكترونية تمكّنك من استقبال المدفوعات عبر الإنترنت، مثل بطاقات الائتمان وبطاقات الخصم وغيرها، ثم تحويل هذه المدفوعات إلى حسابك البنكي.

    تتيح المنصة إمكانية الربط مع Stripe بسهولة من خلال إعداد بعض القيم الأساسية.

    طريقة الربط

    أولًا: الحصول على مفاتيح Stripe

    1. الدخول إلى لوحة التحكم

    • سجّل الدخول إلى حسابك في Stripe

    • من القائمة الجانبية انتقل إلى:

      Developers → API keys


    2. التأكد من وضع الحساب (Live Mode)

    • من أسفل القائمة الجانبية في Stripe:

      تأكد أن خيار View test data غير مفعّل


    ⚠️ تنبيه مهم

    • يجب أن يكون الحساب في:

      Live mode (الوضع الحقيقي)

    • لا تستخدم مفاتيح Test إطلاقاً

    • المنصة تعمل فقط على مفاتيح Live


    كيف تتأكد أنك في الوضع الصحيح؟

    • إذا كان زر View test data:

      • مفعّل → Test Mode ❌

      • غير مفعّل → Live Mode ✅


    3. الحصول على Publishable Key

    • ضمن قسم Publishable key

    • ستجد المفتاح ظاهر مباشرة

    • يجب أن يبدأ بـ:

      pk_live_

    ✔️ قم بنسخه


    4. الحصول على Secret Key

    • ضمن قسم Secret key

    • اضغط على:

      Reveal live key

    • سيظهر المفتاح ويبدأ بـ:

      sk_live_

    ✔️ قم بنسخه وحفظه بشكل آمن

    5. إنشاء Secret Key جديد (اختياري)

    في حال لم يظهر المفتاح:

    • اضغط:

      Create secret key

    سيتم إنشاء مفتاح جديد يمكنك استخدامه مباشرة


ثانياً: الحصول على Webhook Secret

6. إنشاء Webhook

  • انتقل إلى:

    Developers → Webhooks

  • اضغط:

    + Add destination

  • اختيار الأحداث

    • اختر:

      Your account

    • قم بالنزول للأسفل

    • في مربع البحث اكتب:

      payment_intent.succeeded
    • فعّل الحدث ✔️

    • اضغط:

      Continue

  • اختيار نوع الربط

    • تأكد أن الخيار المحدد هو:

      Webhook endpoint

    • لا تغيّر أي شيء

    • اضغط:

      Continue

  • إدخال بيانات الـ Webhook

    • في حقل Destination name:

      اكتب أي اسم (مثال: Acadimiat webhook)

    • في حقل Endpoint URL:

      https://v1.acadimiat.com/v1/payments/stripe-webhook
    • اضغط:

      Create destination


7. نسخ Webhook Secret

  • بعد الإنشاء، ستظهر قائمة الـ Webhooks

  • اضغط على الـ Webhook الذي أنشأته

  • ابحث عن:

    Signing secret

  • اضغط على زر إظهار القيمة 👁️

  • ستظهر لك قيمة تبدأ بـ:

    whsec_

✔️ قم بنسخها


ثالثاً : ربط Stripe مع المنصة

  • انتقل إلى:

    لوحة التحكم > إعدادات عامة > بوابات الدفع

  • اضغط على:

    ربط البوابة

  • أدخل القيم التالية:

  • اضغط:

    حفظ


النتيجة

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

هل أجاب هذا عن سؤالك؟