> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lumi.new/llms.txt
> Use this file to discover all available pages before exploring further.

# PayPal

> اقبل مدفوعات PayPal واشتراكاته في موقعك.

يمكنك إعداد مدفوعات PayPal بالكامل عبر محادثة Lumi. اذكر PayPal في طلبك وصِف ما تريد بيعه:

* "اسمح للناس بشراء كتابي الإلكتروني عبر PayPal بدفعة واحدة قدرها \$15."
* "أضف عضوية بسعر \$9.99 شهريًا تُدفع عبر PayPal."

ببيانات اعتماد تطبيقك على PayPal، يعمل Lumi مباشرة في حسابك التجاري على PayPal ويبني مسار الدفع بالكامل في موقعك:

* **المدفوعات لمرة واحدة**: زر PayPal ينقل المشتري إلى PayPal للموافقة على الدفع، ثم يسجّل الدفعة المكتملة في قاعدة بياناتك.
* **الاشتراكات**: ينشئ Lumi المنتج وخطة الاشتراك في حسابك على PayPal (ويعيد استخدام الموجود منها بالاسم والسعر نفسيهما)، ويضيف زر اشتراك، ويُبقي حالة كل اشتراك محدّثة.
* **Webhook**: يسجّل Lumi webhook ليتلقى موقعك إشعارًا عند اكتمال المدفوعات أو استردادها، أو عند تفعيل الاشتراكات أو إلغائها أو تعليقها أو فشل تجديدها.
* **صفحة الأسعار وتقييد المحتوى**: لا يُعرض المحتوى المدفوع إلا للعملاء الذين دفعوا.

ويمكنك أيضًا أن تسأل Lumi عن حسابك على PayPal في أي وقت، مثل «اعرض معاملاتي الأخيرة» أو «اعرض خطط الاشتراك لديّ» أو «استرد مبلغ هذا الطلب» أو «ألغِ هذا الاشتراك».

> [!NOTE]
>
> PayPal متاح لمشاريع الويب. إذا لم تحدد مزوّد دفع، يستخدم Lumi [Stripe](https://docs.lumi.new/ar/features/stripe.md).

## اربط بيانات اعتماد PayPal

**1. أنشئ تطبيق REST في PayPal**

في PayPal Developer Dashboard، انتقل إلى **Apps & Credentials** وأنشئ تطبيق REST أو افتح تطبيقًا موجودًا. استخدم تبويب **Sandbox** للاختبار، أو تبويب **Live** للمدفوعات الحقيقية. انسخ **Client ID** و**Secret key** الخاصين بالتطبيق.

**2. أدخل بيانات الاعتماد في Lumi**

إما أن تملأ بطاقة بيانات اعتماد PayPal التي يعرضها Lumi في المحادثة، أو أن تفتح تبويب **الأدوات** في مساحة العمل وتنقر على بطاقة **PayPal**. أدخل **PayPal client ID** و**PayPal client secret**، واختر **Environment** (**بيئة تجريبية** أو **بيئة فعلية**)، ثم انقر على **حفظ** و**تحقق**.

> [!WARNING]
>
> لا تلصق بيانات اعتمادك في رسالة محادثة أبدًا. تُحفظ بأمان في [الأسرار](https://docs.lumi.new/ar/features/secrets.md) الخاصة بمشروعك. بيانات اعتماد Sandbox لا تعمل إلا مع البيئة التجريبية، وبيانات اعتماد Live لا تعمل إلا مع البيئة الفعلية. وعدم التطابق هذا هو السبب الأكثر شيوعًا لرفض PayPal بيانات الاعتماد.

### تحكّم فيما يستطيع Lumi تغييره

في بطاقة **PayPal** ضمن تبويب الأدوات، لكل إجراء يغيّر حسابك على PayPal إعداد موافقة: **اسمح دائمًا** أو **اسأل في كل مرة** أو **لا تسمح أبدًا**. افتراضيًا، يُسمح بإنشاء المنتجات والخطط، بينما يطلب **استرداد الأموال** و**إلغاء الاشتراكات** موافقتك في كل مرة. والإجراءات التي تقتصر على القراءة، مثل عرض قائمة المعاملات، مسموحة دائمًا.

## الاختبار والانتقال إلى الوضع الفعلي

**1. اختبر في البيئة التجريبية**

مع بيانات اعتماد Sandbox، لا تنتقل أي أموال حقيقية. في صفحة PayPal، سجّل الدخول بحساب مشترٍ تجريبي (PayPal Developer Dashboard ← **Testing Tools** ← **Sandbox Accounts** ← البريد الإلكتروني وكلمة المرور لحساب من نوع Personal). بعد الدفع، تحقق من ظهور سجل الدفعة أو الاشتراك في [السحابة → البيانات](https://docs.lumi.new/ar/features/databases.md) ومن أن صفحتك تعرض عملية الشراء.

**2. انتقل إلى الوضع الفعلي**

أنشئ تطبيق Live في PayPal، ثم أدخل في بطاقة **PayPal** الـ Client ID والـ Secret الخاصين به واضبط Environment على **بيئة فعلية**. اطلب من Lumi الانتقال إلى الوضع الفعلي: لا تنتقل المنتجات والخطط من البيئة التجريبية، لذا يعيد Lumi إنشاءها في حسابك الفعلي ويسجّل الـ webhook من جديد.

**3. الاختبار النهائي والإطلاق**

اختبر مرة أخرى بمنتج منخفض السعر، ثم انشر موقعك وشاركه.

إذا حدث خطأ ما في أي خطوة، أخبر Lumi. سيفحص حسابك على PayPal وسجلات وظائفك ليعثر على المشكلة ويصلحها.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.