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

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

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

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

  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.

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

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

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

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

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

تم قبول الترقية لكن الاشتراك لم يُعدّل أكثر الأسباب شيوعًا:
  • رمز API الخاص بك منتهي الصلاحية أو تنقصه الأذونات المطلوبة. يجب أن يملك الرمز النطاقات read_orders وread_subscriptions وwrite_subscriptions وread_plans. انتقل إلى الخطوة 1: ربط المزوّد، وأعد اختبار مفتاحك، وتحقق من رسالة الخطأ لمعرفة النطاقات المفقودة تحديدًا.
  • المنتج المؤهل في المسار لا يطابق ما اشترك فيه العميل فعليًا.
يعيد Aftersell تلقائيًا محاولة استدعاءات المزوّد الفاشلة في سير عمل خلفي. إذا فشلت جميع المحاولات، تواصل مع الدعم مزوّدًا برابط متجرك، ومعرّف طلب Shopify، والبريد الإلكتروني للعميل، والوقت التقريبي لقبول الترقية، والمزوّد الذي تستخدمه. القائمة المنسدلة لخطط البيع فارغة يجلب خيار “Use an existing selling plan” الخطط مباشرة من Recharge. إذا كانت القائمة المنسدلة فارغة:
  • تأكد من تكوين خطط البيع في لوحة تحكم Recharge.
  • تأكد من أن رمز API الخاص بك يملك نطاق read_plans.
  • ارجع إلى الخطوة 1: ربط المزوّد، وأعد اختبار مفتاح API الخاص بك، ثم تابع.
← العودة إلى نظرة عامة على ترقيات الاشتراك · الإعداد والتكوين · ما هي التكاملات؟