> ## 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.

# الإضافات للاشتراكات

> عزز منتجات الاشتراك الخاصة بك مع إضافات مرنة لفوترة قائمة على المقاعد، وترقيات الميزات، ونماذج تسعير مبتكرة

<Info>
  الملحقات هي منتجات إضافية يمكن إرفاقها بمنتجات اشتراكك الرئيسية، مما يتيح نماذج تسعير مرنة وتجارب عملاء محسّنة. سواء كنت بحاجة إلى فوترة بناءً على المقاعد، ترقيات للميزات، أو هياكل تسعير مخصصة، تُمكّنك الملحقات من إنشاء عروض اشتراك متقدمة.
</Info>

<CardGroup cols={2}>
  <Card title="Seat-Based Billing" icon="users" href="/developer-resources/seat-based-pricing">
    أنشئ ملحقات للمقاعد الإضافية في الفريق، تراخيص المستخدم، أو ترقيات السعة مع تسعير لكل مقعد.
  </Card>

  <Card title="Usage Extensions" icon="bolt" href="/features/usage-based-billing/introduction">
    قم بتمديد حدود الاستخدام أو مكالمات API أو مخصصات البيانات مع أسعار الإضافات المرنة.
  </Card>
</CardGroup>

## ما هي الإضافات؟

الإضافات هي منتجات تكميلية يمكن للعملاء شراؤها إلى جانب اشتراكهم الرئيسي. إنها مثالية لـ:

* **الفوترة المبنية على المقاعد**: أعضاء فريق إضافيون، تراخيص مستخدمين، أو مستخدمين متزامنين
* **ترقيات الميزات**: ميزات متميزة، تحليلات متقدمة، أو دعم ذي أولوية
* **تمديدات الاستخدام**: سعة تخزين إضافية، مكالمات واجهة برمجة التطبيقات، أو بدلات عرض النطاق
* **إضافات الخدمة**: خدمات احترافية، تدريب، أو ساعات استشارية

<Frame>
  <img src="https://mintcdn.com/dodopayments/ajOhO6Du1yNsg0hy/images/cookbooks/seat-based/seat-based-addons.png?fit=max&auto=format&n=ajOhO6Du1yNsg0hy&q=85&s=ea4ce0d437201c92590eea6c31a14e80" alt="الإضافات المرفقة بمنتجات الاشتراك في لوحة التحكم" style={{ maxHeight: '500px', width: 'auto' }} width="2338" height="1196" data-path="images/cookbooks/seat-based/seat-based-addons.png" />
</Frame>

## الفوائد الرئيسية

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

## إنشاء الإضافات

يتم إنشاء الإضافات كمنتجات منفصلة في لوحة تحكم Dodo Payments، ثم يتم ربطها بمنتجات الاشتراك الرئيسية. يتيح هذا الفصل لك:

* إعادة استخدام الإضافات عبر عدة منتجات اشتراك
* إدارة التسعير بشكل مستقل
* تتبع أداء الإضافة بشكل منفصل
* تحديث الإضافات دون التأثير على الاشتراكات الأساسية

<Frame>
  <img src="https://mintcdn.com/dodopayments/ajOhO6Du1yNsg0hy/images/cookbooks/seat-based/seat-based-addons-creation.png?fit=max&auto=format&n=ajOhO6Du1yNsg0hy&q=85&s=d2c17b4a9f2f9a1b19f537f0507656a4" alt="إنشاء الإضافات في واجهة لوحة التحكم" style={{ maxHeight: '500px', width: 'auto' }} width="2348" height="1606" data-path="images/cookbooks/seat-based/seat-based-addons-creation.png" />
</Frame>

### تكوين الإضافات

عند إنشاء الإضافات، يمكنك تكوين ما يلي:

* **التسعير**: حدد تسعيرًا لمرة واحدة أو متكرر للإضافة
* **دورة الفوترة**: يجب أن تتطابق مع دورة الفوترة للاشتراك
* **حدود الكمية**: حدد الحد الأدنى والأقصى للكميات لكل عميل
* **التوافر**: تحكم في منتجات الاشتراك التي يمكنها استخدام الإضافة
* **إعدادات الضرائب**: قم بتكوين فئات الضرائب المناسبة

### البدء

هل أنت جاهز لتطبيق الإضافات في عمل الاشتراكات الخاص بك؟ إليك كيفية البدء:

<Steps>
  <Step title="Plan Your Add-ons">
    حدد الميزات أو الخدمات أو السعة الإضافية التي ستفيد عملائك كإضافات.

    فكر في ما يلي:

    * ما الذي يطلبه العملاء بشكل متكرر؟
    * ما الميزات التي يمكن تسييلها بشكل منفصل؟
    * ما الذي سيوفر مسارات ترقية طبيعية؟
  </Step>

  <Step title="Create Your First Add-on">
    استخدم لوحة تحكم Dodo Payments أو واجهة برمجة التطبيقات لإنشاء منتج إضافة أول.

    <Card title="Dashboard Guide" icon="box" href="/developer-resources/seat-based-pricing">
      اتبع دليلنا خطوة بخطوة لإنشاء الإضافات في لوحة التحكم.
    </Card>
  </Step>

  <Step title="Attach to Subscriptions">
    ربط إضافاتك بمنتجات الاشتراك المناسبة التي ينبغي أن تتوفر فيها.
  </Step>

  <Step title="Test Integration">
    أنشئ جلسات دفع اختبارية مع مجموعات إضافات مختلفة للتأكد من أن كل شيء يعمل بشكل صحيح.
  </Step>

  <Step title="Monitor Performance">
    تتبع معدلات اعتماد الإضافات وتأثيرها على الإيرادات لتحسين استراتيجية التسعير الخاصة بك.
  </Step>
</Steps>

## إدارة API

توفر Dodo Payments واجهة برمجة تطبيقات شاملة لإدارة الإضافات برمجيًا:

<AccordionGroup>
  <Accordion title="Create Add-ons">
    استخدم نقطة النهاية `POST /addons` لإنشاء إضافات جديدة بتسعير مخصص، أوصاف، وخيارات تكوين.

    <Card title="API Reference" icon="code" href="/api-reference/addons/create-addon">
      عرض وثائق واجهة برمجة التطبيقات الكاملة لإنشاء الإضافات.
    </Card>
  </Accordion>

  <Accordion title="Update Add-ons">
    قم بتعديل الإضافات الحالية باستخدام نقطة النهاية `PATCH /addons/{id}` لتحديث التسعير، الأوصاف، أو التوافر.

    <Card title="API Reference" icon="code" href="/api-reference/addons/update-addon">
      تعرف على كيفية تحديث تفاصيل الإضافات برمجيًا.
    </Card>
  </Accordion>

  <Accordion title="List and Retrieve">
    استخدم `GET /addons` لسرد جميع الإضافات أو `GET /addons/{id}` لاسترجاع تفاصيل إضافة محددة.

    <Card title="API Reference" icon="code" href="/api-reference/addons/list-addons">
      الوصول إلى توثيق واجهة برمجة التطبيقات الكامل للقوائم والاسترجاع.
    </Card>
  </Accordion>

  <Accordion title="Image Management">
    قم بتحديث صور الإضافات باستخدام نقطة النهاية `PUT /addons/{id}/images` لتحسين عرض المنتج.

    <Card title="API Reference" icon="code" href="/api-reference/addons/update-addon-images">
      تعلم كيفية إدارة صور الإضافات عبر واجهة برمجة التطبيقات.
    </Card>
  </Accordion>
</AccordionGroup>

## حالات الاستخدام الشائعة

* **الفوترة المبنية على المقاعد**: أعضاء فريق إضافيون، تراخيص مستخدمين، أو مستخدمين متزامنين
* **ترقيات الميزات**: ميزات متميزة، تحليلات متقدمة، أو دعم ذي أولوية
* **تمديدات الاستخدام**: سعة تخزين إضافية، مكالمات واجهة برمجة التطبيقات، أو بدلات عرض النطاق
* **إضافات الخدمة**: خدمات احترافية، تدريب، أو ساعات استشارية

## أمثلة على التكامل

### جلسات الدفع مع الإضافات

عند إنشاء جلسات الدفع، يمكنك تضمين الإضافات بكميات مخصصة:

```typescript theme={null}
const session = await client.checkoutSessions.create({
  product_cart: [
    {
      product_id: 'your_subscription_id',
      quantity: 1,
      addons: [
        {
          addon_id: 'your_addon_id',
          quantity: 3 // 3 additional seats
        }
      ]
    }
  ],
  // ... other checkout options
});
```

### تغييرات الخطة مع الإضافات

قم بتعديل الاشتراكات الحالية لإضافة أو إزالة أو تحديث الإضافات:

```typescript theme={null}
// Add add-ons to existing subscription
await client.subscriptions.changePlan('sub_123', {
  product_id: 'prod_new',
  quantity: 1,
  proration_billing_mode: 'difference_immediately',
  addons: [
    { addon_id: 'addon_123', quantity: 2 }
  ]
});

// Remove all existing add-ons
await client.subscriptions.changePlan('sub_123', {
  product_id: 'prod_new',
  quantity: 1,
  proration_billing_mode: 'difference_immediately',
  addons: [] // Empty array removes all existing add-ons
});
```

### التسعير الديناميكي

احسب التكاليف الإجمالية ديناميكيًا بناءً على اختيارات الإضافات:

```typescript theme={null}
function calculateTotalCost(basePrice: number, addons: AddonSelection[]) {
  const addonTotal = addons.reduce((sum, addon) => 
    sum + (addon.price * addon.quantity), 0
  );
  return basePrice + addonTotal;
}
```

## أفضل الممارسات

* **ابدأ ببساطة**: أطلق 2-3 إضافات أساسية ووسع الخيارات بناءً على آراء العملاء والاستخدام.
* **حافظ على وضوح التسعير**: أوضح تسعير الإضافات وقيمتها، حتى يفهم العملاء ما الذي يحصلون عليه مقابل التكلفة الإضافية.
* **اختبر بشكل شامل**: تحقق من مجموعات الإضافات لضمان دقة حسابات التسعير وسلاسة تدفقات الدفع.

### اعتبارات التصميم

* **قيمة واضحة**: يجب أن يكون لكل إضافة ميزة واضحة يمكن للعملاء فهمها بسهولة
* **تجميع منطقي**: جمّع الإضافات ذات الصلة معًا في تدفق الدفع
* **كميات مرنة**: اسمح للعملاء بضبط كميات الإضافات حسب الحاجة
* **تسعير شفاف**: عرض التكاليف الإجمالية بوضوح طوال عملية الدفع

<Info>
  الإضافات وسيلة قوية لإنشاء نماذج تسعير مرنة وقابلة للتوسع تنمو مع عملائك. ابدأ بحالات استخدام بسيطة ووسع نطاقها بينما تتعلم ما هو الأفضل لعملك وعملائك.
</Info>