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

## ما هي إدارة الاشتراكات؟

يقوم النظام تلقائيًا بالكشف عندما يدخل الاشتراك في حالة قابلة للاسترداد ويرسل سلسلة من الرسائل البريدية لتحث العميل على اتخاذ إجراء:

* **الاشتراكات المؤجلة**: فشل في الدفع للتجديد (نقص الأموال، بطاقة منتهية، إلخ.)
* **الاشتراكات الملغية**: قام العميل بالإلغاء من خلال بوابة العملاء

## كيف تعمل إدارة الاشتراكات

<Steps>
  <Step title="Trigger">
    يتم تشغيل النظام عندما يدخل الاشتراك في إحدى الحالتين:

    * **معلق**: فشل في التجديد (نقص الأموال، بطاقة منتهية، إلخ.)
    * **ملغي**: ألغى العميل اشتراكه من خلال بوابة العملاء
  </Step>

  <Step title="Email Sequence">
    بناءً على حالة التشغيل، يرسل النظام ما يصل إلى 4 رسائل بريد إلكتروني في فواصل زمنية معدة. تتضمن كل رسالة بريد إلكتروني رابطًا إلى بوابة العملاء حيث يمكن للعميل تحديث طريقة الدفع أو إعادة شراء الاشتراك.
  </Step>

  <Step title="Recovery">
    عندما يقوم العميل بتحديث طريقة الدفع من خلال بوابة العملاء، يتم إنشاء فاتورة تلقائيًا للديون المتبقية. إذا نجح الدفع، يتم إعادة تفعيل الاشتراك ويتم اعتبار محاولة الاسترداد ناجحة.
  </Step>
</Steps>

## دورة حياة الحالة

| الحالة       | الوصف                                                                   |
| ------------ | ----------------------------------------------------------------------- |
| `recovering` | محاولة الاسترداد نشطة؛ يتم إرسال الرسائل                                |
| `recovered`  | قام العميل بتحديث طريقة الدفع ونجح الدفع                                |
| `exhausted`  | تم إرسال جميع الرسائل بدون استرداد أو تغير حالة الاشتراك بشكل غير متوقع |

<Info>
  عندما يتم اعتبار محاولة الاسترداد كـ `exhausted`، لا يتم تعديل حالة الاشتراك. يبقى الاشتراك في حالته الحالية (معلق أو ملغي).
</Info>

## تهيئة إدارة الاشتراكات

تمكين وتهيئة إدارة الاشتراكات من **الإعدادات** في لوحة التحكم لديك.

<Frame caption="Dunning settings in the dashboard showing enable toggle, on-hold sequence, and cancelled sequence">
  <img src="https://mintcdn.com/dodopayments/tvJ2MmXYymW0IZ3R/images/recovery/dunning-settings.png?fit=max&auto=format&n=tvJ2MmXYymW0IZ3R&q=85&s=7389a9413d6008800e7ca8a5c4cd1ee5" alt="صفحة إعدادات إدارة الاشتراكات مع تمكين التبديل، أربع رسائل بريد إلكتروني مؤجلة بفواصل زمنية 1، 3، 5، و7 أيام، وأربع رسائل ملغية بنفس الفواصل الزمنية" style={{ maxHeight: '500px', width: 'auto' }} width="2250" height="1628" data-path="images/recovery/dunning-settings.png" />
</Frame>

### سلاسل البريد الإلكتروني

تدعم إدارة الاشتراكات سلسلتين من رسائل البريد الإلكتروني — **مؤجلة** و**ملغية** — كل واحدة منها تحتوي على ما يصل إلى 4 رسائل قابلة للتخصيص.

كل رسالة تحتوي على الحقول القابلة للتخصيص التالية:

| الإعداد      | الوصف                                                    |
| ------------ | -------------------------------------------------------- |
| **ممكّن**    | تفعيل أو تعطيل الرسائل الفردية دون حذفها                 |
| **التأخير**  | مقدار الزمن بعد الحدث الرئيسي لإرسال هذه الرسالة         |
| **الموضوع**  | سطر موضوع البريد الإلكتروني مع متغيرات قابلة للتخصيص     |
| **النص**     | نص البريد الإلكتروني بصيغة HTML مع متغيرات قابلة للتخصيص |
| **الرد إلى** | عنوان البريد الإلكتروني للردود من العميل                 |

**توقيت البريد الإلكتروني الافتراضي:**

| السلسلة | البريد الإلكتروني # | التأخير الافتراضي |
| ------- | ------------------- | ----------------- |
| مؤجلة   | 1                   | 1 يوم             |
| مؤجلة   | 2                   | 3 أيام            |
| مؤجلة   | 3                   | 5 أيام            |
| مؤجلة   | 4                   | 7 أيام            |
| ملغية   | 1                   | 1 يوم             |
| ملغية   | 2                   | 3 أيام            |
| ملغية   | 3                   | 5 أيام            |
| ملغية   | 4                   | 7 أيام            |

### أمثلة على رسائل الاسترداد

ترسل إدارة الاشتراكات رسائل مختلفة اعتمادًا على حالة الاشتراك. أدناه أمثلة لكل نوع كما يراه العميل.

<Tabs>
  <Tab title="On Hold">
    <Frame caption="Dunning email sent when a renewal payment fails and the subscription is on hold">
      <img src="https://mintcdn.com/dodopayments/tvJ2MmXYymW0IZ3R/images/recovery/dunning-on-hold-email.png?fit=max&auto=format&n=tvJ2MmXYymW0IZ3R&q=85&s=5e46040ed49a4da84569afdeeb87c813" alt="بريد إلكتروني لإدارة الاشتراكات المؤجلة يظهر اسم المتجر، رسالة حول الدفع الفاشل، تفاصيل الاشتراك مع الخطة والمبلغ، وزر تحديث طريقة الدفع" style={{ maxHeight: '500px', width: 'auto' }} width="1070" height="1502" data-path="images/recovery/dunning-on-hold-email.png" />
    </Frame>
  </Tab>

  <Tab title="Cancelled">
    <Frame caption="Dunning email sent when a customer cancels their subscription">
      <img src="https://mintcdn.com/dodopayments/tvJ2MmXYymW0IZ3R/images/recovery/dunning-cancelled-email.png?fit=max&auto=format&n=tvJ2MmXYymW0IZ3R&q=85&s=f404fbf9415df4e4bd01562a90bd2456" alt="بريد إلكتروني لإدارة الاشتراكات الملغية يظهر اسم المتجر، رسالة حول الإلغاء، تفاصيل الاشتراك مع الخطة والمبلغ، وزر إعادة شراء الاشتراك" style={{ maxHeight: '500px', width: 'auto' }} width="1070" height="1502" data-path="images/recovery/dunning-cancelled-email.png" />
    </Frame>
  </Tab>
</Tabs>

## تجربة استرداد العميل

عندما ينقر العميل على الرابط في بريد الاسترداد، يتم نقله إلى بوابة العملاء حيث يمكنه رؤية حالة اشتراكه وتحديث طريقة الدفع.

<Frame caption="Customer portal showing an on-hold subscription with option to update payment method">
  <img src="https://mintcdn.com/dodopayments/tvJ2MmXYymW0IZ3R/images/recovery/customer-recovery-page.png?fit=max&auto=format&n=tvJ2MmXYymW0IZ3R&q=85&s=f498d3654afd3d70447b7b8ce7bf3767" alt="بوابة العميل تعرض اشتراكًا مؤجلاً لخطة برو بسعر $95.00/سنة مع زر تحديث طريقة الدفع وشريط تحذير حول الدفع الفاشل" style={{ maxHeight: '500px', width: 'auto' }} width="2144" height="734" data-path="images/recovery/customer-recovery-page.png" />
</Frame>

بعد أن يقوم العميل بتحديث طريقة الدفع، يتم إنشاء فاتورة تلقائيًا لأي التزامات مالية مستحقة. إذا نجح الدفع، يتم إعادة تفعيل الاشتراك فورًا.

بالنسبة للاشتراك الملغي، يتم نقل العميل إلى صفحة الدفع التي تحتوي بالفعل على الاشتراك مضافًا كمنتج.

## التحليلات

تابع أداء إدارة الاشتراكات من علامة التبويب **الاسترداد** في قسم **التحليلات** في لوحة التحكم لديك.

<Frame caption="Recovery analytics dashboard showing ACR and dunning metrics">
  <img src="https://mintcdn.com/dodopayments/B3-0kuKcZDP1TiJD/images/recovery/recovery-analytics.png?fit=max&auto=format&n=B3-0kuKcZDP1TiJD&q=85&s=d3bf0c7474818bc4584b75654423e14c" alt="لوحة تحليلات الاسترداد تعرض عدد محاولات الاسترداد، معدلات النجاح، الإيرادات المستردة، وتحليل أداء البريد الإلكتروني" style={{ maxHeight: '500px', width: 'auto' }} width="2548" height="2190" data-path="images/recovery/recovery-analytics.png" />
</Frame>

| المقياس                    | الوصف                                               |
| -------------------------- | --------------------------------------------------- |
| **إدخالات الاسترداد**      | إجمالي عدد محاولات الاسترداد التي تم إنشاؤها        |
| **معدل النجاح**            | نسبة محاولات الاسترداد التي أدت إلى الاسترداد       |
| **الإيرادات المستردة**     | إجمالي الإيرادات المستردة من خلال الاسترداد         |
| **الاسترداد حسب المحاولة** | تحليل أي بريد إلكتروني في السلسلة أدى إلى الاسترداد |

## أحداث Webhook

| الحدث               | الوصف                               |
| ------------------- | ----------------------------------- |
| `dunning.started`   | تم بدء محاولة استرداد لاشتراك       |
| `dunning.recovered` | تم استرداد اشتراك من خلال الاسترداد |

<Card title="Recovery Webhook Payloads" icon="code" href="/developer-resources/webhooks/intents/recovery">
  عرض المخططات الكاملة لتحميل Webhook لأحداث الاسترداد.
</Card>

## الحالات الاستثنائية

| السيناريو                                        | السلوك                                                      |
| ------------------------------------------------ | ----------------------------------------------------------- |
| قام العميل بتحديث طريقة الدفع قبل أي بريد        | يتم اكتشاف الاسترداد؛ يتم اعتبار محاولة الاسترداد ناجحة     |
| قام العميل بشراء اشتراك آخر من نفس العمل التجاري | يتم اعتبار محاولة الاسترداد مستنفدة                         |
| تم استنفاد جميع رسائل الاسترداد                  | يتم اعتبار محاولة الاسترداد مستنفدة؛ حالة الاشتراك لا تتغير |

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

* **ابدأ بالإعدادات الافتراضية**: تم تصميم توقيت البريد الإلكتروني الافتراضي مع فواصل زمنية معقولة (1, 3, 5 و7 أيام) لتجنب إرهاق العملاء مع الحفاظ على الإلحاح.
* **راقب معدلات النجاح**: تعقب أي بريد إلكتروني في السلسلة يحقق معظم حالات الاسترداد. إذا كانت الرسائل الأخيرة ذات معدلات تحويل شبه صفرية، ففكر في تعطيلها.
* **نسق مع الدعم**: تأكد من أن فريق الدعم الخاص بك يعلم بأن رسائل الاسترداد تُرسل, لكي يتمكنوا من مساعدة العملاء الذين يتواصلون معهم.
* **راجع حالات الاشتراك**: اقترن إدارة الاشتراكات مع `subscription.on_hold` و`subscription.cancelled` webhooks لتتبع دورة الحياة بشكل شامل.

<Info>
  تعمل إدارة الاشتراكات مع تدفقات الاشتراكات المعلقة وإعادة التفعيل الموجودة في بوابة العملاء. بمجرد تفعيلها، تعمل تلقائيًا بدون الحاجة إلى تكامل إضافي.
</Info>

## ذو صلة

<CardGroup cols={2}>
  <Card title="Recovery Webhooks" icon="webhook" href="/developer-resources/webhooks/intents/recovery">
    تفاعل مع `dunning.started` و`dunning.recovered` الأحداث.
  </Card>

  <Card title="Abandoned Cart Recovery" icon="cart-shopping" href="/features/recovery/abandoned-cart-recovery">
    استرداد العربات غير المكتملة أو الفاشلة من خلال رسائل بريد إلكتروني مستهدفة.
  </Card>

  <Card title="Customer Portal" icon="id-card" href="/features/customer-portal">
    يقوم العملاء بتحديث طرق الدفع من خلال بوابة العملاء.
  </Card>

  <Card title="Subscriptions" icon="repeat" href="/features/subscription">
    فهم حالات الاشتراك التي تحفز سير عمل الاسترداد.
  </Card>
</CardGroup>