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

# ربط PayPal لتحصيل مدفوعات العملاء بأمان

> اربط حساب PayPal الخاص بك بـ AgencyHandy واسمح للعملاء بدفع الفواتير عبر منصة الدفع الموثوقة والمعروفة عالميًا من PayPal.

يمنح تكامل AgencyHandy مع PayPal عملاءك طريقة آمنة ومألوفة لدفع الفواتير دون الحاجة إلى بطاقة ائتمان. يدعم PayPal مجموعة واسعة من العملات الدولية، مما يجعله مفيدًا بشكل خاص للوكالات التي لديها عملاء خارج بلدها.

<Note>
  **لا يمكن** استخدام PayPal للبيع الإضافي (upsells) بسبب قيود العملة والمناطق الجغرافية على مستوى المنصة. لمدفوعات البيع الإضافي، استخدم Stripe بدلًا من ذلك.
</Note>

<Note>
  فقط أدوار **المشرف العام (SuperAdmin)** و**المشرف (Admin)** يمكنها ربط أو إدارة تكامل PayPal. يجب أن يكون لديك حساب PayPal نشط قبل البدء.
</Note>

## ربط PayPal

<Steps>
  <Step title="فتح إعدادات تكامل PayPal">
    سجّل الدخول إلى AgencyHandy، ثم انتقل إلى **التكاملات ← تكامل PayPal** في الشريط الجانبي الأيسر.
  </Step>

  <Step title="بدء الاتصال">
    انقر على **ربط PayPal**. ستتم إعادة توجيهك إلى صفحة تسجيل الدخول في PayPal.
  </Step>

  <Step title="تفويض AgencyHandy">
    سجّل الدخول إلى حساب PayPal الخاص بك وراجع الأذونات المطلوبة. انقر على **سماح** (أو **منح**) لتفويض AgencyHandy بالوصول إلى حسابك.
  </Step>

  <Step title="تأكيد الاتصال">
    بعد نجاح التفويض، سيعيد PayPal توجيهك إلى AgencyHandy. ستظهر رسالة تأكيد — **تم ربط PayPal** — على بطاقة التكامل. يمكن للعملاء الآن دفع الفواتير باستخدام PayPal.
  </Step>
</Steps>

## كيف يدفع العملاء عبر PayPal

بمجرد تفعيل التكامل، يظهر زر **الدفع بـ PayPal** على أي فاتورة ترسلها. ينقر العميل على الزر، ويسجّل الدخول إلى حساب PayPal الخاص به (أو يدفع كضيف حسب منطقته)، ثم يكمل عملية الدفع. تقوم AgencyHandy بتحديث حالة الفاتورة تلقائيًا عند تأكيد الدفع من PayPal.

## العملات المدعومة

تدعم AgencyHandy العملات التالية لمدفوعات PayPal:

| المنطقة             | العملات                                     |
| ------------------- | ------------------------------------------- |
| الأمريكتان          | USD, CAD, BRL, MXN                          |
| أوروبا              | EUR, GBP, CHF, NOK, SEK, DKK, PLN, CZK, HUF |
| آسيا والمحيط الهادئ | AUD, NZD, JPY, HKD, SGD, MYR, PHP, THB, TWD |
| الشرق الأوسط / أخرى | ILS, CNY                                    |

<Warning>
  بعض العملات تخضع لقيود:

  * **JPY** وبعض العملات الأخرى لا تدعم المبالغ العشرية — تجنب إجماليات الفواتير الكسرية.
  * **BRL** متاحة فقط لحسابات PayPal البرازيلية. إذا لم يكن حسابك مقيمًا في البرازيل، فسيتم تحويل مدفوعات BRL تلقائيًا إلى عملتك الأساسية.
  * بعض العملات متاحة فقط للحسابات المحلية. تأكد من أن عملة حسابك تتطابق مع عملة فاتورتك لتجنب الأخطاء.
</Warning>

<Note>
  يطبق PayPal رسوم تحويل العملات الخاصة به عند حدوث التحويل. لا تتحكم AgencyHandy في هذه الرسوم.
</Note>

## اختبار التكامل

قبل استخدام PayPal لفواتير العملاء الحقيقية، قم بإجراء اختبار سريع:

1. أنشئ فاتورة اختبار في AgencyHandy باستخدام [عملة مدعومة](#supported-currencies).
2. أرسل الفاتورة إلى حساب PayPal ثانوي تتحكم فيه.
3. أكمل عملية الدفع من الحساب الثانوي.
4. عد إلى AgencyHandy وتأكد من تحديث حالة الفاتورة إلى **مدفوعة** وأن الأموال تظهر في حساب PayPal الخاص بك.