الميزات المدعومة
- تغيير تكرار التسليم أو الفوترة (يُطبَّق على الاشتراك بأكمله)
- الاستبدال بمنتج مختلف
- كلاهما - تغيير التكرار واستبدال المنتج
- إضافة عنصر آخر قابل للاشتراك إلى الاشتراك (راجع إضافة عنصر). إذا كان العميل مشتركًا بالفعل في ذلك المنتج، يزيد Stay كميته بدلًا من إضافة بند جديد (ولهذا شرط مطابقة السعر - راجع القيود أدناه).
- تكرارات الدفع الآجل (الدفع لكل تسليم)، بما في ذلك نقل اشتراك بالدفع الآجل إلى خطة دفع مقدّم (وفق الشروط أدناه)
نقل اشتراك إلى خطة دفع مقدّم
- يجب أن تكون خطة الدفع المقدّم موجودة بالفعل في Stay AI ومُسندة إلى المنتج. لا يستطيع Aftersell إنشاء خطة كهذه؛ إذ يتيح لك العرض الاختيار فقط من الخطط المُعدّة مسبقًا في Stay AI.
- ينشئ النقل اشتراكًا جديدًا ويلغي الاشتراك القديم. يجري Stay هذا التغيير بإنشاء اشتراك جديد على خطة الدفع المقدّم وإلغاء الاشتراك الأصلي، لذا يحصل الاشتراك على مرجع جديد. تحتاج أدوات المستودعات أو 3PL أو التقارير التي تتتبّع الاشتراكات حسب المرجع إلى إعادة المزامنة. راجع التنفيذ وربط 3PL.
القيود الخاصة بـ Stay AI
- لا يمكن تعديل الاشتراكات المدفوعة مسبقًا (الدفع المقدّم). لا يسمح Stay بأي تغيير على اشتراك دفع العميل ثمنه مقدمًا، أيًا كان نوع الترقية. إذا قبل عميل على خطة مدفوعة مسبقًا عرض ترقية، تُلغى الترقية ويُسترد المبلغ له، فيبقى الاشتراك دون تغيير. وللسبب نفسه، لا يمكنك استبدال اشتراك بمنتج يُباع فقط بخطط الدفع المقدّم.
- الإلغاءات محصورة بتطبيق واحد لكل حساب. يرسل Stay تحديثات الإلغاء إلى تطبيق واحد فقط لكل حساب. إذا سجّل تطبيق أو تكامل آخر في webhook الإلغاء الخاص بـ Stay قبل Aftersell، فلن يتمكن Aftersell من تلقي تلك التحديثات، ولن يعكس مخطط الاشتراكات الملغاة إلغاءات Stay. يجب أن يتضمن مفتاح API الذي تربطه إذن Webhooks (انظر أدناه) لكي يعمل تتبّع الإلغاءات أصلًا.
- يُطبَّق تغيير التكرار على الاشتراك بأكمله. لدى Stay جدول واحد لكل اشتراك، لذا فإن تغيير عدد مرات وصوله ينقل كل منتج فيه. عندما يحتوي الاشتراك على منتجين أو أكثر، يجب تفعيل Keep on existing subscription على العرض؛ وإلا تُرفض ترقية التكرار ويُسترد المبلغ للمتسوق. هذا مطلوب فقط لتغييرات التكرار - أما استبدال المنتجات والإضافات فلا تتأثر وتعمل بدونه.
- إضافة المزيد من منتج يشترك فيه العميل بالفعل تتطلب سعرًا مطابقًا. عندما تكون الإضافة منتجًا يملكه العميل بالفعل، يزيد Stay كميته بدلًا من إضافة بند - ولكن فقط إذا طابق سعر العرض ما يدفعه العميل حاليًا مقابله. إذا اختلفت الأسعار (على سبيل المثال، تقدّم الإضافة خصم 20% بينما خطته بخصم 10%)، تُرفض الترقية ويبقى الاشتراك دون تغيير. امنح الإضافة الخصم نفسه الموجود في خطة العميل، أو اعرض منتجًا مختلفًا (المنتج المختلف لا يتأثر).
- يجب أن تتطابق العملة مع تسعير متجرك. إذا كان اشتراك العميل يُفوتر بعملة لا يسعّر بها متجرك، تُرفض الترقية.
- لا يمكن التمييز بين الاشتراكات المكررة من طلب واحد. إذا بدأ طلب واحد اشتراكين في Stay يحتوي كلاهما على منتج العرض، فلن يتمكن Aftersell من معرفة أيهما قصده العميل، وتُرفض الترقية بدلًا من تطبيقها على العقد الخطأ.
- حدود المعدل تقيّد الإنتاجية. يسمح Stay بـ 60 طلبًا في الدقيقة لكل حساب. تستغرق الترقية الواحدة من أربعة إلى ستة طلبات، لذا يبلغ المتجر حده الأقصى عند نحو 10 إلى 15 ترقية في الدقيقة في أوقات الذروة.
إنشاء مفتاح API الخاص بـ Stay AI
- في لوحة تحكم Stay AI، انتقل إلى Account → API tokens → Add API key.
- عند إنشاء المفتاح، اختر All permissions. يحتاج Aftersell إلى صلاحية الوصول إلى Subscriptions وOrders وSelling Plan Groups وWebhooks. إذن Webhooks هو ما يتيح لـ Aftersell معرفة الإلغاءات.
- انسخ المفتاح واحفظه في مكان آمن. تعامل معه كأنه كلمة مرور.
ربط Stay AI في معالج الإعداد
- اختر Stay AI من القائمة المنسدلة Subscription provider.
- الصق مفتاح API الخاص بك في حقل API key.
- انقر على Test API key. يتحقق Aftersell من صحة المفتاح، ويتأكد من أنه يجتاز المصادقة وأنه ينتمي إلى متجرك.
- بمجرد نجاح الاختبار (علامة خضراء)، انقر على Continue للانتقال إلى الخطوة 2.
- علامة صح خضراء - “API key verified”. تمت مصادقة المفتاح وهو ينتمي إلى متجرك. أصبح زر Continue مفعّلًا الآن. إذا كان المفتاح يفتقد إذن Webhooks، فسينجح الاختبار مع ذلك لكنه يحذّر من أن إلغاءات الاشتراكات لن تُسجَّل - أعد إنشاء المفتاح في Stay AI مع All permissions إذا كنت تريد تتبّع الإلغاءات.
- أيقونة إلغاء حمراء. لم تكتمل عملية التحقق بنجاح. اقرأ الرسالة بجانب الأيقونة: إما أن المفتاح رُفض، أو لم يتمكن Aftersell من إكمال التحقق (“Could not verify the API key. Please try again.”)، وهو استدعاء فاشل وليس مفتاحًا سيئًا - في هذه الحالة أعد الاختبار فقط.
التحقق من الترقية في Stay AI
إذا تعذّر تطبيق الترقية
- تُعاد محاولة الترقيات الفاشلة تلقائيًا. إذا فشل استدعاء إلى Stay AI، يعيد Aftersell محاولته في سير عمل خلفي.
- إذا تعذّر تطبيقها رغم ذلك، يُسترد المبلغ للمتسوق. لا تحصّل ترقية الاشتراك سوى بند نائب صغير في طلب Shopify (وليس منتجًا يحتفظ به المتسوق)، لذا يسترد Aftersell ذلك المبلغ عندما يتعذّر إكمال الترقية.
- أي شيء لا يمكن تأكيده يُعلَّم للمراجعة اليدوية بدلًا من التخمين، حتى لا يُحاسَب المتسوق أبدًا على ترقية لم تحدث.
استكشاف مشكلات Stay AI وإصلاحها
- العميل على خطة مدفوعة مسبقًا (دفع مقدّم). لا يسمح Stay بتعديل العقود المدفوعة مسبقًا، لذا تُلغى الترقية ويُسترد المبلغ. هذا متوقع.
- الاشتراك يُفوتر بعملة لا يسعّر بها متجرك، لذا رُفضت الترقية.
- يحتوي الاشتراك على منتجين أو أكثر وغيّرت التكرار دون تفعيل Keep on existing subscription.
- بدأ طلب واحد اشتراكين في Stay يحتوي كلاهما على منتج العرض، لذا لم يتمكن Aftersell من معرفة أيهما يجب ترقيته.
- مفتاح API الخاص بك من متجر مختلف، أو تنقصه صلاحية مطلوبة (Subscriptions أو Orders أو Selling Plan Groups). أعد إنشاء المفتاح أو أعد اختياره في Stay AI، وانتقل إلى الخطوة 1: ربط المزوّد، وأعد اختباره.
- المنتج المؤهل في المسار لا يطابق ما اشترك فيه العميل فعليًا.
← العودة إلى نظرة عامة على ترقيات الاشتراك · الإعداد والتكوين · ما هي التكاملات؟