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

# ترقيات الاشتراك مع Stay AI

> دليل خطوة بخطوة لربط Stay AI وإعداد ترقيات الاشتراك في Aftersell، بما في ذلك القيود الخاصة بـ Stay AI المتعلقة بالخطط المدفوعة مسبقًا والإلغاءات والعملة.

تغطي هذه الصفحة كل ما يخص استخدام **Stay AI** مع ترقيات الاشتراك، بما في ذلك قيودها الفريدة. للاطلاع على نظرة عامة كاملة حول كيفية عمل ترقيات الاشتراك، راجع [ترقيات الاشتراك](/ar/aftersell/subscription-upgrades).

<div id="supported-features">
  ## الميزات المدعومة
</div>

يدعم Stay AI جميع أنواع ترقيات الاشتراك:

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

استبدال المنتجات مدعوم **باستثناء الاستبدال بمنتج يُباع فقط بخطط الدفع المقدّم** - راجع قيد الدفع المسبق أدناه.

<div id="moving-a-subscription-onto-a-pay-upfront-plan">
  ### نقل اشتراك إلى خطة دفع مقدّم
</div>

تحويل اشتراك بالدفع الآجل إلى خطة دفع مقدّم (مدفوعة مسبقًا) مدعوم، بشرطين:

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

<div id="stay-ai-specific-limitations">
  ## القيود الخاصة بـ Stay AI
</div>

* **لا يمكن تعديل الاشتراكات المدفوعة مسبقًا (الدفع المقدّم).** لا يسمح Stay بأي تغيير على اشتراك دفع العميل ثمنه مقدمًا، أيًا كان نوع الترقية. إذا قبل عميل على خطة مدفوعة مسبقًا عرض ترقية، تُلغى الترقية ويُسترد المبلغ له، فيبقى الاشتراك دون تغيير. وللسبب نفسه، لا يمكنك استبدال اشتراك بمنتج يُباع فقط بخطط الدفع المقدّم.
* **الإلغاءات محصورة بتطبيق واحد لكل حساب.** يرسل Stay تحديثات الإلغاء إلى **تطبيق واحد فقط لكل حساب**. إذا سجّل تطبيق أو تكامل آخر في webhook الإلغاء الخاص بـ Stay قبل Aftersell، فلن يتمكن Aftersell من تلقي تلك التحديثات، ولن يعكس [مخطط الاشتراكات الملغاة](/ar/aftersell/analytics_metrics_reference#subscriptions-cancelled-chart) إلغاءات Stay. يجب أن يتضمن مفتاح API الذي تربطه إذن **Webhooks** (انظر أدناه) لكي يعمل تتبّع الإلغاءات أصلًا.
* **يُطبَّق تغيير التكرار على الاشتراك بأكمله.** لدى Stay جدول واحد لكل اشتراك، لذا فإن تغيير عدد مرات وصوله ينقل كل منتج فيه. عندما يحتوي الاشتراك على منتجين أو أكثر، يجب تفعيل **Keep on existing subscription** على العرض؛ وإلا تُرفض ترقية التكرار ويُسترد المبلغ للمتسوق. هذا مطلوب فقط لتغييرات التكرار - أما استبدال المنتجات والإضافات فلا تتأثر وتعمل بدونه.
* **إضافة المزيد من منتج يشترك فيه العميل بالفعل تتطلب سعرًا مطابقًا.** عندما تكون الإضافة منتجًا يملكه العميل بالفعل، يزيد Stay كميته بدلًا من إضافة بند - ولكن فقط إذا طابق سعر العرض ما يدفعه العميل حاليًا مقابله. إذا اختلفت الأسعار (على سبيل المثال، تقدّم الإضافة خصم 20% بينما خطته بخصم 10%)، تُرفض الترقية ويبقى الاشتراك دون تغيير. امنح الإضافة الخصم نفسه الموجود في خطة العميل، أو اعرض منتجًا مختلفًا (المنتج المختلف لا يتأثر).
* **يجب أن تتطابق العملة مع تسعير متجرك.** إذا كان اشتراك العميل يُفوتر بعملة لا يسعّر بها متجرك، تُرفض الترقية.
* **لا يمكن التمييز بين الاشتراكات المكررة من طلب واحد.** إذا بدأ طلب واحد اشتراكين في Stay يحتوي كلاهما على منتج العرض، فلن يتمكن Aftersell من معرفة أيهما قصده العميل، وتُرفض الترقية بدلًا من تطبيقها على العقد الخطأ.
* **حدود المعدل تقيّد الإنتاجية.** يسمح Stay بـ 60 طلبًا في الدقيقة لكل حساب. تستغرق الترقية الواحدة من أربعة إلى ستة طلبات، لذا يبلغ المتجر حده الأقصى عند نحو 10 إلى 15 ترقية في الدقيقة في أوقات الذروة.

<div id="generating-your-stay-ai-api-key">
  ## إنشاء مفتاح API الخاص بـ Stay AI
</div>

1. في لوحة تحكم Stay AI، انتقل إلى **Account → API tokens → Add API key**.
2. عند إنشاء المفتاح، اختر **All permissions**. يحتاج Aftersell إلى صلاحية الوصول إلى **Subscriptions** و**Orders** و**Selling Plan Groups** و**Webhooks**. إذن Webhooks هو ما يتيح لـ Aftersell معرفة الإلغاءات.
3. انسخ المفتاح واحفظه في مكان آمن. تعامل معه كأنه كلمة مرور.

لمزيد من التفاصيل، راجع [وثائق مصادقة API الخاصة بـ Stay AI](https://docs.stay.ai/reference/authentication).

<div id="connecting-stay-ai-in-the-setup-wizard">
  ## ربط Stay AI في معالج الإعداد
</div>

عند وصولك إلى **الخطوة 1: ربط المزوّد** في معالج ترقية الاشتراك:

1. اختر **Stay AI** من القائمة المنسدلة **Subscription provider**.
2. الصق مفتاح API الخاص بك في حقل **API key**.
3. انقر على **Test API key**. يتحقق Aftersell من صحة المفتاح، ويتأكد من أنه يجتاز المصادقة وأنه ينتمي إلى متجرك.
4. بمجرد نجاح الاختبار (علامة خضراء)، انقر على **Continue** للانتقال إلى الخطوة 2.

تُظهر نتيجة الاختبار إحدى حالتين:

* **علامة صح خضراء - "API key verified".** تمت مصادقة المفتاح وهو ينتمي إلى متجرك. أصبح زر **Continue** مفعّلًا الآن. إذا كان المفتاح يفتقد إذن **Webhooks**، فسينجح الاختبار مع ذلك لكنه يحذّر من أن إلغاءات الاشتراكات لن تُسجَّل - أعد إنشاء المفتاح في Stay AI مع **All permissions** إذا كنت تريد تتبّع الإلغاءات.
* **أيقونة إلغاء حمراء.** لم تكتمل عملية التحقق بنجاح. اقرأ الرسالة بجانب الأيقونة: إما أن المفتاح رُفض، أو لم يتمكن Aftersell من إكمال التحقق ("Could not verify the API key. Please try again.")، وهو استدعاء فاشل وليس مفتاحًا سيئًا - في هذه الحالة أعد الاختبار فقط.

نتيجة تعذّر التحقق تبدو تمامًا مثل الرفض، لذا اعتمد على الرسالة بدلًا من الأيقونة. يبقى زر **Continue** معطّلًا حتى تعود نتيجة التحقق خضراء، وتعديل المزوّد أو المفتاح يمسح النتيجة السابقة.

<div id="verifying-an-upgrade-in-stay-ai">
  ## التحقق من الترقية في Stay AI
</div>

بعد إجراء طلب تجريبي وقبول عرض الترقية:

انتقل إلى **Subscriptions** في لوحة تحكم Stay AI وابحث عن اشتراك العميل. يجب أن يعكس تكرار الفوترة أو المنتج أو تاريخ التحصيل التالي التغيير.

يُطبَّق التغيير نفسه بمجرد أن يعالج Aftersell القبول، لكن Stay قد يكون بطيئًا في استيعاب طلب جديد تمامًا: عادةً ما تظهر الترقية خلال دقائق، وقد يستغرق الأمر حتى 24 ساعة في أبطأ الحالات. إذا لم يظهر التغيير بعد، فامنحه بعض الوقت قبل اعتباره فشلًا.

<div id="if-an-upgrade-cant-be-applied">
  ## إذا تعذّر تطبيق الترقية
</div>

ترقيات Stay AI آمنة بطبيعة تصميمها - لا يُحاسَب المتسوق أبدًا على ترقية لم تحدث:

* **تُعاد محاولة الترقيات الفاشلة تلقائيًا.** إذا فشل استدعاء إلى Stay AI، يعيد Aftersell محاولته في سير عمل خلفي.
* **إذا تعذّر تطبيقها رغم ذلك، يُسترد المبلغ للمتسوق.** لا تحصّل ترقية الاشتراك سوى بند نائب صغير في طلب Shopify (وليس منتجًا يحتفظ به المتسوق)، لذا يسترد Aftersell ذلك المبلغ عندما يتعذّر إكمال الترقية.
* **أي شيء لا يمكن تأكيده يُعلَّم للمراجعة اليدوية** بدلًا من التخمين، حتى لا يُحاسَب المتسوق أبدًا على ترقية لم تحدث.

للاطلاع على الآليات الكاملة لإعادة المحاولة والتسوية (المشتركة بين المزوّدين)، راجع [كيف تعمل ترقيات الاشتراك](/ar/aftersell/subscription-upgrades#how-subscription-upgrades-work).

<div id="troubleshooting-stay-ai-specific-issues">
  ## استكشاف مشكلات Stay AI وإصلاحها
</div>

**تم قبول الترقية لكن الاشتراك لم يُعدّل**

أكثر الأسباب شيوعًا:

* العميل على خطة **مدفوعة مسبقًا (دفع مقدّم)**. لا يسمح Stay بتعديل العقود المدفوعة مسبقًا، لذا تُلغى الترقية ويُسترد المبلغ. هذا متوقع.
* الاشتراك يُفوتر **بعملة لا يسعّر بها متجرك**، لذا رُفضت الترقية.
* يحتوي الاشتراك على **منتجين أو أكثر** وغيّرت التكرار دون تفعيل **Keep on existing subscription**.
* بدأ طلب واحد **اشتراكين في Stay** يحتوي كلاهما على منتج العرض، لذا لم يتمكن Aftersell من معرفة أيهما يجب ترقيته.
* مفتاح API الخاص بك من متجر مختلف، أو تنقصه صلاحية مطلوبة (**Subscriptions** أو **Orders** أو **Selling Plan Groups**). أعد إنشاء المفتاح أو أعد اختياره في Stay AI، وانتقل إلى **الخطوة 1: ربط المزوّد**، وأعد اختباره.
* المنتج المؤهل في المسار لا يطابق ما اشترك فيه العميل فعليًا.

يعيد Aftersell تلقائيًا محاولة استدعاءات المزوّد الفاشلة في سير عمل خلفي. إذا فشلت جميع المحاولات، تواصل مع الدعم مزوّدًا برابط متجرك، ومعرّف طلب Shopify، والبريد الإلكتروني للعميل، والوقت التقريبي لقبول الترقية، والمزوّد الذي تستخدمه.

**إلغاءات Stay لا تظهر في التحليلات**

يرسل Stay تحديثات الإلغاء إلى تطبيق واحد فقط لكل حساب. إذا سجّل تطبيق آخر في webhook الإلغاء الخاص بـ Stay قبل Aftersell، فلن يتمكن Aftersell من تلقيها. تأكد من عدم امتلاك أي تكامل آخر لـ webhook الإلغاء الخاص بـ Stay، وتأكد من أن مفتاح API المربوط يتضمن إذن **Webhooks**.

***

← العودة إلى [نظرة عامة على ترقيات الاشتراك](/ar/aftersell/subscription-upgrades) · [الإعداد والتكوين](/ar/aftersell/subscription-upgrades-setup) · [ما هي التكاملات؟](/ar/aftersell/subscription-upgrades-integrations)