Skip to main content
تغطي هذه الصفحة كل ما يخص استخدام Loop مع ترقيات الاشتراك، بما في ذلك قيودها الفريدة. للاطلاع على نظرة عامة كاملة حول كيفية عمل ترقيات الاشتراك، راجع ترقيات الاشتراك.

​
الميزات المدعومة

يدعم Loop جميع أنواع ترقيات الاشتراك:
  • تغيير تكرار التسليم أو الفوترة
  • الاستبدال بمنتج مختلف
  • كلاهما – تغيير التكرار واستبدال المنتج
  • إضافة عنصر آخر قابل للاشتراك إلى الاشتراك (راجع إضافة عنصر)
  • تكرارات الدفع الآجل فقط (الدفع المسبق غير مدعوم — راجع القيود أدناه)

​
القيود الخاصة بـ Loop

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

​
إنشاء رمز API الخاص بـ Loop

  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.

​
ربط Loop في معالج الإعداد

عند وصولك إلى الخطوة 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 معطّلًا حتى تعود نتيجة التحقق خضراء، وتعديل المزوّد أو الرمز يمسح النتيجة السابقة.

​
قبل تكوين الترقية (الخطوة 3)

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

​
اختيار مستوى الخصم المتكرر

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

​
التحقق من الترقية في Loop

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

​
استكشاف مشكلات Loop وإصلاحها

لا يمكنني تغيير تكرار الفوترة هذا متوقع. لا يدعم 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 على خطوتين (الفصل ثم الإزالة)، لذا قد يظهر بند مؤقت بين الخطوتين. يُحل الأمر بمجرد اكتمال الخطوة الثانية.
← العودة إلى نظرة عامة على ترقيات الاشتراك · الإعداد والتكوين · ما هي التكاملات؟