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

Stripe

تعليمات لربط Stripe​

أنشئ حساب دفع من نوع Stripe​

تم وصف كيفية إنشاء حساب دفع هنا (يفتح في علامة تبويب جديدة).

قم بربط Stripe بحساب الدفع​

للقيام بذلك، انتقل إلى حساب الدفع الذي أنشأته واضغط على Connect Stripe

نموذج تعديل حساب الدفع stripe، وسهم يشير إلى زر "Connect Stripe" أسفل خانة "Test mode"

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

بعد الربط، انتقل إلى Developers → Webhooks في لوحة تحكم Stripe واضغط على Add destination.

اتبع خطوات معالج إنشاء وجهة الحدث: اختر الأحداث التي تريد الاستماع إليها، اختر نوع الوجهة (نقطة نهاية webhook)، وفي خطوة الإعداد، أدخل عنوان webhook الخاص بنا في حقل Endpoint URL. استبدل test-project.oneentry.cloud بعنوان مشروعك:

https://test-project.oneentry.cloud/api/content/payments/webhook/stripe

حدد اسم الوجهة وأكمل الإنشاء — ستظهر نقطة النهاية الجديدة في قائمة وجهات الأحداث بحالة نشطة.

لكي يتحقق OneEntry من صحة الأحداث القادمة من Stripe، انسخ سر التوقيع (Signing secret) لنقطة النهاية التي أنشأتها في لوحة تحكم Stripe. ستحتاجه في إعدادات حساب الدفع.

بعد إضافة webhook، انتقل إلى نظام إدارة المحتوى في Payments → Statuses، اختر مستودع الطلبات وانتقل إلى إعداداته

تبويب "Statuses" في "Payments": يعرض الجدول "Order Storage 1" بالمعرّف storage1 وأيقونة الإعدادات

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

شاشة "Payment Status Settings": حالات الدفع "Waiting" و"Completed" و"Canceled" و"Payment has expired" مربوطة بحالات الطلب، وزر "Save"

املأ إعدادات الحساب​

افتح حساب الدفع للتعديل. في قسم Details، حدد:

  • Success URL — العنوان الذي سيعود إليه المشتري بعد الدفع الناجح. هذا الحقل إلزامي.
  • Cancel URL — العنوان الذي سيعود إليه المشتري عند إلغاء الدفع.
  • Session timeout — مدة حياة جلسة الدفع. يجب أن تكون القيمة عددًا صحيحًا أكبر من 0.
  • Use Stripe webhook data validation — يشمل التحقق من صحة البيانات التي ترسلها Stripe إلى webhook.
  • Key for validating Stripe webhook — سر التوقيع لنقطة النهاية من لوحة تحكم Stripe. يصبح هذا الحقل متاحًا فقط عند تحديد خيار Use Stripe webhook data validation، وفي هذه الحالة يكون إلزاميًا.

يتم حفظ التغييرات تلقائيًا.

كتلة "Details" لحساب الدفع stripe: سهم يشير إلى الحقلين "Success URL" و"Cancel URL"

يوجد دعم لوضع الاختبار في حساب الدفع. تتيح هذه الميزة اختبار ربط Stripe باستخدام معلمات اتصال تجريبية.

حساب الدفع stripe: سهم يشير إلى خانة "Testing mode" غير المحددة فوق زر "Connect Stripe"

لإيقاف وضع الاختبار، قم بإلغاء تحديد الخيار