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

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

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

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

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

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

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

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

1. سجّل الدخول إلى بوابة التاجر في Recharge.
2. انتقل إلى **Tools & Apps → API Tokens**.
3. انقر على **Create an API Token**.
4. أدخل اسمًا وبريدًا إلكترونيًا للتواصل.
5. عيّن الأذونات التي يحتاجها Aftersell: **قراءة وكتابة** على الاشتراكات (Subscriptions)، و**قراءة** على الطلبات (Orders) والخطط (Plans). لا يلزم نطاق للمنتجات.
6. انقر على **Save** وانسخ مفتاح API.

يجب أن يحمل الرمز النطاقات الأربعة جميعها: `read_orders` و`read_subscriptions` و`write_subscriptions` و`read_plans`. يتحقق Aftersell من النطاقات الأربعة عند اختبار المفتاح ويذكر أي نطاقات مفقودة في رسالة الخطأ.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

***

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