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

# ترقيات الاشتراك مع Skio

> دليل خطوة بخطوة لربط Skio وإعداد ترقيات الاشتراك في Aftersell.

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

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

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

* تغيير تكرار التسليم أو الفوترة
* الاستبدال بمنتج مختلف
* كلاهما – تغيير التكرار واستبدال المنتج
* إضافة عنصر آخر قابل للاشتراك إلى الاشتراك (راجع [إضافة عنصر](/ar/aftersell/subscription-upgrades-add-item))
* تكرارات الدفع المسبق والدفع الآجل

<div id="generating-your-skio-api-token">
  ## إنشاء رمز API الخاص بـ Skio
</div>

1. في لوحة تحكم Skio، انتقل إلى **API & Integrations → API**.
2. أدخل اسمًا لمفتاح API الجديد وانقر على **Generate API key**.
3. انسخ المفتاح فورًا. سيُعرض مرة واحدة فقط.
4. يُصدر Skio مفتاح API واحدًا كامل الصلاحيات، لذا لا توجد نطاقات منفصلة لاختيارها. يمنح المفتاح صلاحيات تعديل الاشتراك وإنشائه وإلغائه التي تحتاجها الترقية.

لمزيد من التفاصيل، راجع [وثائق API الخاصة بـ Skio](https://docs.skio.com/).

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

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

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

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

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

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

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

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

انتقل إلى **Subscriptions** في لوحة تحكم Skio وابحث عن اشتراك العميل. يجب أن يعكس بند الطلب والفترة وخطة البيع التغيير فورًا.

يُحدّث Skio البيانات في وقت شبه فوري بعد القبول.

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

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

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

* رمز API الخاص بك منتهي الصلاحية أو لم يعد صالحًا. يستخدم Skio مفتاحًا واحدًا كامل الصلاحيات، لذا أنشئ مفتاحًا جديدًا في Skio، وانتقل إلى **الخطوة 1: ربط المزوّد**، وأعد اختباره.
* المنتج المؤهل في المسار لا يطابق ما اشترك فيه العميل فعليًا.

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

**القائمة المنسدلة لخطط البيع فارغة**

يجلب خيار "Use an existing selling plan" الخطط مباشرة من Skio. إذا كانت القائمة المنسدلة فارغة:

* تأكد من تكوين خطط البيع في لوحة تحكم Skio.
* تأكد من أن مفتاح API الخاص بك صالح ولا يزال يملك صلاحية الوصول إلى حساب Skio الخاص بك.
* ارجع إلى **الخطوة 1: ربط المزوّد**، وأعد اختبار مفتاح API الخاص بك، ثم تابع.

***

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