الاشتراكات

​

ما هي الاشتراكات؟

• ترخيص SaaS: التطبيقات، واجهات برمجة التطبيقات، أو الوصول إلى المنصات
• العضويات: المجتمعات، البرامج، أو الأندية
• المحتوى الرقمي: الدورات، الوسائط، أو المحتوى المتميز
• خطط الدعم: اتفاقيات مستوى الخدمة، حزم النجاح، أو الصيانة

​

الفوائد الرئيسية

• إيرادات متوقعة: فواتير متكررة مع تجديدات تلقائية
• دورات مرنة: شهرية، سنوية، فترات مخصصة، وتجارب
• مرونة الخطط: تقسيط للترقيات والتخفيضات
• إضافات ومقاعد: أضف ترقيات اختيارية وقابلة للقياس
• تجربة دفع سلسة: دفع مستضاف وبوابة العملاء
• موجه للمطورين: واجهات برمجة تطبيقات واضحة لإنشاء، تغييرات، وتتبع الاستخدام

​

إنشاء الاشتراكات

​

إنشاء منتج الاشتراك

​

تفاصيل المنتج

• اسم المنتج (مطلوب): الاسم المعروض في الدفع، بوابة العملاء، والفواتير.
• وصف المنتج (مطلوب): بيان قيمة واضح يظهر في الدفع والفواتير.
• صورة المنتج (مطلوب): PNG/JPG/WebP حتى 3 ميغابايت. تستخدم في الدفع والفواتير.
• العلامة التجارية: ربط المنتج بعلامة تجارية معينة للتصميم والبريد الإلكتروني.
• فئة الضريبة (مطلوب): اختر الفئة (على سبيل المثال، SaaS) لتحديد قواعد الضريبة.

​

التسعير

• نوع التسعير: اختر الاشتراك (هذا الدليل). البدائل هي الدفع لمرة واحدة والفوترة بناءً على الاستخدام.
• السعر (مطلوب): السعر الأساسي المتكرر مع العملة.
• نسبة الخصم المطبقة (%): نسبة الخصم الاختيارية المطبقة على السعر الأساسي؛ تظهر في صفحة الدفع والفواتير.
• تكرار الدفع كل (مطلوب): الفاصل الزمني للتجديدات، على سبيل المثال، كل شهر واحد. اختر التكرار (شهور أو سنوات) والكمية.
• مدة الاشتراك (مطلوب): المدة الإجمالية التي يظل فيها الاشتراك نشطًا (على سبيل المثال، 10 سنوات). بعد انتهاء هذه الفترة، تتوقف التجديدات ما لم يتم تمديدها.
• أيام فترة التجربة (مطلوب): حدد طول فترة التجربة بالأيام. استخدم 0 لتعطيل التجارب. يتم فرض الرسوم الأولى تلقائيًا عند انتهاء فترة التجربة.
• اختر الإضافة: أرفق ما يصل إلى 10 إضافات يمكن للعملاء شراؤها جنبًا إلى جنب مع الخطة الأساسية.

​

الإعدادات المتقدمة

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

​

تجارب الاشتراك

​

تكوين التجارب

// Via subscription creation
const subscription = await client.subscriptions.create({
  customer_id: 'cus_123',
  product_id: 'prod_monthly',
  trial_period_days: 14  // Overrides product's trial period
});

// Via checkout session
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'prod_monthly', quantity: 1 }],
  subscription_data: { trial_period_days: 14 }
});

​

اكتشاف حالة التجربة

const subscription = await client.subscriptions.retrieve('sub_123');
const payments = await client.payments.list({
  subscription_id: subscription.subscription_id
});

// Check if subscription is in trial
const isInTrial = payments.items.length === 1 && 
                  payments.items[0].total_amount === 0;

​

تحديث فترة التجربة

await client.subscriptions.update('sub_123', {
  next_billing_date: '2025-02-15T00:00:00Z'  // New trial end date
});

​

تغييرات خطة الاشتراك

​

أوضاع النسبة

​

prorated_immediately

await client.subscriptions.changePlan('sub_123', {
  product_id: 'prod_pro',
  quantity: 1,
  proration_billing_mode: 'prorated_immediately'
});

​

difference_immediately

// Upgrade: charges $50 (difference between $30 and $80)
// Downgrade: credits remaining value, auto-applied to renewals
await client.subscriptions.changePlan('sub_123', {
  product_id: 'prod_pro',
  quantity: 1,
  proration_billing_mode: 'difference_immediately'
});

​

full_immediately

await client.subscriptions.changePlan('sub_123', {
  product_id: 'prod_monthly',
  quantity: 1,
  proration_billing_mode: 'full_immediately'
});

Unused credit from Basic = $30 × (15 remaining / 30 total) = $15.00
Prorated cost of Pro     = $80 × (15 remaining / 30 total) = $40.00
────────────────────────────────────────────────────────────────────
Immediate charge         = $40.00 − $15.00 = $25.00

Credit = Old plan − New plan = $80 − $20 = $60.00

​

تغيير الخطط مع الإضافات

await client.subscriptions.changePlan('sub_123', {
  product_id: 'prod_pro',
  quantity: 1,
  proration_billing_mode: 'difference_immediately',
  addons: [{ addon_id: 'addon_extra_seats', quantity: 2 }]  // Add add-ons
  // addons: []  // Empty array removes all existing add-ons
});

​

معاينة تغييرات الخطة

const preview = await client.subscriptions.previewChangePlan('sub_123', {
  product_id: 'prod_pro',
  quantity: 1,
  proration_billing_mode: 'prorated_immediately'
});

// Show customer the charge before confirming
console.log('You will be charged:', preview.immediate_charge.summary);

​

حالات الاشتراك

• active: الاشتراك نشط وسيتم تجديده تلقائيًا
• on_hold: الاشتراك متوقف مؤقتًا بسبب فشل الدفع. يلزم تحديث وسيلة الدفع لإعادة التفعيل
• cancelled: الاشتراك ملغى ولن يجدد
• expired: بلغ الاشتراك تاريخ انتهائه
• pending: يجري إنشاء الاشتراك أو معالجته

​

حالة التوقف المؤقت

• يفشل دفع التجديد (أموال غير كافية، بطاقة منتهية الصلاحية، إلخ)
• تفشل رسوم تغيير الخطة
• تفشل صلاحية وسيلة الدفع

​

إعادة التنشيط من حالة التوقف المؤقت

1. إنشاء رسوم للمستحقات المتبقية
2. إنشاء فاتورة
3. معالجة الدفع باستخدام وسيلة الدفع الجديدة
4. إعادة تنشيط الاشتراك إلى حالة active عند نجاح الدفع

// Reactivate subscription from on_hold
const response = await client.subscriptions.updatePaymentMethod('sub_123', {
  type: 'new',
  return_url: 'https://example.com/return'
});

// For on_hold subscriptions, a charge is automatically created
if (response.payment_id) {
  console.log('Charge created:', response.payment_id);
  // Redirect customer to response.payment_link to complete payment
  // Monitor webhooks for payment.succeeded and subscription.active
}

​

إدارة واجهة برمجة التطبيقات

​

حالات الاستخدام الشائعة

• SaaS and APIs: وصول متدرج مع إضافات للمقاعد أو الاستخدام
• Content and media: وصول شهري مع تجارب تقديمية
• B2B support plans: عقود سنوية مع إضافات دعم متميزة
• Tools and plugins: مفاتيح ترخيص وإصدارات ذات نسخ

​

أمثلة على التكامل

​

جلسات الدفع (الاشتراكات)

const session = await client.checkoutSessions.create({
  product_cart: [
    {
      product_id: 'prod_subscription',
      quantity: 1
    }
  ]
});

​

تغييرات الخطط مع النسبة

await client.subscriptions.changePlan('sub_123', {
  product_id: 'prod_new',
  quantity: 1,
  proration_billing_mode: 'difference_immediately'
});

​

الإلغاء في تاريخ الفوترة التالي

await client.subscriptions.update('sub_123', {
  cancel_at_next_billing_date: true
});

​

الاشتراكات حسب الطلب

const onDemand = await client.subscriptions.create({
  customer_id: 'cus_123',
  product_id: 'prod_on_demand',
  on_demand: true
});

await client.subscriptions.createCharge(onDemand.id, {
  amount: 4900,
  currency: 'USD',
  description: 'Extra usage for September'
});

​

تحديث وسيلة الدفع للاشتراك النشط

// Update with new payment method
const response = await client.subscriptions.updatePaymentMethod('sub_123', {
  type: 'new',
  return_url: 'https://example.com/return'
});

// Or use existing payment method
await client.subscriptions.updatePaymentMethod('sub_123', {
  type: 'existing',
  payment_method_id: 'pm_abc123'
});

​

إعادة تنشيط الاشتراك من حالة on_hold

// Update payment method - automatically creates charge for remaining dues
const response = await client.subscriptions.updatePaymentMethod('sub_123', {
  type: 'new',
  return_url: 'https://example.com/return'
});

if (response.payment_id) {
  // Charge created for remaining dues
  // Redirect customer to response.payment_link
  // Monitor webhooks: payment.succeeded → subscription.active
}

​

الاشتراكات المتوافقة مع تفويضات RBI

​

حدود التفويض

• الرسوم أقل من 15,000 روبية: ننشئ تفويضًا حسب الطلب بمبلغ 15,000 روبية هندية. يتم تحصيل مبلغ الاشتراك دوريًا وفقًا لتكرار الاشتراك، حتى حد التفويض.
• الرسوم 15,000 روبية أو أكثر: ننشئ تفويض اشتراك (أو تفويض حسب الطلب) بالمبلغ الدقيق للاشتراك.

​

اعتبارات الترقية والتخفيض

• إذا أدت ترقية أو تخفيض إلى مبلغ رسوم يتجاوز 15,000 روبية وتجاوز حد الدفع حسب الطلب الحالي، فقد تفشل المعاملة.
• في مثل هذه الحالات، قد يحتاج العميل إلى تحديث وسيلة الدفع أو تغيير الاشتراك مرة أخرى لإنشاء تفويض جديد بالحد الصحيح.

​

التفويض للرسوم العالية

• سيُطلب من العميل من قبل البنك تفويض المعاملة.
• إذا فشل العميل في تفويض المعاملة، ستفشل المعاملة وسيُعلق الاشتراك.

​

تأخير المعالجة لمدة 48 ساعة

• يتم بدء الرسوم في التاريخ المجدول وفقًا لتكرار الاشتراك.
• يتم خصم المبلغ من حساب العميل فقط بعد 48 ساعة من بدء الدفع.
• قد تمتد نافذة الـ48 ساعة هذه حتى ساعتين إلى ثلاث إضافيتين حسب استجابة واجهات برمجة تطبيقات البنك.

​

نافذة إلغاء التفويض

• يمكن للعملاء إلغاء التفويض عبر تطبيقات البنك الخاصة بهم.
• إذا ألغى العميل التفويض خلال هذه الفترة، سيبقى الاشتراك نشطًا (هذه حالة غير معتادة خاصة باشتراكات البطاقات الهندية وUPI AutoPay).
• مع ذلك، قد يفشل الخصم الفعلي، وفي هذه الحالة سنضع الاشتراك في حالة التوقف المؤقت.

• تأخير تفعيل المزايا حتى تأكيد الدفع
• تنفيذ فترات سماح أو وصول مؤقت
• مراقبة حالة الاشتراك لإلغاء التفويضات
• التعامل مع حالات التوقف المؤقت في منطق التطبيق الخاص بك

​

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

• ابدأ بطبقات واضحة: خطتان أو ثلاث بخلافات واضحة
• واصل التواصل حول التسعير: أظهر الإجماليات والنسبة والتجديد التالي
• استخدم التجارب بعناية: حوّلها من خلال التهيئة، لا بالاعتماد على الوقت فقط
• استفد من الإضافات: احتفظ بالخطط الأساسية بسيطة وقدم الإضافات للترقية
• اختبر التغييرات: تحقق من تغييرات الخطة والنسبة في وضع الاختبار