انتقل إلى المحتوى

💳 إعدادات الدفع

تتيح لك إعدادات الدفع تهيئة بوابات الدفع التي يدعمها تطبيقك. يستخدم المستخدمون هذه البوابات لشراء العملات والماسات داخل التطبيق، والتي يستخدمونها بعد ذلك لإرسال الهدايا والوصول إلى الميزات المميزة والمزيد.

كيفية الوصول

الإعدادات ← الدفع

⚙️ فتح إعدادات الدفع

بوابات الدفع المدعومة

يدعم النظام بوابات الدفع التالية. يمكن تفعيل أو تعطيل كل بوابة بشكل مستقل:

1. Stripe

Stripe هي منصة دفع عالمية تدعم بطاقات الائتمان/الخصم وطرق دفع متنوعة في معظم الدول.

الحقل الوصف مطلوب
Secret Test Key مفتاح Stripe السري الخاص بك (يبدأ بـ sk_test_ للاختبار أو sk_live_ للإنتاج) ✅ نعم
Success URL الرابط الذي يتم توجيه المستخدمين إليه بعد عملية دفع ناجحة ✅ نعم
Cancel URL الرابط الذي يتم توجيه المستخدمين إليه في حال إلغاء عملية الدفع ✅ نعم
Currency عملة المعاملات (مثل usd، eur، sar) ✅ نعم
Webhook Secret Key مفتاح توقيع webhook من Stripe (يبدأ بـ whsec_) للتحقق من أحداث webhook ✅ نعم
Webhook URL نقطة نهاية الخادم الخاصة بك التي تستقبل أحداث دفع Stripe: BASE_URL/api/stripe-callback ✅ نعم

كيفية الحصول على بيانات اعتماد Stripe

  1. اذهب إلى https://dashboard.stripe.com وأنشئ حسابًا أو سجّل الدخول.
  2. انتقل إلى Developers → API Keys للعثور على المفتاح السري الخاص بك.
  3. انتقل إلى Developers → Webhooks لإعداد نقطة نهاية webhook والحصول على Webhook Secret Key.
  4. استخدم مفاتيح الاختبار (sk_test_...) أثناء التطوير وانتقل إلى المفاتيح الحية (sk_live_...) للإنتاج.

2. Fawry

Fawry هي بوابة دفع شائعة في مصر والشرق الأوسط، وتدعم طرق دفع محلية متنوعة بما في ذلك أرقام مرجع Fawry وبطاقات الائتمان والمحافظ الإلكترونية.

الحقل الوصف مطلوب
Server Secret مفتاح خادم Fawry السري للمصادقة على طلبات API ✅ نعم
Merchant Code معرّف التاجر الفريد المقدم من Fawry ✅ نعم
URL نقطة نهاية Fawry API لبدء عمليات الدفع (مثل https://atfawry.fawrypay.com/fawrypay-api/api/payments/init) ✅ نعم
Return URL الرابط الذي يتم توجيه المستخدمين إليه بعد إتمام الدفع: BASE_URL/api/utd-fawry-callback ✅ نعم
Webhook URL نقطة نهاية الخادم الخاصة بك لإشعارات دفع Fawry: BASE_URL/api/fawry-callback ✅ نعم

كيفية الحصول على بيانات اعتماد Fawry

  1. سجّل للحصول على حساب تاجر في Fawry عبر https://atfawry.fawrypay.com.
  2. بعد الموافقة، ستحصل على Merchant Code وServer Secret الخاصين بك.
  3. استخدم رابط بيئة الاختبار للتجربة ورابط الإنتاج للمدفوعات الحية.

تفعيل بوابة الدفع

  1. اذهب إلى تبويب الدفع في الإعدادات.
  2. ابحث عن بوابة الدفع التي تريد تفعيلها.
  3. بدّل المفتاح إلى تشغيل (أخضر) لتفعيلها.
  4. أدخل جميع بيانات الاعتماد والروابط المطلوبة للبوابة.
  5. اضغط على "حفظ" لتطبيق التهيئة.

إعدادات الدفع

تعطيل بوابة الدفع

  1. بدّل المفتاح إلى إيقاف للبوابة التي تريد تعطيلها.
  2. اضغط على "حفظ".

تحذير

تعطيل بوابة الدفع سيمنع المستخدمين فورًا من إجراء عمليات الدفع عبر تلك البوابة. تأكد من بقاء بوابة واحدة على الأقل مفعّلة.

الاختبار بعد التهيئة

بعد تهيئة بوابة الدفع، يُوصى بما يلي:

  1. إجراء عملية دفع اختبارية صغيرة عبر التطبيق للتحقق من عمل البوابة بشكل صحيح.
  2. التحقق من ظهور عملية الدفع في لوحة تحكم البوابة الخاصة بك (لوحة تحكم Stripe أو لوحة تحكم Fawry).
  3. التأكد من إضافة العملات/الماسات بشكل صحيح إلى حساب المستخدم التجريبي.
  4. التحقق من أن نقطة نهاية webhook تستقبل تأكيدات الدفع.

نصائح

  • استخدم دائمًا بيانات اعتماد الاختبار/بيئة التجربة أثناء الإعداد الأولي، ثم انتقل إلى بيانات اعتماد الإنتاج عندما تكون جاهزًا للإطلاق.
  • حافظ على سرية مفاتيحك السرية وأسرار webhook — لا تشاركها علنًا أبدًا.
  • تأكد من أن روابط webhook الخاصة بك متاحة من الإنترنت (ليست خلف جدار حماية أو VPN).
  • راقب لوحات تحكم بوابات الدفع بانتظام لتتبع المعاملات واكتشاف أي مشكلات.

الخطوة التالية

🔔 تهيئة إعدادات Pusher