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

# إضافة Framer

> دمج وظائف الدفع من Dodo Payments في مشاريع Framer الخاصة بك باستخدام الإضافة القوية لدينا. قبول المدفوعات مع تجارب دفع قابلة للتخصيص.

## نظرة عامة

تدمج إضافة Dodo Payments Framer معالجة المدفوعات بسلاسة في مواقع Framer الخاصة بك. أنشئ تجارب دفع قابلة للتخصيص مع دعم لكل من بيئات الاختبار والإنتاج.

<Card title="Official Plugin" icon="link" href="https://www.framer.com/marketplace/plugins/dodo-payments">
  قم بالوصول إلى المكون الإضافي الرسمي لـ Dodo Payments على سوق Framer.
</Card>

## الميزات

<CardGroup cols={2}>
  <Card title="Hosted or Overlay Checkout" icon="credit-card">
    اختر تدفق صفحة كاملة أو تراكب ضمني يتناسب مع موقعك.
  </Card>

  <Card title="Drag-and-Drop Setup" icon="hand-pointer">
    أضف المكوّن، الصق مفاتيحك، ثم انشر.
  </Card>

  <Card title="Instant Digital Delivery" icon="envelope">
    روابط التحميل الآمنة أو مفاتيح الترخيص تُرسل بالبريد الإلكتروني فور تأكيد الدفع.
  </Card>

  <Card title="Worldwide Coverage" icon="globe">
    اكتساب بالمستوى المصرفي عبر ست قارات، وطرق محلية مدمجة.
  </Card>

  <Card title="Automatic Tax & Invoicing" icon="receipt">
    يتم التعامل مع ضريبة القيمة المضافة، وضريبة السلع والخدمات، وضرائب المبيعات، والإيصالات لكل طلب.
  </Card>

  <Card title="No-Code Subscriptions" icon="toggle-on">
    قم بتفعيل مفتاح بيع خطط الاشتراك لمنتجاتك.
  </Card>
</CardGroup>

## دليل الإعداد

<Steps>
  <Step title="Generate API Key">
    قم بزيارة [لوحة تحكم Dodo Payments](https://app.dodopayments.com/developer/api-keys) وأنشئ مفتاح API جديد.

    <Tabs>
      <Tab title="Live Mode">
        للاستخدام في الإنتاج مع معالجة المدفوعات الحقيقية.
      </Tab>

      <Tab title="Test Mode">
        مثالية للتطوير والاختبار دون أي رسوم حقيقية.
      </Tab>
    </Tabs>

    <Check>
      انسخ مفتاح API الخاص بك بأمان - ستحتاجه للخطوة التالية.
    </Check>
  </Step>

  <Step title="Authenticate Plugin">
    1. افتح مكوّن Dodo Payments في Framer
    2. انتقل إلى صفحة المصادقة
    3. الصق مفتاح API الخاص بك
    4. اختر الوضع المناسب (اختبار أو مباشر)
    5. انقر **متابعة** للمصادقة

    <Warning>
      احفظ مفاتيح API الخاصة بك بأمان ولا تشاركها علنًا.
    </Warning>
  </Step>

  <Step title="Manage Products">
    بعد المصادقة، سيظهر لك قائمة المنتجات الخاصة بك:

    * **المنتجات الموجودة**: تُعرض تلقائيًا
    * **لا توجد منتجات**: انقر على زر **زائد (+)** بجوار 'المنتجات'

    <Info>
      سيتم توجيهك إلى لوحة تحكم Dodo Payments لإنشاء المنتجات مع التسعير والوصف والإعدادات.
    </Info>
  </Step>

  <Step title="Add Buy Buttons">
    1. اختر منتجًا من قائمتك المتاحة
    2. انقر على الزر `Add Buy Button`
    3. سيتم إضافة زر شراء بالنص `Buy {product_name}` إلى اللوحة الخاصة بك

    <Warning>
      سيتم تعطيل زر إضافة شراء إذا لم تكن تملك الأذونات الصحيحة للمشروع.
    </Warning>
  </Step>
</Steps>

## التخصيص

<Steps>
  <Step title="Select Checkout Experience">
    اختر تجربة الدفع المفضلة لديك:

    * **تراكب (مضمّن)**: تظهر صفحة الدفع كتراكب داخل مشروع Framer الخاص بك، مما يبقي المستخدمين على موقعك.
    * **مستضاف**: يتم إعادة توجيه المستخدمين إلى صفحة دفع مستضافة من Dodo Payments لتجربة سلسة.
  </Step>

  <Step title="Customize Appearance Options">
    خصص تجربة الدفع من خلال إعدادات المظهر التالية:

    * **نمط الدفع**: اختر بين الثيم الفاتح أو الداكن ليتماشى مع هوية علامتك.
    * **عبارة الزر**: خصص النص (مثال: 'اشتري الآن'، 'شراء'، 'ابدأ الآن').
    * **أنماط الزر**: عدّل الألوان، الخطوط، الأحجام، وغيرها من خصائص التنسيق.
    * **عنوان URL للعودة**: حدد صفحة Framer للعودة إليها بعد إنهاء الدفع.
  </Step>
</Steps>

## استكشاف الأخطاء وإصلاحها

<AccordionGroup>
  <Accordion title="Authentication Issues">
    **المشكلة**: المكوّن لا يُصادق

    **الحلول**:

    * تأكد من صحة مفتاح API الخاص بك
    * احرص على استخدام الوضع الصحيح (اختبار/مباشر)
    * تحقق من اتصال الإنترنت لديك
  </Accordion>

  <Accordion title="Button Creation Issues">
    **المشكلة**: زر إضافة شراء معطّل

    **الحلول**:

    * تأكد من أنك تملك الأذونات المناسبة في مشروع Framer
    * احرص على المصادقة بشكل صحيح
    * جرّب تحديث المكوّن
  </Accordion>

  <Accordion title="Product Display Issues">
    **المشكلة**: عدم ظهور المنتجات

    **الحلول**:

    * تأكد من أنك أنشأت منتجات في لوحة تحكم Dodo Payments الخاصة بك
    * تحقق من أن مفتاح API لديه الأذونات الصحيحة
    * جرّب إعادة المصادقة
  </Accordion>
</AccordionGroup>