# ربط باي بال لاستقبال الدفع من المحافظ
HTML: https://manhali.com/help/connect-paypal
Markdown: https://manhali.com/help/connect-paypal.md
Published: 2026-11-02T09:00:00.000Z
Updated: 2026-11-02T09:00:00.000Z
Type: doc
Category: المدفوعات والطلبات
Series: بوابات الدفع
اربط تطبيق PayPal بمعرّف العميل والمفتاح السري ومعرّف Webhook لتقبل الدولار واليورو.
باي بال (PayPal) يسمح لطلابك بالدفع من محفظتهم. يناسب الأكاديميات التي تبيع بالدولار أو اليورو لطلاب في أكثر من بلد.
## قبل أن تبدأ
- باي بال يقبل **الدولار (USD) واليورو (EUR)** فقط. اضبط [عملة أكاديميتك](/help/academy-currency) على إحداهما، وإلا لم يظهر لطلابك.
- أنشئ تطبيقًا في لوحة PayPal للمطورين، وجهّز **معرّف العميل (Client ID)** و**المفتاح السري**.
- في الوضع الحي يجب إطفاء **وضع الاختبار** (بيئة تجربة لا تنقل أموالًا حقيقية)، وإلا رُفض حفظ البوابة وهي مفعّلة.
## خطوات الربط
1. افتح [**الإعدادات › التكاملات**](https://dash.manhali.com/integrations)، واضغط **ربط** على بطاقة **باي بال**.
2. في خطوة **بيانات الحساب** أدخل **معرّف العميل** و**المفتاح السري**.
3. اجعل **وضع الاختبار** مغلقًا للدفع الحقيقي. شغّله للتجربة فقط؛ لا تقبل منهلي حفظ البوابة وهو مفعّل في الوضع الحي.
4. اضغط **حفظ ومتابعة**.
5. في خطوة **إشعارات الدفع** انسخ رابط Webhook، وأنشئ Webhook على هذا الرابط في تطبيقات PayPal. اشترك في حدثي `PAYMENT.CAPTURE.COMPLETED` و`CHECKOUT.ORDER.APPROVED`.
6. انسخ **معرّف Webhook** من PayPal والصقه في الحقل المخصص. يتكون من أحرف إنجليزية وأرقام فقط، ولا يتجاوز 50 حرفًا أو رقمًا.
7. اضغط **حفظ ومتابعة**.
8. في **المراجعة والتفعيل** شغّل **تفعيل PayPal**، ثم اضغط **حفظ وتفعيل**.
## ماذا يحدث بعد ذلك؟
تظهر البطاقة **متصل**، ويظهر باي بال للطالب بين طرق الدفع إذا كانت عملة أكاديميتك دولارًا أو يورو. تتبّع الدفعات من [**المبيعات › الطلبات**](https://dash.manhali.com/orders)، ويمكنك [استرداد](/help/refund-order) طلب دُفع عبر باي بال من نافذة الطلب.
## إذا واجهت مشكلة
- **«أدخل معرّف إشعارات صحيحًا من PayPal (حتى 50 حرفًا أو رقمًا)»**: تأكد أن القيمة معرّف Webhook وليست الرابط.
- **باي بال لا يظهر للطالب**: تحقق من العملة (USD أو EUR) ومن أن **وضع الاختبار** مغلق.