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

# ترقيات الاشتراك

تتيح لك ترقيات الاشتراك أن تعرض على المشتركين الحاليين تغييرًا في اشتراكهم النشط بعد الشراء مباشرة عقب إتمام عملية الدفع. يمكنك تغيير تكرار التسليم، أو التبديل إلى منتج اشتراك مختلف، أو القيام بالأمرين معًا، أو [إضافة عنصر آخر إلى اشتراكهم](/ar/aftersell/subscription-upgrades-add-item). يُطبّق التغيير مباشرة في Recharge أو Skio أو Loop، لذا لا يصدر أي استرداد أو رسوم جديدة على الاشتراك نفسه.

<div id="which-feature-do-you-need">
  ## أي ميزة تحتاج؟
</div>

لدى Aftersell ثلاث ميزات لما بعد الشراء تعمل مع الاشتراكات. تبدو متشابهة لكنها تتصرف بشكل مختلف تمامًا. استخدم مسار القرار هذا قبل إعداد أي شيء.

<Info>
  **فكّر في الأمر هكذا:**

  1. **ترقية الاشتراك (Subscription Upgrade)** تعدّل اشتراكًا موجودًا بطريقة ما — تكراره، أو منتجه، أو بإضافة عنصر إليه.
  2. **البيع الإضافي للاشتراك (Subscription Upsell)** إضافي فقط: ينشئ اشتراكًا جديدًا كليًا. مع ربط مزوّد اشتراك، يعمل حتى على الطلبات التي تحتوي بالفعل على اشتراك، لذا لم تعد بحاجة للقلق بشأن قيد Shopify.

  يتعامل Aftersell مع كل سيناريو بميزة مخصصة حتى لا تضطر إلى التفكير في قواعد المنصة مباشرة:

  * **لتغيير اشتراك يملكه العميل بالفعل**، استخدم ترقية الاشتراك. فهي تعدّل اشتراك العميل الحالي مباشرة في Recharge أو Skio أو Loop. يُضاف منتج نائب صغير غير اشتراكي إلى طلب Shopify لاستيفاء قواعد Shopify، بينما تحدث الترقية الفعلية في منصة الاشتراك الخاصة بك.
  * **لإضافة اشتراك جديد كليًا**، استخدم **البيع الإضافي للاشتراك**. يبقى العنصر الأصلي في الطلب كما هو، وينتهي الأمر بالعميل باشتراك متكرر جديد إلى جانبه. يعمل هذا سواء كان الطلب يحتوي بالفعل على اشتراك أم لا — راجع [البيع الإضافي للمشتركين الحاليين](/ar/aftersell/subscription-upsell-existing-subscribers).
  * **لاستبدال منتج يُشترى لمرة واحدة بمنتج آخر**، استخدم **البيع الإضافي بالاستبدال (Replacement Upsell)**. يمكن أن يكون البديل نسخة اشتراك من المنتج نفسه، أو منتجًا مختلفًا تمامًا، أو متغيرًا أو كمية مختلفة من المنتج نفسه.
</Info>

<Note>
  **قيد "اشتراك واحد لكل طلب" لم يعد يعيق عمليات البيع الإضافي للاشتراكات.** لا يسمح Shopify لعرض بيع إضافي بعد الشراء بإضافة اشتراك إلى طلب يحتوي على اشتراك بالفعل. عند ربط Recharge أو Skio أو Loop، ينشئ Aftersell الاشتراك الجديد في مزوّدك بدلًا من إنشائه عبر Shopify، لذا تصل عروض الاشتراك إلى المشتركين الحاليين أيضًا. راجع [البيع الإضافي للمشتركين الحاليين](/ar/aftersell/subscription-upsell-existing-subscribers).
</Note>

استخدم الأسئلة الثلاثة أدناه للعثور على الميزة المناسبة لسيناريوهك. تناولها بالترتيب وتوقف عند أول **نعم**، فتلك هي الميزة التي يجب أن تستخدمها.

**س1: هل تريد تغيير اشتراك يملكه العميل بالفعل؟**

* **نعم**، استخدم [ترقية الاشتراك](#how-subscription-upgrades-work). هذه هي الميزة التي يغطيها هذا الدليل. تعدّل ترقية الاشتراك اشتراك العميل الحالي في Recharge أو Skio أو Loop، مباشرة بعد إتمام عملية الدفع. يمكنك تغيير تكرار التسليم أو الفوترة، أو التبديل إلى منتج اشتراك مختلف، أو القيام بالأمرين معًا، أو [إضافة عنصر آخر إلى الاشتراك](/ar/aftersell/subscription-upgrades-add-item). يُحدَّث اشتراك العميل الحالي في مكانه. لا يصدر أي استرداد أو رسوم جديدة على الاشتراك نفسه. يُضاف بند نائب صغير ("منتج العرض") إلى طلب Shopify كسجل للترقية المقبولة.
* **لا**، انتقل إلى س2.

**س2: هل تريد إضافة اشتراك متكرر جديد كليًا إلى طلبهم، فوق ما اشتروه بالفعل؟**

* **نعم**، استخدم [البيع الإضافي للاشتراك](/ar/aftersell/subscriptions_in_post_purchase_offers). يضيف البيع الإضافي للاشتراك اشتراكًا جديدًا إلى الطلب. يبقى كل ما اشتروه بالفعل في الطلب، ويُضاف اشتراك متكرر إلى جانبه. في طلب بلا اشتراك، يستخدم هذا واجهة Subscription API الخاصة بـ Shopify. في طلب **يحتوي بالفعل على اشتراك**، ينشئ Aftersell الاشتراك الجديد في مزوّدك المرتبط بدلًا من ذلك — راجع [البيع الإضافي للمشتركين الحاليين](/ar/aftersell/subscription-upsell-existing-subscribers). في كلتا الحالتين، ينتهي الأمر بالعميل باشتراك ثانٍ مستقل.
* **لا**، انتقل إلى س3.

**س3: اشترى العميل منتجًا لمرة واحدة. هل تريد استبداله بمنتج مختلف، سواء نسخة اشتراك من المنتج نفسه أو منتجًا مختلفًا تمامًا؟**

* **نعم**، استخدم [البيع الإضافي بالاستبدال](/ar/aftersell/replacement_upsells). يزيل البيع الإضافي بالاستبدال المنتج الأصلي المُشترى لمرة واحدة من الطلب ويضيف البديل مكانه. يسترد Shopify مبلغ البند الأصلي ويُحصّل ثمن البديل. يمكن أن يكون البديل نسخة اشتراك من المنتج نفسه (على سبيل المثال، اشترى العميل عبوة لمرة واحدة وتريده على اشتراك شهري بدلًا من ذلك)، أو منتجًا مختلفًا تمامًا، لمرة واحدة أو بالاشتراك.

<div id="at-a-glance">
  ### لمحة سريعة
</div>

| إذا كنت تريد                                                                   | استخدم هذه الميزة                                                                          | ما يراه العميل على طلبه                                                        |
| ------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------ |
| تعديل اشتراك يملكه بالفعل <br />(تغيير التكرار، التبديل إلى منتج اشتراك مختلف) | ترقية الاشتراك (هذا الدليل)                                                                | بند نائب صغير ("منتج العرض"). الاشتراك نفسه يتغير في Recharge أو Skio أو Loop. |
| إضافة عنصر آخر إلى اشتراك يملكه بالفعل                                         | [إضافة عنصر إلى اشتراك](/ar/aftersell/subscription-upgrades-add-item)                      | العنصر المُضاف، يُحصَّل ثمنه على هذا الطلب. ثم يُشحن ويُفوتر مع اشتراكه.       |
| إضافة اشتراك جديد فوق ما اشتراه                                                | [البيع الإضافي للاشتراك](/ar/aftersell/subscriptions_in_post_purchase_offers)              | بند اشتراك جديد، إلى جانب ما اشتراه بالفعل.                                    |
| إضافة اشتراك جديد عندما يحتوي الطلب **بالفعل** على اشتراك                      | [البيع الإضافي للمشتركين الحاليين](/ar/aftersell/subscription-upsell-existing-subscribers) | العنصر الجديد يُحصَّل بسعر دورته الأولى. يُنشأ اشتراك ثانٍ في مزوّدك.          |
| استبدال منتج لمرة واحدة باشتراك أو منتج مختلف                                  | [البيع الإضافي بالاستبدال](/ar/aftersell/replacement_upsells)                              | بند استرداد للمنتج الأصلي، ورسوم جديدة للمنتج البديل.                          |

<div id="how-subscription-upgrades-work">
  ## كيف تعمل ترقيات الاشتراك
</div>

إليك تجربة العميل من البداية إلى النهاية، وما يحدث خلف الكواليس.

رحلة العميل هي أربع خطوات قصيرة:

1. **يشتري اشتراكًا.** يُتم العميل عملية الدفع على منتج له خطة بيع بالاشتراك.
2. **يرى عرض الترقية.** على صفحة ما بعد الشراء، يرى عرض ترقية الاشتراك الذي كوّنته.
3. **يقبل بعد الشراء.** يقبل دون إعادة إدخال تفاصيل الدفع أو الشحن.
4. **تتحدّث الخطة.** يُعدَّل اشتراكه الحالي في Recharge أو Skio أو Loop. يُضاف بند نائب صغير ("منتج العرض") إلى طلب Shopify كسجل للقبول.

النظامان مرتبطان بفعل واحد من العميل لكنهما ينفذان بشكل مستقل:

* **في Shopify**، يُضاف منتج العرض إلى الطلب كبند نائب. وهو مطلوب لأن واجهة API لما بعد الشراء في Shopify لا يمكنها إضافة اشتراك ثانٍ إلى طلب يحتوي على اشتراك بالفعل.
* **في Recharge أو Skio أو Loop**، يُحدَّث اشتراك العميل الحالي، ولا يصدر أي استرداد للاشتراك الأصلي. في معظم الحالات يُعدَّل في مكانه ويحتفظ بمعرّفه. حالتان تعملان بشكل مختلف:

  * **التحويل إلى خطة دفع مسبق** على Recharge أو Skio. لا يستطيع المزوّد نقل اشتراك نشط إلى خطة دفع مسبق، لذا ينشئ Aftersell الاشتراك على الخطة الجديدة ثم يلغي الأصلي.
  * **ترقية بند واحد من اشتراك متعدد البنود** على Skio أو Loop. لا يستطيع المزوّد إعادة توقيت بند واحد، لذا يُنشأ ذلك البند كاشتراك جديد خاص به ويُزال من الأصلي — يعيّن Skio كميته إلى `0`، بينما يزيل Loop البند كليًا.

  في كلتا الحالتين ينتهي العنصر المُرقّى تحت **معرّف اشتراك مختلف**، وهو أمر مهم إذا كانت لديك تكاملات مرتبطة به. راجع [التنفيذ وربط 3PL](/ar/aftersell/subscription-upgrades-fulfillment).

تسري أسعار الخطة الجديدة على **الدورة المتكررة التالية في منصة الاشتراك الخاصة بك**، وليس على طلب Shopify الذي أتمه العميل للتو.

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

* **الأسباب العابرة وحدود معدل المزوّد** تُعاد محاولتها. يتحقق سير العمل من الحالة الحالية لدى المزوّد قبل إعادة التشغيل، لذا لا تُطبّق الترقية البطيئة لكن الناجحة مرتين.
* **الأسباب التي لا يمكن لإعادة المحاولة إصلاحها** تُوجَّه إلى التسوية اليدوية بدلًا من ذلك.
* **حيث يكون الاسترداد آمنًا** — لم تنجح أي عملية تعديل لدى المزوّد، وكان البند المُحصَّل عنصرًا نائبًا وليس منتجًا يحتفظ به المتسوق — يُسترد المبلغ تلقائيًا. الاشتراكات الجديدة كليًا وترقيات الصناديق لا تُسترد بهذه الطريقة أبدًا، لأن المتسوق يستلم منتجات حقيقية في كلتا الحالتين.

إذا كانت النتيجة تسوية يدوية، تواصل مع الدعم وراجع [استكشاف الأخطاء وإصلاحها](/ar/aftersell/subscription-upgrades-troubleshooting).

<div id="what-the-customer-sees">
  ## ما يراه العميل
</div>

يمس تدفق ترقية الاشتراك نظامين، ويرى العميل أشياء مختلفة في كل منهما. فهم ذلك يمنع تذاكر الدعم حول "رسوم مزدوجة" أو "عناصر مفقودة".

<div id="on-the-shopify-order">
  ### على طلب Shopify
</div>

عندما يقبل العميل الترقية، **لا** يزيل Aftersell بند الاشتراك الأصلي من طلبه. فإزالته تتطلب استردادًا، ما يسبب التباسًا للعميل ("خُصم مني مرتين، ماذا يحدث؟") أكثر مما يحلّ.

بدلًا من ذلك، ينتهي الطلب بما يلي:

* **بند الاشتراك الأصلي**، كما اشتراه العميل.
* **منتج العرض**، كبند نائب منفصل يمثل الترقية.

لهذا السبب، تسمية منتج العرض بوضوح أمر بالغ الأهمية. يجب أن يتمكن العميل من النظر إلى ملخص طلبه وفهم ما يمثله البند الثاني فورًا.

**أسماء جيدة:**

* الترقية إلى الخطة الفصلية
* ترقية الخطة الفصلية
* التبديل إلى التسليم الشهري

**تجنّب الأسماء العامة** مثل "ترقية الاشتراك" إذا كنت تقدم عدة مستويات ترقية. لن يعرف العميل أيها قَبِل.

في Shopify Admin، أضف أيضًا وصفًا قصيرًا إلى منتج العرض يوضح أنه يمثل ترقية الاشتراك وأنه لا تنشأ أي رسوم إضافية من هذا البند.

<div id="in-the-subscription-provider-portal">
  ### في بوابة مزوّد الاشتراك
</div>

في بوابة العملاء الخاصة بـ Recharge أو Skio أو Loop، يرى العميل اشتراكه المحدَّث. يعتمد وقت سريان التغيير على ما إذا كان خيار الترقية الفورية مستخدمًا:

* **افتراضيًا (دورة الفوترة التالية)**، يسري التغيير في دورة الفوترة التالية للعميل. الدورة الحالية لا تتغير، وتسري الخطة الجديدة من التجديد التالي فصاعدًا.
* **مع الترقية الفورية (تجريبية، عند الطلب)**، تبدأ فترة الفوترة الجديدة فورًا بدلًا من انتظار التجديد التالي. لا يزال اشتراك العميل الحالي يُحدَّث في مكانه؛ لا يُحذف ويُعاد إنشاؤه.

<div id="works-with-recharge-skio-and-loop">
  ## يعمل مع Recharge وSkio وLoop
</div>

ترقيات الاشتراك متوافقة حاليًا فقط مع **Recharge** و**Skio** و**Loop**. تُطبّق الترقية داخل أي من هذه المنصات التي تدير اشتراكاتك، لذا فإن ربط إحداها خطوة إعداد مطلوبة.

لمعرفة ماهية التكامل، والمنصات المدعومة، وإعداد الرمز الخاص بكل مزوّد، راجع [التكاملات](/ar/aftersell/subscription-upgrades-integrations).

إذا كنت تستخدم تطبيق اشتراك غير هذه الثلاثة، فلا يمكنك استخدام ترقيات الاشتراك في الوقت الحالي، لكن لا يزال بإمكانك استخدام [البيع الإضافي للاشتراك](/ar/aftersell/subscriptions_in_post_purchase_offers) و[البيع الإضافي بالاستبدال](/ar/aftersell/replacement_upsells).

<div id="next-steps">
  ## الخطوات التالية
</div>

<CardGroup cols={2}>
  <Card title="الإعداد والتكوين" icon="sliders" href="/ar/aftersell/subscription-upgrades-setup">
    اربط مزوّدك وأنشئ عرض الترقية باستخدام معالج الإعداد.
  </Card>

  <Card title="إضافة عنصر إلى اشتراك" icon="plus" href="/ar/aftersell/subscription-upgrades-add-item">
    نمِّ الاشتراك بإضافة منتج جديد إليه، بدلًا من تغييره.
  </Card>

  <Card title="الاختبار" icon="vial" href="/ar/aftersell/subscription-upgrades-testing">
    أجرِ طلبًا تجريبيًا وتحقق من الترقية في Shopify ومزوّدك.
  </Card>

  <Card title="القيود والملاحظات المهمة" icon="triangle-exclamation" href="/ar/aftersell/subscription-upgrades-limitations">
    القيود والسلوكيات التي يجب معرفتها قبل الإطلاق.
  </Card>

  <Card title="التنفيذ وربط 3PL" icon="truck" href="/ar/aftersell/subscription-upgrades-fulfillment">
    تأكد من أن مزوّد 3PL لديك يشحن المنتج الصحيح بعد الترقية.
  </Card>

  <Card title="استكشاف الأخطاء وإصلاحها" icon="wrench" href="/ar/aftersell/subscription-upgrades-troubleshooting">
    حلول لأشهر مشكلات الترقية.
  </Card>

  <Card title="التكاملات" icon="plug" href="/ar/aftersell/subscription-upgrades-integrations">
    أدلة إعداد Recharge وSkio وLoop.
  </Card>
</CardGroup>