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

المقدمة

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

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

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

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

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

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

🚀 البدء السريع​

قم بتهيئة الوحدة من defineOneEntry:


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

اشترك المستخدم الحالي في خطة وقم بإعادة توجيههم إلى جلسة الدفع (يتطلب التفويض):

// Create a subscription for the "premium" plan.
const session = await Subscriptions.subscribe({ marker: "premium" });

// Send the user to the payment page to complete the first payment.
window.location.href = session.paymentUrl;

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

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

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

جلسة الدفع​

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

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

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

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

🔐 = يتطلب التفويض

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

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

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

ماذا تعيد subscribe()؟​

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

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

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

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

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

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