انتقل إلى المحتوى الرئيسي

المقدمة

بيع الوصول إلى منتجك كاشتراك مدفوع متكرر.

🔐 تتطلب طرق هذه الوحدة تفويض.

مزيد من المعلومات حول واجهة مستخدم الوحدة https://doc.oneentry.cloud/docs/category/subscriptions

🎯 ماذا تفعل هذه الوحدة؟​

تتيح لك وحدة الاشتراكات إدارة الاشتراكات المدفوعة للمستخدم الحالي - إنشاء اشتراك واستلام جلسة دفع، إلغاؤه، استعادته من خلال بوابة فواتير Stripe، وإدراج علامات الاشتراك المتاحة أو النشطة.

فكر في الأمر كفواتير متكررة لتطبيقك - بدلاً من الطلبات الفردية، يقوم المستخدم بالاشتراك في خطة (علامة مثل premium) ويتم تحصيل الرسوم تلقائيًا من قبل مزود الدفع.

📖 شرح بسيط​

عادةً ما يبدو تدفق الاشتراك كما يلي:

  • 🧾 خطط - تقوم بتعريف خطط الاشتراك (العلامات) في لوحة تحكم OneEntry
  • 💳 الاشتراك - يختار المستخدم خطة ويتم توجيهه إلى جلسة دفع
  • 🔁 الفوترة المتكررة - يقوم مزود الدفع بخصم المبلغ من المستخدم تلقائيًا
  • ❌ إلغاء - يقوم المستخدم بالإلغاء ويحتفظ بالوصول حتى انتهاء الفترة
  • ♻️ استعادة - يقوم المستخدم باستعادة اشتراك ملغى عبر بوابة الفواتير

✨ المفاهيم الأساسية​

ما هي علامة الاشتراك؟​

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

جلسة الدفع​

تُرجع subscribe() جلسة دفع - كائن يحتوي على paymentUrl يجب على المستخدم فتحه لإكمال أول دفعة. قم بتوجيه المستخدم إلى هناك لإنهاء عملية الدفع.

📋 ما تحتاج إلى معرفته​

  • تتطلب جميع الطرق مستخدمًا مفوضًا - استدعها بعد تسجيل دخول المستخدم عبر وحدة AuthProvider.
  • تُرجع getAllSubscriptions() جميع العلامات المتاحة، بينما تُرجع getActiveSubscriptions() فقط العلامات التي اشترك فيها المستخدم الحالي.
  • تُرجع cancelSubscription() و recoverSubscriptions() القيمة true عند النجاح.

📊 جدول مرجعي سريع​

الطريقةالوصف
subscribe()إنشاء اشتراك والحصول على جلسة دفع
getAllSubscriptions()الحصول على جميع علامات الاشتراك المتاحة
getActiveSubscriptions()الحصول على علامات الاشتراكات النشطة للمستخدم
cancelSubscription()إلغاء اشتراك
recoverSubscriptions()استعادة اشتراك عبر بوابة الفواتير

❓ الأسئلة الشائعة (FAQ)​

كيف يمكنني إنشاء خطة اشتراك؟​

تُكون خطط الاشتراك في لوحة تحكم OneEntry وتُربط بحساب دفع (مثل Stripe). يشير SDK إلى كل خطة بواسطة علامتها.

ماذا تُرجع subscribe()؟​

تُرجع جلسة دفع تحتوي على paymentUrl. قم بتوجيه المستخدم إلى ذلك الرابط لإكمال أول دفعة وتفعيل الاشتراك.

ما الفرق بين الإلغاء والاستعادة؟​

توقف cancelSubscription() الفوترة المتكررة لخطة. بينما تستعيد recoverSubscriptions() اشتراكًا تم إلغاؤه سابقًا عبر بوابة فواتير Stripe.

🎓 أفضل الممارسات​

  • دائمًا قم بالإشارة إلى الخطط بواسطة العلامة، وليس بواسطة اسم العرض.
  • تحقق من هوية المستخدم قبل استدعاء أي طريقة اشتراك.
  • بعد subscribe()، قم بتوجيه المستخدم إلى paymentUrl وتعامل مع رابط العودة في تطبيقك.
  • استخدم getActiveSubscriptions() لتقييد الميزات المميزة في واجهة المستخدم الخاصة بك.

تعريف وحدة الاشتراكات​


const { Subscriptions } = defineOneEntry(
  "your-project-url", {
    "token": "your-app-token"
  }
);

🔗 الوثائق ذات الصلة​