# ربط سترايب لاستقبال البطاقات العالمية

HTML: https://manhali.com/help/connect-stripe
Markdown: https://manhali.com/help/connect-stripe.md
Published: 2026-11-02T09:00:00.000Z
Updated: 2026-11-02T09:00:00.000Z
Type: doc
Category: المدفوعات والطلبات
Series: بوابات الدفع

اربط حسابك في Stripe بالمفاتيح وسرّ التوقيع لتستقبل بطاقات طلابك من بلدان كثيرة.

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

## قبل أن تبدأ

- جهّز من لوحة Stripe: المفتاح السري، والمفتاح العام (Publishable key). في الوضع الحي يلزم مفتاح حقيقي يبدأ بـ `sk_live_` أو `rk_live_`.
- يُفضَّل استعمال **مفتاح مقيَّد** (`rk_live_`) بصلاحيات الدفع والاسترداد فقط، فهو أكثر أمانًا من المفتاح الكامل.
- لا تتحقق منهلي من العملة هنا. إن لم يقبل حسابك في Stripe عملة أكاديميتك، يرفض Stripe الدفع عند الطالب.

## خطوات الربط

1. افتح [**الإعدادات › التكاملات**](https://dash.manhali.com/integrations)، واضغط **ربط** على بطاقة **سترايب**.

![الإعدادات › التكاملات › المدفوعات › سترايب](/help/screenshots/payments/stripe-card.webp "بطاقة سترايب في قسم المدفوعات")

2. في خطوة **بيانات الحساب** أدخل **المفتاح السري** و**المفتاح العام** (`pk_live_...`)، ثم اضغط **حفظ ومتابعة**.
3. في خطوة **إشعارات الدفع** انسخ رابط Webhook بزر **نسخ**.
4. في لوحة Stripe أنشئ Webhook على هذا الرابط، واختر الحدثين: `checkout.session.completed` و`payment_intent.succeeded`، وهما اللذان تعتمد عليهما منهلي لتأكيد الدفع. (الـ Webhook رابط يخبر به Stripe منهلي عند نجاح كل دفعة، والحدث نوع الإشعار الذي ترسله Stripe، مثل نجاح الدفع.)
5. انسخ **سر التوقيع** (`whsec_...`) من صفحة نقطة النهاية في Stripe، والصقه في **سر Webhook**.
6. اضغط **حفظ ومتابعة**.
7. في **المراجعة والتفعيل** شغّل **تفعيل Stripe**، ثم اضغط **حفظ وتفعيل**.

## ماذا يحدث بعد ذلك؟

تصبح البطاقة **متصل**. يدفع الطالب بالبطاقة فيتحول طلبه إلى **مدفوع** ويفتح له الدورة تلقائيًا. تجد الدفعة في [**المبيعات › الطلبات**](https://dash.manhali.com/orders)، وفي تفاصيل الطلب قسم **بيانات بوابة الدفع** فيه مرجع العملية لتبحث عنه في لوحة Stripe.

## إذا واجهت مشكلة

- **«المفتاح السري مطلوب»**: يطلب كل حقل من الخطوتين الأوليين قبل التفعيل.
- **رفض حفظ مفتاح اختباري**: في الوضع الحي لا يُقبل إلا `sk_live_` أو `rk_live_`.
- **الدفع لا يكتمل رغم نجاحه في Stripe**: غالبًا رابط Webhook غير مضاف، أو **سر Webhook** (سر التوقيع) خاطئ. أعد النسخ من لوحة Stripe.

