كيف تبني اشتراك ما يتعطل عند أول تغيير؟
تابع اشتراك نورة من اختيار الباقة إلى التفعيل والترقية والتجديد وتعثّر الدفع، واعرف مسؤولية كل نظام في الرحلة.
آخر تحديث 2026-08-14
اختارت نورة باقة النمو بـ299 ر.س بالشهر. بعد 12 يوم، احتاج فريقها باقة التوسع. وعند التجديد، تعثرت البطاقة.
لو كل اللي عندك حقل اسمه is_paid، تبدأ المشاكل من أول تغيير. الاشتراك يحدد مدة الباقة، وما تشمل، وسعرها، وفاتورتها، وحالة الدفع. هنا نبنيه بدون ما تعيد بناء الفوترة داخل منتجك.
الاشتراك مو خانة تقول «دفع». له حالة تتغيّر مع الوقت.
كل حالة تجاوب عن سؤالين: وش يقدر العميل يستخدم الآن؟ وش المفروض يصير بعدها؟
تجربة
يجرّب المنتج
تنتهي أو تتحول
نشط
يستخدم الباقة
يتجدد أو يتغيّر
الدفع متعثر
مهلة للتحصيل
تُعاد المحاولة
ملغي
تتوقف الباقة
ويبقى السجل
احسم القرارات قبل ما تكتب الكود
اكتب قواعد الاشتراك من البداية. هي اللي توحّد قرار المنتج والفريق التجاري والهندسة.
| القرار | وضع نورة | ليش يهم؟ |
|---|---|---|
| متى تبدأ الباقة؟ | بعد نجاح أول دفعة | ما يستخدمها العميل قبل الدفع |
| متى تسري الترقية؟ | مباشرة | يعرف تطبيقك متى يشغّل مزايا التوسع |
| كيف يُحسب فرق السعر؟ | احتساب تناسبي للـ18 يوم المتبقية | يحدد مبلغ الفاتورة |
| متى يسري خفض الباقة؟ | عند نهاية الدورة | ما تختفي مزايا دفع العميل قيمتها قبل نهاية الشهر |
| كم مهلة تعثّر الدفع؟ | 7 أيام | تحدد هل يستمر الحساب أثناء التحصيل، وإلى متى |
| متى ينتهي الإلغاء؟ | عند نهاية الدورة الحالية | يستفيد العميل من كامل المدة المدفوعة |
الـAPI ما يقرر إذا كان خفض الباقة يبدأ مباشرة أو مع التجديد القادم. إذا ما حسمها الفريق، بيكون لكل جزء من النظام جواب مختلف.
كل معلومة لها مكان واحد
تطبيقك وترداد ومزود الدفع يشاركون في الرحلة نفسها. لكن مسؤولية كل واحد منهم مختلفة.
رحلة واحدة بين ثلاثة أنظمة. وكل معلومة لها مكان واحد.
تجربة العميل
الاشتراك والفوترة
تحصيل المبلغ
إذا اشتركت نورة، لازم يعرف ترداد أي حساب يخصها عندك، ويعرف تطبيقك أي اشتراك يخصها في ترداد. هذا الربط هو اللي يخلي تغيير الباقة أو التجديد ينعكس على الحساب الصحيح.
| في تطبيقك | في ترداد | وش يربطهم؟ |
|---|---|---|
| حساب نورة | ملف العميل | نفس العميل حتى لو تغيّر بريده |
| مساحة عملها | اشتراكها | الباقة الحالية وموعد التجديد |
| الباقة اللي اختارتها | السعر المتفق عليه | السعر اللي تظهر عليه فواتيرها |
لا تعتمد على البريد الإلكتروني وحده. نورة تقدر تغيّره، لكن حسابها واشتراكها يظلون هم نفسهم.
ابنِ الباقة قبل الاشتراك
رتّب النموذج التجاري بهذا الشكل:
- عرّف المزايا بأسماء يفهمها العميل.
- حدّد استحقاقات باقة النمو والحدود المشمولة.
- اربط السعر الشهري أو السنوي.
- انشر إصدار جديد تستخدمه الاشتراكات الجديدة.
إذا تغيّر سعر باقة النمو، لا تعدّل السعر القديم. انشر إصدار جديد. كذا تظل فواتير نورة القديمة مفهومة، ويبدأ العملاء الجدد بالشروط الجديدة.
فعّل الباقة بعد تأكيد الاشتراك
تضغط نورة «اختيار باقة النمو». الواجهة ترسل الطلب، لكنها ما تقرر إن الاشتراك بدأ.
نورة اختارت باقة النمو. متى تفتح لها المزايا؟
العملية تمشي كذا:
- الـbackend عندك ينشئ العميل في ترداد أو يربطه بحساب موجود.
- ينشئ الاشتراك بمفتاح يمنع تكرار الطلب.
- يرسل مزود الدفع نتيجة العملية إلى ترداد.
- يحدّث ترداد حالة الاشتراك.
- يستقبل تطبيقك النتيجة أو الـwebhook، وبعدها يفحص الاستحقاقات.
ليش ما تعتمد على صفحة النجاح؟ ممكن تقفل نورة الصفحة قبل ما تفتح. وممكن أحد يستدعيها مباشرة. وممكن يتأخر تأكيد الدفع عن رجوع المتصفح. ولا وحدة من هذه الحالات تعني أن الدفع نجح.
خل معالجة الـwebhook تشتغل حتى مع التكرار
الـwebhook ممكن يوصل مرتين أو بترتيب مختلف. هذا طبيعي، مو حالة نادرة.
مع كل حدث:
- تحقق من التوقيع؛
- احفظ معرّف الحدث قبل ما تطبّق التغيير؛
- تجاهل الحدث إذا عالجته؛
- لا تستبدل حالة جديدة بحدث أقدم؛
- إذا ما كانت الحالة واضحة، اجلب الاشتراك الحالي من ترداد.
الحدث ينبهك بوجود تغيير. سجل الاشتراك في ترداد يعطيك الحالة الحالية.
غيّر الباقة، مو هوية الاشتراك
في اليوم 12، رقّت نورة من النمو إلى التوسع. ما تحتاج تنشئ عميل جديد أو اشتراك ثاني. غيّر الباقة على الاشتراك نفسه.
انتقلت نورة من النمو إلى التوسع في اليوم 12. وش يتغيّر؟
باقة النمو
من اليوم 1 إلى 12
أيام استخدمتها نورة
باقة التوسع
من اليوم 12 إلى 30
مزايا أكثر
بعد تأكيد التغيير، يفحص تطبيقك الاستحقاقات من جديد. تشتغل مزايا التوسع مباشرة، بدون ما يحسب تطبيقك قيمة الأيام المتبقية أو فرق السعر أو الضريبة أو رصيد الفاتورة.
أما خفض الباقة، فتقدر تجدوله للتجديد القادم. تكمل نورة مدتها الحالية، وتشوف التغيير القادم وتقدر تتراجع عنه.
تعثّر الدفع مو إلغاء
عند التجديد، تعثرت دفعة نورة. صار عندك ثلاث معلومات مهمة في الوقت نفسه:
- فاتورة التجديد ما اندفعت؛
- الاشتراك دخل مرحلة متابعة التحصيل؛
- قد تترك الحساب يعمل سبعة أيام إضافية حسب سياستك.
لا تختصرها كلها في active = false. تعثّر الدفعة ما يعني أن الاشتراك انتهى.
| حالة الاشتراك | وش يصير في المنتج؟ | وش يحتاج يعرف العميل؟ |
|---|---|---|
| نشط | يعمل الحساب كالمعتاد | موعد التجديد القادم |
| الدفع متعثر | يستمر الحساب حسب سياستك | تحديث وسيلة الدفع قبل نهاية المهلة |
| تم التحصيل | يرجع كل شيء طبيعي | تأكيد استلام الدفعة |
| ملغي | تتوقف مزايا الباقة في الموعد المتفق عليه | تاريخ توقف الخدمة |
ترداد يدير حالة الاشتراك والفاتورة. تطبيقك يقرر وش يصير داخل المنتج، ويوضح للعميل خطوته التالية.
اختبر الوقت والتكرار والفشل
المسار السهل ما يكفي. قبل الإطلاق، اختبر هذه الحالات:
- انتهت مهلة طلب الإنشاء، ثم أُعيد الطلب بالمفتاح نفسه؛
- وصل حدث التفعيل مرتين؛
- وصل حدث قديم بعد حدث أحدث؛
- صارت الترقية عند لحظة انتهاء دورة الفوترة؛
- فشل دفع فرق الترقية؛
- تعثّر التجديد ثم نجحت المحاولة التالية؛
- جُدول الإلغاء ثم تراجع العميل عنه؛
- احتفظت الفواتير القديمة بإصدار السعر الصحيح.
تعرف إن التنفيذ جاهز لما تقدر تجاوب عن سؤال واحد عند كل تغيير: وين تُحفظ الحالة الصحيحة، وكيف تعرفها بقية الأنظمة؟
ابنِ دورة اشتراك واحدة. لا توزعها بين حقل للدفع واسم باقة وتاريخ إلغاء ممكن تختلف عن بعض.
الخطوة التالية: الاشتراك يحدد وش اشترت نورة. الآن اربط استخدامها بالحد المشمول والفاتورة.