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

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

> دليل خطوة بخطوة لربط Loop وإعداد ترقيات الاشتراك في Aftersell، بما في ذلك القيود الخاصة بـ Loop.

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

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

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

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

<div id="loop-specific-limitations">
  ## القيود الخاصة بـ Loop
</div>

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

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

1. افتح تطبيق Loop وانتقل إلى **Settings** في أسفل اليسار.
2. ضمن **Admin**، انقر على **API Tokens**.
3. عيّن الأذونات التي يحتاجها Aftersell: **قراءة وكتابة** على عقود الاشتراك (Subscription contracts)، و**قراءة** على الطلبات (Orders) وخطط البيع (Selling plans). صلاحية الكتابة مطلوبة للاشتراكات فقط.
4. انقر على **Generate New Token**.
5. أدخل اسمًا، واختر النطاقات المناسبة، ثم انقر على **Generate Token**.
6. انقر على **Show Token** لعرض المفتاح ونسخه. تعامل معه كأنه كلمة مرور واحفظه في مكان آمن.

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

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

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

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

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

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

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

<div id="before-you-configure-the-upgrade-step-3">
  ## قبل تكوين الترقية (الخطوة 3)
</div>

عند تكوين تغيير في التكرار، يمكنك إما اختيار خطة بيع موجودة أو تعيين التكرار يدويًا:

* **استخدام خطة بيع موجودة.** اختر من القائمة المنسدلة لخطط البيع. يجب أن تكون الخطة موجودة ونشطة بالفعل في لوحة تحكم Loop.
* **تعيين التكرار يدويًا.** أدخل تكرار التسليم بنفسك. يقبل Loop أي وتيرة دون الحاجة إلى خطة بيع مطابقة. يمكنك أيضًا تطبيق خصم متكرر عند استخدام تكرار يدوي.

<Note>
  إذا عيّنت التكرار يدويًا وكان اشتراك العميل يحتوي على بندي منتج نشطين أو أكثر (عقد متعدد المنتجات أو حزمة)، فستفشل الترقية ما لم توجد خطة بيع مطابقة للتكرار المستهدف. راجع [القيود](#loop-specific-limitations) للتفاصيل.
</Note>

<div id="selecting-a-recurring-discount-tier">
  ### اختيار مستوى الخصم المتكرر
</div>

تطبّق بعض خطط بيع Loop خصومات مختلفة في نقاط مختلفة من الاشتراك — على سبيل المثال، خصم \$20 على أول عملية شحن وخصم \$10 من عملية الشحن الثانية فصاعدًا. عند اختيار خطة كهذه، يُستبدل حقل **Recurring discount** بقائمة من أزرار الاختيار تعرض كل مستوى من مستويات خصم الخطة مع نطاق الشحن الخاص به (على سبيل المثال، "Charge 1" أو "Charge 2 onward").

اختر المستوى الذي تريد تطبيقه على كل تجديد مستقبلي للاشتراك المرقّى. يُحفظ المستوى المحدد مع العرض ويُطبّق عندما يقبل العميل الترقية.

إذا لم تكن للخطة المحددة مستويات خصم، أو كنت تعيّن التكرار يدويًا، يظهر بدلًا من ذلك حقل الخصم القياسي بالإدخال الحر.

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

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

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

إذا لم يظهر التغيير هناك، فهذا يعني أنه لم يتم — انظر أدناه.

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

**لا يمكنني تغيير تكرار الفوترة**

هذا متوقع. لا يدعم Loop الاشتراكات المدفوعة مسبقًا عبر هذا التكامل. حقل تكرار الفوترة معطّل وتتم مزامنته تلقائيًا مع تكرار التسليم.

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

إذا بقي الاشتراك دون تغيير، فأكثر الأسباب شيوعًا هي:

* عيّنت التكرار يدويًا واشتراك العميل يحتوي على بندي منتج نشطين أو أكثر. في هذه الحالة، يتطلب Loop خطة بيع مطابقة للتكرار المستهدف. أنشئ خطة البيع في Loop، أو بدّل إلى **Use an existing selling plan** في تكوين العرض.
* استخدمت **Use an existing selling plan** وخطة البيع المحددة لم تعد موجودة في لوحة تحكم Loop. أنشئ خطة البيع في Loop وحاول مرة أخرى.
* رمز API الخاص بك منتهي الصلاحية أو تنقصه الأذونات المطلوبة: **كتابة** على عقود الاشتراك، و**قراءة** على الطلبات وخطط البيع. انتقل إلى **الخطوة 1: ربط المزوّد**، وأعد اختبار مفتاحك، وتحقق من رسالة الخطأ لمعرفة النطاقات المفقودة تحديدًا.
* المنتج المؤهل في المسار لا يطابق ما اشترك فيه العميل فعليًا.

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

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

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

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

**تظهر بنود مؤقتة قيد التنفيذ في لوحة تحكم Loop**

هذا متوقع للاشتراكات متعددة البنود. يعالجها Loop على خطوتين (الفصل ثم الإزالة)، لذا قد يظهر بند مؤقت بين الخطوتين. يُحل الأمر بمجرد اكتمال الخطوة الثانية.

***

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